1 <?xml version="1.0" encoding="utf-8"?>
4 <name>System.Net.HttpListener</name>
7 <member name="T:System.Net.AuthenticationSchemeSelector">
8 <summary>Selects the authentication scheme for an <see cref="T:System.Net.HttpListener" /> instance.</summary>
9 <param name="httpRequest">The <see cref="T:System.Net.HttpListenerRequest" /> instance for which to select an authentication scheme.</param>
10 <returns>One of the <see cref="T:System.Net.AuthenticationSchemes" /> values that indicates the method of authentication to use for the specified client request.</returns>
12 <member name="T:System.Net.HttpListener">
13 <summary>Provides a simple, programmatically controlled HTTP protocol listener. This class cannot be inherited.</summary>
15 <member name="M:System.Net.HttpListener.#ctor">
16 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListener" /> class.</summary>
17 <exception cref="T:System.PlatformNotSupportedException">This class cannot be used on the current operating system. Windows Server 2003 or Windows XP SP2 is required to use instances of this class.</exception>
19 <member name="M:System.Net.HttpListener.Abort">
20 <summary>Shuts down the <see cref="T:System.Net.HttpListener" /> object immediately, discarding all currently queued requests.</summary>
22 <member name="P:System.Net.HttpListener.AuthenticationSchemes">
23 <summary>Gets or sets the scheme used to authenticate clients.</summary>
24 <returns>A bitwise combination of <see cref="T:System.Net.AuthenticationSchemes" /> enumeration values that indicates how clients are to be authenticated. The default value is <see cref="F:System.Net.AuthenticationSchemes.Anonymous" />.</returns>
25 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
27 <member name="P:System.Net.HttpListener.AuthenticationSchemeSelectorDelegate">
28 <summary>Gets or sets the delegate called to determine the protocol used to authenticate clients.</summary>
29 <returns>An <see cref="T:System.Net.AuthenticationSchemeSelector" /> delegate that invokes the method used to select an authentication protocol. The default value is <see langword="null" />.</returns>
30 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
32 <member name="M:System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)">
33 <summary>Begins asynchronously retrieving an incoming request.</summary>
34 <param name="callback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when a client request is available.</param>
35 <param name="state">A user-defined object that contains information about the operation. This object is passed to the <paramref name="callback" /> delegate when the operation completes.</param>
36 <returns>An <see cref="T:System.IAsyncResult" /> object that indicates the status of the asynchronous operation.</returns>
37 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception.</exception>
38 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped.</exception>
39 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
41 <member name="M:System.Net.HttpListener.Close">
42 <summary>Shuts down the <see cref="T:System.Net.HttpListener" />.</summary>
44 <member name="P:System.Net.HttpListener.DefaultServiceNames">
45 <summary>Gets a default list of Service Provider Names (SPNs) as determined by registered prefixes.</summary>
46 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection" /> that contains a list of SPNs.</returns>
48 <member name="M:System.Net.HttpListener.EndGetContext(System.IAsyncResult)">
49 <summary>Completes an asynchronous operation to retrieve an incoming client request.</summary>
50 <param name="asyncResult">An <see cref="T:System.IAsyncResult" /> object that was obtained when the asynchronous operation was started.</param>
51 <returns>An <see cref="T:System.Net.HttpListenerContext" /> object that represents the client request.</returns>
52 <exception cref="T:System.ArgumentException">
53 <paramref name="asyncResult" /> was not obtained by calling the <see cref="M:System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)" /> method.</exception>
54 <exception cref="T:System.ArgumentNullException">
55 <paramref name="asyncResult" /> is <see langword="null" />.</exception>
56 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception.</exception>
57 <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Net.HttpListener.EndGetContext(System.IAsyncResult)" /> method was already called for the specified <paramref name="asyncResult" /> object.</exception>
58 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
60 <member name="P:System.Net.HttpListener.ExtendedProtectionPolicy">
61 <summary>Gets or sets the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> to use for extended protection for a session.</summary>
62 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> that specifies the policy to use for extended protection.</returns>
63 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy" /> property, but the <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding" /> property was not <see langword="null" />.</exception>
64 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy" /> property to <see langword="null" />.</exception>
65 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy" /> property after the <see cref="M:System.Net.HttpListener.Start" /> method was already called.</exception>
66 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
67 <exception cref="T:System.PlatformNotSupportedException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.PolicyEnforcement" /> property was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always" /> on a platform that does not support extended protection.</exception>
69 <member name="T:System.Net.HttpListener.ExtendedProtectionSelector">
70 <summary>A delegate called to determine the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> to use for each <see cref="T:System.Net.HttpListener" /> request.</summary>
71 <param name="request">The <see cref="T:System.Net.HttpListenerRequest" /> to determine the extended protection policy that the <see cref="T:System.Net.HttpListener" /> instance will use to provide extended protection.</param>
72 <returns>An <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> object that specifies the extended protection policy to use for this request.</returns>
74 <member name="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate">
75 <summary>Gets or sets the delegate called to determine the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> to use for each request.</summary>
76 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy" /> that specifies the policy to use for extended protection.</returns>
77 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate" /> property, but the <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding" /> property must be <see langword="null" />.</exception>
78 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate" /> property to <see langword="null" />.</exception>
79 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate" /> property after the <see cref="M:System.Net.HttpListener.Start" /> method was already called.</exception>
80 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
81 <exception cref="T:System.PlatformNotSupportedException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate" /> property on a platform that does not support extended protection.</exception>
83 <member name="M:System.Net.HttpListener.GetContext">
84 <summary>Waits for an incoming request and returns when one is received.</summary>
85 <returns>An <see cref="T:System.Net.HttpListenerContext" /> object that represents a client request.</returns>
86 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception.</exception>
87 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped.
89 The <see cref="T:System.Net.HttpListener" /> does not have any Uniform Resource Identifier (URI) prefixes to respond to.</exception>
90 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
92 <member name="M:System.Net.HttpListener.GetContextAsync">
93 <summary>Waits for an incoming request as an asynchronous operation.</summary>
94 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.HttpListenerContext" /> object that represents a client request.</returns>
96 <member name="P:System.Net.HttpListener.IgnoreWriteExceptions">
97 <summary>Gets or sets a <see cref="T:System.Boolean" /> value that specifies whether your application receives exceptions that occur when an <see cref="T:System.Net.HttpListener" /> sends the response to the client.</summary>
99 <see langword="true" /> if this <see cref="T:System.Net.HttpListener" /> should not return exceptions that occur when sending the response to the client; otherwise, <see langword="false" />. The default value is <see langword="false" />.</returns>
100 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
102 <member name="P:System.Net.HttpListener.IsListening">
103 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener" /> has been started.</summary>
105 <see langword="true" /> if the <see cref="T:System.Net.HttpListener" /> was started; otherwise, <see langword="false" />.</returns>
107 <member name="P:System.Net.HttpListener.IsSupported">
108 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener" /> can be used with the current operating system.</summary>
110 <see langword="true" /> if <see cref="T:System.Net.HttpListener" /> is supported; otherwise, <see langword="false" />.</returns>
112 <member name="P:System.Net.HttpListener.Prefixes">
113 <summary>Gets the Uniform Resource Identifier (URI) prefixes handled by this <see cref="T:System.Net.HttpListener" /> object.</summary>
114 <returns>An <see cref="T:System.Net.HttpListenerPrefixCollection" /> that contains the URI prefixes that this <see cref="T:System.Net.HttpListener" /> object is configured to handle.</returns>
115 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
117 <member name="P:System.Net.HttpListener.Realm">
118 <summary>Gets or sets the realm, or resource partition, associated with this <see cref="T:System.Net.HttpListener" /> object.</summary>
119 <returns>A <see cref="T:System.String" /> value that contains the name of the realm associated with the <see cref="T:System.Net.HttpListener" /> object.</returns>
120 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
122 <member name="M:System.Net.HttpListener.Start">
123 <summary>Allows this instance to receive incoming requests.</summary>
124 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception.</exception>
125 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
127 <member name="M:System.Net.HttpListener.Stop">
128 <summary>Causes this instance to stop receiving incoming requests.</summary>
129 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
131 <member name="M:System.Net.HttpListener.System#IDisposable#Dispose">
132 <summary>Releases the resources held by this <see cref="T:System.Net.HttpListener" /> object.</summary>
134 <member name="P:System.Net.HttpListener.TimeoutManager">
135 <summary>The timeout manager for this <see cref="T:System.Net.HttpListener" /> instance.</summary>
136 <returns>The timeout manager for this <see cref="T:System.Net.HttpListener" /> instance.</returns>
138 <member name="P:System.Net.HttpListener.UnsafeConnectionNtlmAuthentication">
139 <summary>Gets or sets a <see cref="T:System.Boolean" /> value that controls whether, when NTLM is used, additional requests using the same Transmission Control Protocol (TCP) connection are required to authenticate.</summary>
141 <see langword="true" /> if the <see cref="T:System.Security.Principal.IIdentity" /> of the first request will be used for subsequent requests on the same connection; otherwise, <see langword="false" />. The default value is <see langword="false" />.</returns>
142 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
144 <member name="T:System.Net.HttpListenerBasicIdentity">
145 <summary>Holds the user name and password from a basic authentication request.</summary>
147 <member name="M:System.Net.HttpListenerBasicIdentity.#ctor(System.String,System.String)">
148 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerBasicIdentity" /> class using the specified user name and password.</summary>
149 <param name="username">The user name.</param>
150 <param name="password">The password.</param>
152 <member name="P:System.Net.HttpListenerBasicIdentity.Password">
153 <summary>Indicates the password from a basic authentication attempt.</summary>
154 <returns>A <see cref="T:System.String" /> that holds the password.</returns>
156 <member name="T:System.Net.HttpListenerContext">
157 <summary>Provides access to the request and response objects used by the <see cref="T:System.Net.HttpListener" /> class. This class cannot be inherited.</summary>
159 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String)">
160 <summary>Accept a WebSocket connection as an asynchronous operation.</summary>
161 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
162 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext" /> object.</returns>
163 <exception cref="T:System.ArgumentException">
164 <paramref name="subProtocol" /> is an empty string
166 <paramref name="subProtocol" /> contains illegal characters.</exception>
167 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
169 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.Int32,System.TimeSpan)">
170 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, and WebSocket keep-alive interval as an asynchronous operation.</summary>
171 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
172 <param name="receiveBufferSize">The receive buffer size in bytes.</param>
173 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
174 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext" /> object.</returns>
175 <exception cref="T:System.ArgumentException">
176 <paramref name="subProtocol" /> is an empty string
178 <paramref name="subProtocol" /> contains illegal characters.</exception>
179 <exception cref="T:System.ArgumentOutOfRangeException">
180 <paramref name="keepAliveInterval" /> is too small.
182 <paramref name="receiveBufferSize" /> is less than 16 bytes
184 <paramref name="receiveBufferSize" /> is greater than 64K bytes.</exception>
185 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
187 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.Int32,System.TimeSpan,System.ArraySegment{System.Byte})">
188 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, WebSocket keep-alive interval, and the internal buffer as an asynchronous operation.</summary>
189 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
190 <param name="receiveBufferSize">The receive buffer size in bytes.</param>
191 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
192 <param name="internalBuffer">An internal buffer to use for this operation.</param>
193 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext" /> object.</returns>
194 <exception cref="T:System.ArgumentException">
195 <paramref name="subProtocol" /> is an empty string
197 <paramref name="subProtocol" /> contains illegal characters.</exception>
198 <exception cref="T:System.ArgumentOutOfRangeException">
199 <paramref name="keepAliveInterval" /> is too small.
201 <paramref name="receiveBufferSize" /> is less than 16 bytes
203 <paramref name="receiveBufferSize" /> is greater than 64K bytes.</exception>
204 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
206 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.TimeSpan)">
207 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol and WebSocket keep-alive interval as an asynchronous operation.</summary>
208 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
209 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
210 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext" /> object.</returns>
211 <exception cref="T:System.ArgumentException">
212 <paramref name="subProtocol" /> is an empty string
214 <paramref name="subProtocol" /> contains illegal characters.</exception>
215 <exception cref="T:System.ArgumentOutOfRangeException">
216 <paramref name="keepAliveInterval" /> is too small.</exception>
217 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
219 <member name="P:System.Net.HttpListenerContext.Request">
220 <summary>Gets the <see cref="T:System.Net.HttpListenerRequest" /> that represents a client's request for a resource.</summary>
221 <returns>An <see cref="T:System.Net.HttpListenerRequest" /> object that represents the client request.</returns>
223 <member name="P:System.Net.HttpListenerContext.Response">
224 <summary>Gets the <see cref="T:System.Net.HttpListenerResponse" /> object that will be sent to the client in response to the client's request.</summary>
225 <returns>An <see cref="T:System.Net.HttpListenerResponse" /> object used to send a response back to the client.</returns>
227 <member name="P:System.Net.HttpListenerContext.User">
228 <summary>Gets an object used to obtain identity, authentication information, and security roles for the client whose request is represented by this <see cref="T:System.Net.HttpListenerContext" /> object.</summary>
229 <returns>An <see cref="T:System.Security.Principal.IPrincipal" /> object that describes the client, or <see langword="null" /> if the <see cref="T:System.Net.HttpListener" /> that supplied this <see cref="T:System.Net.HttpListenerContext" /> does not require authentication.</returns>
231 <member name="T:System.Net.HttpListenerException">
232 <summary>The exception that is thrown when an error occurs processing an HTTP request.</summary>
234 <member name="M:System.Net.HttpListenerException.#ctor">
235 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException" /> class.</summary>
237 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32)">
238 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException" /> class using the specified error code.</summary>
239 <param name="errorCode">A <see cref="T:System.Int32" /> value that identifies the error that occurred.</param>
241 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32,System.String)">
242 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException" /> class using the specified error code and message.</summary>
243 <param name="errorCode">A <see cref="T:System.Int32" /> value that identifies the error that occurred.</param>
244 <param name="message">A <see cref="T:System.String" /> that describes the error that occurred.</param>
246 <member name="M:System.Net.HttpListenerException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
247 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException" /> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> and <see cref="T:System.Runtime.Serialization.StreamingContext" /> classes.</summary>
248 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo" /> object that contains the information required to deserialize the new <see cref="T:System.Net.HttpListenerException" /> object.</param>
249 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext" /> object.</param>
251 <member name="P:System.Net.HttpListenerException.ErrorCode">
252 <summary>Gets a value that identifies the error that occurred.</summary>
253 <returns>A <see cref="T:System.Int32" /> value.</returns>
255 <member name="T:System.Net.HttpListenerPrefixCollection">
256 <summary>Represents the collection used to store Uniform Resource Identifier (URI) prefixes for <see cref="T:System.Net.HttpListener" /> objects.</summary>
258 <member name="M:System.Net.HttpListenerPrefixCollection.Add(System.String)">
259 <summary>Adds a Uniform Resource Identifier (URI) prefix to the collection.</summary>
260 <param name="uriPrefix">A <see cref="T:System.String" /> that identifies the URI information that is compared in incoming requests. The prefix must be terminated with a forward slash ("/").</param>
261 <exception cref="T:System.ArgumentNullException">
262 <paramref name="uriPrefix" /> is <see langword="null" />.</exception>
263 <exception cref="T:System.ArgumentException">
264 <paramref name="uriPrefix" /> does not use the http:// or https:// scheme. These are the only schemes supported for <see cref="T:System.Net.HttpListener" /> objects.
266 <paramref name="uriPrefix" /> is not a correctly formatted URI prefix. Make sure the string is terminated with a "/".</exception>
267 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener" /> associated with this collection is closed.</exception>
268 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception. This exception is thrown if another <see cref="T:System.Net.HttpListener" /> has already added the prefix <paramref name="uriPrefix" />.</exception>
270 <member name="M:System.Net.HttpListenerPrefixCollection.Clear">
271 <summary>Removes all the Uniform Resource Identifier (URI) prefixes from the collection.</summary>
272 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode" /> property to determine the cause of the exception.</exception>
273 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener" /> associated with this collection is closed.</exception>
275 <member name="M:System.Net.HttpListenerPrefixCollection.Contains(System.String)">
276 <summary>Returns a <see cref="T:System.Boolean" /> value that indicates whether the specified prefix is contained in the collection.</summary>
277 <param name="uriPrefix">A <see cref="T:System.String" /> that contains the Uniform Resource Identifier (URI) prefix to test.</param>
279 <see langword="true" /> if this collection contains the prefix specified by <paramref name="uriPrefix" />; otherwise, <see langword="false" />.</returns>
280 <exception cref="T:System.ArgumentNullException">
281 <paramref name="uriPrefix" /> is <see langword="null" />.</exception>
283 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.Array,System.Int32)">
284 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection" /> to the specified array.</summary>
285 <param name="array">The one dimensional <see cref="T:System.Array" /> that receives the Uniform Resource Identifier (URI) prefix strings in this collection.</param>
286 <param name="offset">The zero-based index in <paramref name="array" /> at which copying begins.</param>
287 <exception cref="T:System.ArgumentException">
288 <paramref name="array" /> has more than one dimension.</exception>
289 <exception cref="T:System.ArgumentOutOfRangeException">This collection contains more elements than can be stored in <paramref name="array" /> starting at <paramref name="offset" />.</exception>
290 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener" /> associated with this collection is closed.</exception>
291 <exception cref="T:System.InvalidCastException">
292 <paramref name="array" /> cannot store string values.</exception>
294 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.String[],System.Int32)">
295 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection" /> to the specified string array.</summary>
296 <param name="array">The one dimensional string array that receives the Uniform Resource Identifier (URI) prefix strings in this collection.</param>
297 <param name="offset">The zero-based index in <paramref name="array" /> at which copying begins.</param>
298 <exception cref="T:System.ArgumentException">
299 <paramref name="array" /> has more than one dimension.</exception>
300 <exception cref="T:System.ArgumentOutOfRangeException">This collection contains more elements than can be stored in <paramref name="array" /> starting at <paramref name="offset" />.</exception>
301 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener" /> associated with this collection is closed.</exception>
303 <member name="P:System.Net.HttpListenerPrefixCollection.Count">
304 <summary>Gets the number of prefixes contained in the collection.</summary>
305 <returns>An <see cref="T:System.Int32" /> that contains the number of prefixes in this collection.</returns>
307 <member name="M:System.Net.HttpListenerPrefixCollection.GetEnumerator">
308 <summary>Returns an object that can be used to iterate through the collection.</summary>
309 <returns>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the strings in this collection.</returns>
311 <member name="P:System.Net.HttpListenerPrefixCollection.IsReadOnly">
312 <summary>Gets a value that indicates whether access to the collection is read-only.</summary>
313 <returns>Always returns <see langword="false" />.</returns>
315 <member name="P:System.Net.HttpListenerPrefixCollection.IsSynchronized">
316 <summary>Gets a value that indicates whether access to the collection is synchronized (thread-safe).</summary>
317 <returns>This property always returns <see langword="false" />.</returns>
319 <member name="M:System.Net.HttpListenerPrefixCollection.Remove(System.String)">
320 <summary>Removes the specified Uniform Resource Identifier (URI) from the list of prefixes handled by the <see cref="T:System.Net.HttpListener" /> object.</summary>
321 <param name="uriPrefix">A <see cref="T:System.String" /> that contains the URI prefix to remove.</param>
323 <see langword="true" /> if the <paramref name="uriPrefix" /> was found in the <see cref="T:System.Net.HttpListenerPrefixCollection" /> and removed; otherwise <see langword="false" />.</returns>
324 <exception cref="T:System.ArgumentNullException">
325 <paramref name="uriPrefix" /> is <see langword="null" />.</exception>
326 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. To determine the cause of the exception, check the exception's error code.</exception>
327 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener" /> associated with this collection is closed.</exception>
329 <member name="M:System.Net.HttpListenerPrefixCollection.System#Collections#IEnumerable#GetEnumerator">
330 <summary>Returns an object that can be used to iterate through the collection.</summary>
331 <returns>An object that implements the <see cref="T:System.Collections.IEnumerator" /> interface and provides access to the strings in this collection.</returns>
333 <member name="T:System.Net.HttpListenerRequest">
334 <summary>Describes an incoming HTTP request to an <see cref="T:System.Net.HttpListener" /> object. This class cannot be inherited.</summary>
336 <member name="P:System.Net.HttpListenerRequest.AcceptTypes">
337 <summary>Gets the MIME types accepted by the client.</summary>
338 <returns>A <see cref="T:System.String" /> array that contains the type names specified in the request's <see langword="Accept" /> header or <see langword="null" /> if the client request did not include an <see langword="Accept" /> header.</returns>
340 <member name="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)">
341 <summary>Begins an asynchronous request for the client's X.509 v.3 certificate.</summary>
342 <param name="requestCallback">An <see cref="T:System.AsyncCallback" /> delegate that references the method to invoke when the operation is complete.</param>
343 <param name="state">A user-defined object that contains information about the operation. This object is passed to the callback delegate when the operation completes.</param>
344 <returns>An <see cref="T:System.IAsyncResult" /> that indicates the status of the operation.</returns>
346 <member name="P:System.Net.HttpListenerRequest.ClientCertificateError">
347 <summary>Gets an error code that identifies a problem with the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate" /> provided by the client.</summary>
348 <returns>An <see cref="T:System.Int32" /> value that contains a Windows error code.</returns>
349 <exception cref="T:System.InvalidOperationException">The client certificate has not been initialized yet by a call to the <see cref="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)" /> or <see cref="M:System.Net.HttpListenerRequest.GetClientCertificate" /> methods
351 The operation is still in progress.</exception>
353 <member name="P:System.Net.HttpListenerRequest.ContentEncoding">
354 <summary>Gets the content encoding that can be used with data sent with the request.</summary>
355 <returns>An <see cref="T:System.Text.Encoding" /> object suitable for use with the data in the <see cref="P:System.Net.HttpListenerRequest.InputStream" /> property.</returns>
357 <member name="P:System.Net.HttpListenerRequest.ContentLength64">
358 <summary>Gets the length of the body data included in the request.</summary>
359 <returns>The value from the request's <see langword="Content-Length" /> header. This value is -1 if the content length is not known.</returns>
361 <member name="P:System.Net.HttpListenerRequest.ContentType">
362 <summary>Gets the MIME type of the body data included in the request.</summary>
363 <returns>A <see cref="T:System.String" /> that contains the text of the request's <see langword="Content-Type" /> header.</returns>
365 <member name="P:System.Net.HttpListenerRequest.Cookies">
366 <summary>Gets the cookies sent with the request.</summary>
367 <returns>A <see cref="T:System.Net.CookieCollection" /> that contains cookies that accompany the request. This property returns an empty collection if the request does not contain cookies.</returns>
369 <member name="M:System.Net.HttpListenerRequest.EndGetClientCertificate(System.IAsyncResult)">
370 <summary>Ends an asynchronous request for the client's X.509 v.3 certificate.</summary>
371 <param name="asyncResult">The pending request for the certificate.</param>
372 <returns>The <see cref="T:System.IAsyncResult" /> object that is returned when the operation started.</returns>
373 <exception cref="T:System.ArgumentNullException">
374 <paramref name="asyncResult" /> is <see langword="null" />.</exception>
375 <exception cref="T:System.ArgumentException">
376 <paramref name="asyncResult" /> was not obtained by calling <see cref="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)" /><paramref name="e." /></exception>
377 <exception cref="T:System.InvalidOperationException">This method was already called for the operation identified by <paramref name="asyncResult" />.</exception>
379 <member name="M:System.Net.HttpListenerRequest.GetClientCertificate">
380 <summary>Retrieves the client's X.509 v.3 certificate.</summary>
381 <returns>A <see cref="N:System.Security.Cryptography.X509Certificates" /> object that contains the client's X.509 v.3 certificate.</returns>
382 <exception cref="T:System.InvalidOperationException">A call to this method to retrieve the client's X.509 v.3 certificate is in progress and therefore another call to this method cannot be made.</exception>
384 <member name="M:System.Net.HttpListenerRequest.GetClientCertificateAsync">
385 <summary>Retrieves the client's X.509 v.3 certificate as an asynchronous operation.</summary>
386 <returns>The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result" /> property on the task object returns a <see cref="N:System.Security.Cryptography.X509Certificates" /> object that contains the client's X.509 v.3 certificate.</returns>
388 <member name="P:System.Net.HttpListenerRequest.HasEntityBody">
389 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the request has associated body data.</summary>
391 <see langword="true" /> if the request has associated body data; otherwise, <see langword="false" />.</returns>
393 <member name="P:System.Net.HttpListenerRequest.Headers">
394 <summary>Gets the collection of header name/value pairs sent in the request.</summary>
395 <returns>A <see cref="T:System.Net.WebHeaderCollection" /> that contains the HTTP headers included in the request.</returns>
397 <member name="P:System.Net.HttpListenerRequest.HttpMethod">
398 <summary>Gets the HTTP method specified by the client.</summary>
399 <returns>A <see cref="T:System.String" /> that contains the method used in the request.</returns>
401 <member name="P:System.Net.HttpListenerRequest.InputStream">
402 <summary>Gets a stream that contains the body data sent by the client.</summary>
403 <returns>A readable <see cref="T:System.IO.Stream" /> object that contains the bytes sent by the client in the body of the request. This property returns <see cref="F:System.IO.Stream.Null" /> if no data is sent with the request.</returns>
405 <member name="P:System.Net.HttpListenerRequest.IsAuthenticated">
406 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the client sending this request is authenticated.</summary>
408 <see langword="true" /> if the client was authenticated; otherwise, <see langword="false" />.</returns>
410 <member name="P:System.Net.HttpListenerRequest.IsLocal">
411 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the request is sent from the local computer.</summary>
413 <see langword="true" /> if the request originated on the same computer as the <see cref="T:System.Net.HttpListener" /> object that provided the request; otherwise, <see langword="false" />.</returns>
415 <member name="P:System.Net.HttpListenerRequest.IsSecureConnection">
416 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the TCP connection used to send the request is using the Secure Sockets Layer (SSL) protocol.</summary>
418 <see langword="true" /> if the TCP connection is using SSL; otherwise, <see langword="false" />.</returns>
420 <member name="P:System.Net.HttpListenerRequest.IsWebSocketRequest">
421 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the TCP connection was a WebSocket request.</summary>
422 <returns>Returns <see cref="T:System.Boolean" />.
423 <see langword="true" /> if the TCP connection is a WebSocket request; otherwise, <see langword="false" />.</returns>
425 <member name="P:System.Net.HttpListenerRequest.KeepAlive">
426 <summary>Gets a <see cref="T:System.Boolean" /> value that indicates whether the client requests a persistent connection.</summary>
428 <see langword="true" /> if the connection should be kept open; otherwise, <see langword="false" />.</returns>
430 <member name="P:System.Net.HttpListenerRequest.LocalEndPoint">
431 <summary>Gets the server IP address and port number to which the request is directed.</summary>
432 <returns>An <see cref="T:System.Net.IPEndPoint" /> that represents the IP address that the request is sent to.</returns>
434 <member name="P:System.Net.HttpListenerRequest.ProtocolVersion">
435 <summary>Gets the HTTP version used by the requesting client.</summary>
436 <returns>A <see cref="T:System.Version" /> that identifies the client's version of HTTP.</returns>
438 <member name="P:System.Net.HttpListenerRequest.QueryString">
439 <summary>Gets the query string included in the request.</summary>
440 <returns>A <see cref="T:System.Collections.Specialized.NameValueCollection" /> object that contains the query data included in the request <see cref="P:System.Net.HttpListenerRequest.Url" />.</returns>
442 <member name="P:System.Net.HttpListenerRequest.RawUrl">
443 <summary>Gets the URL information (without the host and port) requested by the client.</summary>
444 <returns>A <see cref="T:System.String" /> that contains the raw URL for this request.</returns>
446 <member name="P:System.Net.HttpListenerRequest.RemoteEndPoint">
447 <summary>Gets the client IP address and port number from which the request originated.</summary>
448 <returns>An <see cref="T:System.Net.IPEndPoint" /> that represents the IP address and port number from which the request originated.</returns>
450 <member name="P:System.Net.HttpListenerRequest.RequestTraceIdentifier">
451 <summary>Gets the request identifier of the incoming HTTP request.</summary>
452 <returns>A <see cref="T:System.Guid" /> object that contains the identifier of the HTTP request.</returns>
454 <member name="P:System.Net.HttpListenerRequest.ServiceName">
455 <summary>Gets the Service Provider Name (SPN) that the client sent on the request.</summary>
456 <returns>A <see cref="T:System.String" /> that contains the SPN the client sent on the request.</returns>
458 <member name="P:System.Net.HttpListenerRequest.TransportContext">
459 <summary>Gets the <see cref="T:System.Net.TransportContext" /> for the client request.</summary>
460 <returns>A <see cref="T:System.Net.TransportContext" /> object for the client request.</returns>
462 <member name="P:System.Net.HttpListenerRequest.Url">
463 <summary>Gets the <see cref="T:System.Uri" /> object requested by the client.</summary>
464 <returns>A <see cref="T:System.Uri" /> object that identifies the resource requested by the client.</returns>
466 <member name="P:System.Net.HttpListenerRequest.UrlReferrer">
467 <summary>Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.</summary>
468 <returns>A <see cref="T:System.Uri" /> object that contains the text of the request's <see cref="F:System.Net.HttpRequestHeader.Referer" /> header, or <see langword="null" /> if the header was not included in the request.</returns>
470 <member name="P:System.Net.HttpListenerRequest.UserAgent">
471 <summary>Gets the user agent presented by the client.</summary>
472 <returns>A <see cref="T:System.String" /> object that contains the text of the request's <see langword="User-Agent" /> header.</returns>
474 <member name="P:System.Net.HttpListenerRequest.UserHostAddress">
475 <summary>Gets the server IP address and port number to which the request is directed.</summary>
476 <returns>A <see cref="T:System.String" /> that contains the host address information.</returns>
478 <member name="P:System.Net.HttpListenerRequest.UserHostName">
479 <summary>Gets the DNS name and, if provided, the port number specified by the client.</summary>
480 <returns>A <see cref="T:System.String" /> value that contains the text of the request's <see langword="Host" /> header.</returns>
482 <member name="P:System.Net.HttpListenerRequest.UserLanguages">
483 <summary>Gets the natural languages that are preferred for the response.</summary>
484 <returns>A <see cref="T:System.String" /> array that contains the languages specified in the request's <see cref="F:System.Net.HttpRequestHeader.AcceptLanguage" /> header or <see langword="null" /> if the client request did not include an <see cref="F:System.Net.HttpRequestHeader.AcceptLanguage" /> header.</returns>
486 <member name="T:System.Net.HttpListenerResponse">
487 <summary>Represents a response to a request being handled by an <see cref="T:System.Net.HttpListener" /> object.</summary>
489 <member name="M:System.Net.HttpListenerResponse.Abort">
490 <summary>Closes the connection to the client without sending a response.</summary>
492 <member name="M:System.Net.HttpListenerResponse.AddHeader(System.String,System.String)">
493 <summary>Adds the specified header and value to the HTTP headers for this response.</summary>
494 <param name="name">The name of the HTTP header to set.</param>
495 <param name="value">The value for the <paramref name="name" /> header.</param>
496 <exception cref="T:System.ArgumentNullException">
497 <paramref name="name" /> is <see langword="null" /> or an empty string ("").</exception>
498 <exception cref="T:System.ArgumentException">You are not allowed to specify a value for the specified header.
500 <paramref name="name" /> or <paramref name="value" /> contains invalid characters.</exception>
501 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value" /> is greater than 65,535 characters.</exception>
503 <member name="M:System.Net.HttpListenerResponse.AppendCookie(System.Net.Cookie)">
504 <summary>Adds the specified <see cref="T:System.Net.Cookie" /> to the collection of cookies for this response.</summary>
505 <param name="cookie">The <see cref="T:System.Net.Cookie" /> to add to the collection to be sent with this response.</param>
506 <exception cref="T:System.ArgumentNullException">
507 <paramref name="cookie" /> is <see langword="null" />.</exception>
509 <member name="M:System.Net.HttpListenerResponse.AppendHeader(System.String,System.String)">
510 <summary>Appends a value to the specified HTTP header to be sent with this response.</summary>
511 <param name="name">The name of the HTTP header to append <paramref name="value" /> to.</param>
512 <param name="value">The value to append to the <paramref name="name" /> header.</param>
513 <exception cref="T:System.ArgumentException">
514 <paramref name="name" /> is <see langword="null" /> or an empty string ("").
516 You are not allowed to specify a value for the specified header.
518 <paramref name="name" /> or <paramref name="value" /> contains invalid characters.</exception>
519 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value" /> is greater than 65,535 characters.</exception>
521 <member name="M:System.Net.HttpListenerResponse.Close">
522 <summary>Sends the response to the client and releases the resources held by this <see cref="T:System.Net.HttpListenerResponse" /> instance.</summary>
524 <member name="M:System.Net.HttpListenerResponse.Close(System.Byte[],System.Boolean)">
525 <summary>Returns the specified byte array to the client and releases the resources held by this <see cref="T:System.Net.HttpListenerResponse" /> instance.</summary>
526 <param name="responseEntity">A <see cref="T:System.Byte" /> array that contains the response to send to the client.</param>
527 <param name="willBlock">
528 <see langword="true" /> to block execution while flushing the stream to the client; otherwise, <see langword="false" />.</param>
529 <exception cref="T:System.ArgumentNullException">
530 <paramref name="responseEntity" /> is <see langword="null" />.</exception>
531 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
533 <member name="P:System.Net.HttpListenerResponse.ContentEncoding">
534 <summary>Gets or sets the <see cref="T:System.Text.Encoding" /> for this response's <see cref="P:System.Net.HttpListenerResponse.OutputStream" />.</summary>
535 <returns>An <see cref="T:System.Text.Encoding" /> object suitable for use with the data in the <see cref="P:System.Net.HttpListenerResponse.OutputStream" /> property, or <see langword="null" /> if no encoding is specified.</returns>
537 <member name="P:System.Net.HttpListenerResponse.ContentLength64">
538 <summary>Gets or sets the number of bytes in the body data included in the response.</summary>
539 <returns>The value of the response's <see langword="Content-Length" /> header.</returns>
540 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than zero.</exception>
541 <exception cref="T:System.InvalidOperationException">The response is already being sent.</exception>
542 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
544 <member name="P:System.Net.HttpListenerResponse.ContentType">
545 <summary>Gets or sets the MIME type of the content returned.</summary>
546 <returns>A <see cref="T:System.String" /> instance that contains the text of the response's <see langword="Content-Type" /> header.</returns>
547 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null" />.</exception>
548 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string ("").</exception>
549 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
551 <member name="P:System.Net.HttpListenerResponse.Cookies">
552 <summary>Gets or sets the collection of cookies returned with the response.</summary>
553 <returns>A <see cref="T:System.Net.CookieCollection" /> that contains cookies to accompany the response. The collection is empty if no cookies have been added to the response.</returns>
555 <member name="M:System.Net.HttpListenerResponse.CopyFrom(System.Net.HttpListenerResponse)">
556 <summary>Copies properties from the specified <see cref="T:System.Net.HttpListenerResponse" /> to this response.</summary>
557 <param name="templateResponse">The <see cref="T:System.Net.HttpListenerResponse" /> instance to copy.</param>
559 <member name="P:System.Net.HttpListenerResponse.Headers">
560 <summary>Gets or sets the collection of header name/value pairs returned by the server.</summary>
561 <returns>A <see cref="T:System.Net.WebHeaderCollection" /> instance that contains all the explicitly set HTTP headers to be included in the response.</returns>
562 <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebHeaderCollection" /> instance specified for a set operation is not valid for a response.</exception>
564 <member name="P:System.Net.HttpListenerResponse.KeepAlive">
565 <summary>Gets or sets a value indicating whether the server requests a persistent connection.</summary>
567 <see langword="true" /> if the server requests a persistent connection; otherwise, <see langword="false" />. The default is <see langword="true" />.</returns>
568 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
570 <member name="P:System.Net.HttpListenerResponse.OutputStream">
571 <summary>Gets a <see cref="T:System.IO.Stream" /> object to which a response can be written.</summary>
572 <returns>A <see cref="T:System.IO.Stream" /> object to which a response can be written.</returns>
573 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
575 <member name="P:System.Net.HttpListenerResponse.ProtocolVersion">
576 <summary>Gets or sets the HTTP version used for the response.</summary>
577 <returns>A <see cref="T:System.Version" /> object indicating the version of HTTP used when responding to the client. Note that this property is now obsolete.</returns>
578 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null" />.</exception>
579 <exception cref="T:System.ArgumentException">The value specified for a set operation does not have its <see cref="P:System.Version.Major" /> property set to 1 or does not have its <see cref="P:System.Version.Minor" /> property set to either 0 or 1.</exception>
580 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
582 <member name="M:System.Net.HttpListenerResponse.Redirect(System.String)">
583 <summary>Configures the response to redirect the client to the specified URL.</summary>
584 <param name="url">The URL that the client should use to locate the requested resource.</param>
586 <member name="P:System.Net.HttpListenerResponse.RedirectLocation">
587 <summary>Gets or sets the value of the HTTP <see langword="Location" /> header in this response.</summary>
588 <returns>A <see cref="T:System.String" /> that contains the absolute URL to be sent to the client in the <see langword="Location" /> header.</returns>
589 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string ("").</exception>
590 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
592 <member name="P:System.Net.HttpListenerResponse.SendChunked">
593 <summary>Gets or sets whether the response uses chunked transfer encoding.</summary>
595 <see langword="true" /> if the response is set to use chunked transfer encoding; otherwise, <see langword="false" />. The default is <see langword="false" />.</returns>
597 <member name="M:System.Net.HttpListenerResponse.SetCookie(System.Net.Cookie)">
598 <summary>Adds or updates a <see cref="T:System.Net.Cookie" /> in the collection of cookies sent with this response.</summary>
599 <param name="cookie">A <see cref="T:System.Net.Cookie" /> for this response.</param>
600 <exception cref="T:System.ArgumentNullException">
601 <paramref name="cookie" /> is <see langword="null" />.</exception>
602 <exception cref="T:System.ArgumentException">The cookie already exists in the collection and could not be replaced.</exception>
604 <member name="P:System.Net.HttpListenerResponse.StatusCode">
605 <summary>Gets or sets the HTTP status code to be returned to the client.</summary>
606 <returns>An <see cref="T:System.Int32" /> value that specifies the HTTP status code for the requested resource. The default is <see cref="F:System.Net.HttpStatusCode.OK" />, indicating that the server successfully processed the client's request and included the requested resource in the response body.</returns>
607 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
608 <exception cref="T:System.Net.ProtocolViolationException">The value specified for a set operation is not valid. Valid values are between 100 and 999 inclusive.</exception>
610 <member name="P:System.Net.HttpListenerResponse.StatusDescription">
611 <summary>Gets or sets a text description of the HTTP status code returned to the client.</summary>
612 <returns>The text description of the HTTP status code returned to the client. The default is the RFC 2616 description for the <see cref="P:System.Net.HttpListenerResponse.StatusCode" /> property value, or an empty string ("") if an RFC 2616 description does not exist.</returns>
613 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is <see langword="null" />.</exception>
614 <exception cref="T:System.ArgumentException">The value specified for a set operation contains non-printable characters.</exception>
616 <member name="M:System.Net.HttpListenerResponse.System#IDisposable#Dispose">
617 <summary>Releases all resources used by the <see cref="T:System.Net.HttpListenerResponse" />.</summary>
619 <member name="T:System.Net.HttpListenerTimeoutManager">
620 <summary>The timeout manager to use for an <see cref="T:System.Net.HttpListener" /> object.</summary>
622 <member name="P:System.Net.HttpListenerTimeoutManager.DrainEntityBody">
623 <summary>Gets or sets the time allowed for the <see cref="T:System.Net.HttpListener" /> to drain the entity body on a Keep-Alive connection.</summary>
624 <returns>The time allowed for the <see cref="T:System.Net.HttpListener" /> to drain the entity body on a Keep-Alive connection.</returns>
626 <member name="P:System.Net.HttpListenerTimeoutManager.EntityBody">
627 <summary>Gets or sets the time allowed for the request entity body to arrive.</summary>
628 <returns>The time allowed for the request entity body to arrive.</returns>
630 <member name="P:System.Net.HttpListenerTimeoutManager.HeaderWait">
631 <summary>Gets or sets the time allowed for the <see cref="T:System.Net.HttpListener" /> to parse the request header.</summary>
632 <returns>The time allowed for the <see cref="T:System.Net.HttpListener" /> to parse the request header.</returns>
634 <member name="P:System.Net.HttpListenerTimeoutManager.IdleConnection">
635 <summary>Gets or sets the time allowed for an idle connection.</summary>
636 <returns>The time allowed for an idle connection.</returns>
638 <member name="P:System.Net.HttpListenerTimeoutManager.MinSendBytesPerSecond">
639 <summary>Gets or sets the minimum send rate, in bytes-per-second, for the response.</summary>
640 <returns>The minimum send rate, in bytes-per-second, for the response.</returns>
642 <member name="P:System.Net.HttpListenerTimeoutManager.RequestQueue">
643 <summary>Gets or sets the time allowed for the request to remain in the request queue before the <see cref="T:System.Net.HttpListener" /> picks it up.</summary>
644 <returns>The time allowed for the request to remain in the request queue before the <see cref="T:System.Net.HttpListener" /> picks it up.</returns>
646 <member name="T:System.Net.WebSockets.HttpListenerWebSocketContext">
647 <summary>Provides access to information received by the <see cref="T:System.Net.HttpListener" /> class when accepting WebSocket connections.</summary>
649 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.CookieCollection">
650 <summary>Gets the cookies received by the <see cref="T:System.Net.HttpListener" /> object in the WebSocket opening handshake.</summary>
651 <returns>The cookies received by the <see cref="T:System.Net.HttpListener" /> object.</returns>
653 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Headers">
654 <summary>Gets the HTTP headers received by the <see cref="T:System.Net.HttpListener" /> object in the WebSocket opening handshake.</summary>
655 <returns>The HTTP headers received by the <see cref="T:System.Net.HttpListener" /> object.</returns>
657 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsAuthenticated">
658 <summary>Gets a value that indicates if the WebSocket client is authenticated.</summary>
660 <see langword="true" /> if the WebSocket client is authenticated; otherwise, <see langword="false" />.</returns>
662 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsLocal">
663 <summary>Gets a value that indicates if the WebSocket client connected from the local machine.</summary>
665 <see langword="true" /> if the WebSocket client connected from the local machine; otherwise, <see langword="false" />.</returns>
667 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsSecureConnection">
668 <summary>Gets a value that indicates if the WebSocket connection is secured using Secure Sockets Layer (SSL).</summary>
670 <see langword="true" /> if the WebSocket connection is secured using SSL; otherwise, <see langword="false" />.</returns>
672 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Origin">
673 <summary>Gets the value of the Origin HTTP header included in the WebSocket opening handshake.</summary>
674 <returns>The value of the Origin HTTP header.</returns>
676 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.RequestUri">
677 <summary>Gets the URI requested by the WebSocket client.</summary>
678 <returns>The URI requested by the WebSocket client.</returns>
680 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketKey">
681 <summary>Gets the value of the SecWebSocketKey HTTP header included in the WebSocket opening handshake.</summary>
682 <returns>The value of the SecWebSocketKey HTTP header.</returns>
684 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketProtocols">
685 <summary>Gets the list of the Secure WebSocket protocols included in the WebSocket opening handshake.</summary>
686 <returns>The list of the Secure WebSocket protocols.</returns>
688 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketVersion">
689 <summary>Gets the list of sub-protocols requested by the WebSocket client.</summary>
690 <returns>The list of sub-protocols requested by the WebSocket client.</returns>
692 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.User">
693 <summary>Gets an object used to obtain identity, authentication information, and security roles for the WebSocket client.</summary>
694 <returns>The identity, authentication information, and security roles for the WebSocket client.</returns>
696 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.WebSocket">
697 <summary>Gets the <see cref="T:System.Net.WebSockets.WebSocket" /> instance used to send and receive data over the <see cref="T:System.Net.WebSockets.WebSocket" /> connection.</summary>
698 <returns>The <see cref="T:System.Net.WebSockets.WebSocket" /> instance used to send and receive data over the <see cref="T:System.Net.WebSockets.WebSocket" /> connection.</returns>