1 <?xml version="1.0" encoding="utf-8"?><doc>
3 <name>System.Net.HttpListener</name>
6 <member name="T:System.Net.HttpListener.ExtendedProtectionSelector">
7 <summary>A delegate called to determine the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> to use for each <see cref="T:System.Net.HttpListener"></see> request.</summary>
8 <param name="request">The <see cref="T:System.Net.HttpListenerRequest"></see> to determine the extended protection policy that the <see cref="T:System.Net.HttpListener"></see> instance will use to provide extended protection.</param>
9 <returns>An <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> object that specifies the extended protection policy to use for this request.</returns>
11 <member name="T:System.Net.HttpListener">
12 <summary>Provides a simple, programmatically controlled HTTP protocol listener. This class cannot be inherited.</summary>
14 <member name="M:System.Net.HttpListener.#ctor">
15 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListener"></see> class.</summary>
16 <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>
18 <member name="M:System.Net.HttpListener.Abort">
19 <summary>Shuts down the <see cref="T:System.Net.HttpListener"></see> object immediately, discarding all currently queued requests.</summary>
21 <member name="P:System.Net.HttpListener.AuthenticationSchemes">
22 <summary>Gets or sets the scheme used to authenticate clients.</summary>
23 <returns>A bitwise combination of <see cref="System.Net.AuthenticationSchemes"></see> enumeration values that indicates how clients are to be authenticated. The default value is <see cref="System.Net.AuthenticationSchemes.Anonymous"></see>.</returns>
24 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
26 <member name="P:System.Net.HttpListener.AuthenticationSchemeSelectorDelegate">
27 <summary>Gets or sets the delegate called to determine the protocol used to authenticate clients.</summary>
28 <returns>An <see cref="System.Net.AuthenticationSchemeSelector"></see> delegate that invokes the method used to select an authentication protocol. The default value is null.</returns>
29 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
31 <member name="M:System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)">
32 <summary>Begins asynchronously retrieving an incoming request.</summary>
33 <param name="callback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when a client request is available.</param>
34 <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>
35 <returns>An <see cref="System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
36 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception&#39;s <see cref="System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
37 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped.</exception>
38 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
40 <member name="M:System.Net.HttpListener.Close">
41 <summary>Shuts down the <see cref="T:System.Net.HttpListener"></see>.</summary>
43 <member name="P:System.Net.HttpListener.DefaultServiceNames">
44 <summary>Gets a default list of Service Provider Names (SPNs) as determined by registered prefixes.</summary>
45 <returns>A <see cref="System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> that contains a list of SPNs.</returns>
47 <member name="M:System.Net.HttpListener.EndGetContext(System.IAsyncResult)">
48 <summary>Completes an asynchronous operation to retrieve an incoming client request.</summary>
49 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> object that was obtained when the asynchronous operation was started.</param>
50 <returns>An <see cref="System.Net.HttpListenerContext"></see> object that represents the client request.</returns>
51 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling the <see cref="System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)"></see> method.</exception>
52 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
53 <exception cref="T:System.InvalidOperationException">The <see cref="System.Net.HttpListener.EndGetContext(System.IAsyncResult)"></see> method was already called for the specified <paramref name="asyncResult">asyncResult</paramref> object.</exception>
54 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
56 <member name="P:System.Net.HttpListener.ExtendedProtectionPolicy">
57 <summary>Get or set the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> to use for extended protection for a session.</summary>
58 <returns>A <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that specifies the policy to use for extended protection.</returns>
59 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionPolicy"></see> property, but the <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> property was not null.</exception>
60 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionPolicy"></see> property to null.</exception>
61 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionPolicy"></see> property after the <see cref="System.Net.HttpListener.Start"></see> method was already called.</exception>
62 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
63 <exception cref="T:System.PlatformNotSupportedException">The <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.PolicyEnforcement"></see> property was set to <see cref="System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
65 <member name="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate">
66 <summary>Get or set the delegate called to determine the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> to use for each request.</summary>
67 <returns>A <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that specifies the policy to use for extended protection.</returns>
68 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property, but the <see cref="System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> property must be null.</exception>
69 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property to null.</exception>
70 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property after the <see cref="System.Net.HttpListener.Start"></see> method was already called.</exception>
71 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
72 <exception cref="T:System.PlatformNotSupportedException">An attempt was made to set the <see cref="System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property on a platform that does not support extended protection.</exception>
74 <member name="M:System.Net.HttpListener.GetContext">
75 <summary>Waits for an incoming request and returns when one is received.</summary>
76 <returns>An <see cref="System.Net.HttpListenerContext"></see> object that represents a client request.</returns>
77 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception&#39;s <see cref="System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
78 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped.
80 The <see cref="System.Net.HttpListener"></see> does not have any Uniform Resource Identifier (URI) prefixes to respond to.</exception>
81 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
83 <member name="M:System.Net.HttpListener.GetContextAsync">
84 <summary>Waits for an incoming request as an asynchronous operation.</summary>
85 <returns>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
86 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="System.Net.HttpListenerContext"></see> object that represents a client request.</returns>
88 <member name="P:System.Net.HttpListener.IgnoreWriteExceptions">
89 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that specifies whether your application receives exceptions that occur when an <see cref="T:System.Net.HttpListener"></see> sends the response to the client.</summary>
90 <returns>true if this <see cref="System.Net.HttpListener"></see> should not return exceptions that occur when sending the response to the client; otherwise false. The default value is false.</returns>
91 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
93 <member name="P:System.Net.HttpListener.IsListening">
94 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener"></see> has been started.</summary>
95 <returns>true if the <see cref="System.Net.HttpListener"></see> was started; otherwise, false.</returns>
97 <member name="P:System.Net.HttpListener.IsSupported">
98 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener"></see> can be used with the current operating system.</summary>
99 <returns>true if <see cref="System.Net.HttpListener"></see> is supported; otherwise, false.</returns>
101 <member name="P:System.Net.HttpListener.Prefixes">
102 <summary>Gets the Uniform Resource Identifier (URI) prefixes handled by this <see cref="T:System.Net.HttpListener"></see> object.</summary>
103 <returns>An <see cref="System.Net.HttpListenerPrefixCollection"></see> that contains the URI prefixes that this <see cref="System.Net.HttpListener"></see> object is configured to handle.</returns>
104 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
106 <member name="P:System.Net.HttpListener.Realm">
107 <summary>Gets or sets the realm, or resource partition, associated with this <see cref="T:System.Net.HttpListener"></see> object.</summary>
108 <returns>A <see cref="System.String"></see> value that contains the name of the realm associated with the <see cref="System.Net.HttpListener"></see> object.</returns>
109 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
111 <member name="M:System.Net.HttpListener.Start">
112 <summary>Allows this instance to receive incoming requests.</summary>
113 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception&#39;s <see cref="System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
114 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
116 <member name="M:System.Net.HttpListener.Stop">
117 <summary>Causes this instance to stop receiving incoming requests.</summary>
118 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
120 <member name="P:System.Net.HttpListener.TimeoutManager">
121 <summary>The timeout manager for this <see cref="T:System.Net.HttpListener"></see> instance.</summary>
122 <returns>Returns <see cref="System.Net.HttpListenerTimeoutManager"></see>.
123 The timeout manager for this <see cref="System.Net.HttpListener"></see> instance.</returns>
125 <member name="P:System.Net.HttpListener.UnsafeConnectionNtlmAuthentication">
126 <summary>Gets or sets a <see cref="T:System.Boolean"></see> value that controls whether, when NTLM is used, additional requests using the same Transmission Control Protocol (TCP) connection are required to authenticate.</summary>
127 <returns>true if the <see cref="System.Security.Principal.IIdentity"></see> of the first request will be used for subsequent requests on the same connection; otherwise, false. The default value is false.</returns>
128 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
130 <member name="M:System.Net.HttpListener.System#IDisposable#Dispose">
131 <summary>Releases the resources held by this <see cref="T:System.Net.HttpListener"></see> object.</summary>
133 <member name="T:System.Net.HttpListenerBasicIdentity">
134 <summary>Holds the user name and password from a basic authentication request.</summary>
136 <member name="M:System.Net.HttpListenerBasicIdentity.#ctor(System.String,System.String)">
137 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerBasicIdentity"></see> class using the specified user name and password.</summary>
138 <param name="username">The user name.</param>
139 <param name="password">The password.</param>
141 <member name="P:System.Net.HttpListenerBasicIdentity.Password">
142 <summary>Indicates the password from a basic authentication attempt.</summary>
143 <returns>A <see cref="System.String"></see> that holds the password.</returns>
145 <member name="T:System.Net.HttpListenerContext">
146 <summary>Provides access to the request and response objects used by the <see cref="T:System.Net.HttpListener"></see> class. This class cannot be inherited.</summary>
148 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String)">
149 <summary>Accept a WebSocket connection as an asynchronous operation.</summary>
150 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
151 <returns>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
152 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
153 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string
155 <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
156 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
158 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.TimeSpan)">
159 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol and WebSocket keep-alive interval as an asynchronous operation.</summary>
160 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
161 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
162 <returns>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
163 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
164 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string
166 <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
167 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small.</exception>
168 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
170 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.Int32,System.TimeSpan)">
171 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, and WebSocket keep-alive interval as an asynchronous operation.</summary>
172 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
173 <param name="receiveBufferSize">The receive buffer size in bytes.</param>
174 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
175 <returns>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
176 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
177 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string
179 <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
180 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small.
182 <paramref name="receiveBufferSize">receiveBufferSize</paramref> is less than 16 bytes
184 <paramref name="receiveBufferSize">receiveBufferSize</paramref> 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>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
194 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
195 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string
197 <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
198 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small.
200 <paramref name="receiveBufferSize">receiveBufferSize</paramref> is less than 16 bytes
202 <paramref name="receiveBufferSize">receiveBufferSize</paramref> is greater than 64K bytes.</exception>
203 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
205 <member name="P:System.Net.HttpListenerContext.Request">
206 <summary>Gets the <see cref="T:System.Net.HttpListenerRequest"></see> that represents a client&#39;s request for a resource.</summary>
207 <returns>An <see cref="System.Net.HttpListenerRequest"></see> object that represents the client request.</returns>
209 <member name="P:System.Net.HttpListenerContext.Response">
210 <summary>Gets the <see cref="T:System.Net.HttpListenerResponse"></see> object that will be sent to the client in response to the client&#39;s request.</summary>
211 <returns>An <see cref="System.Net.HttpListenerResponse"></see> object used to send a response back to the client.</returns>
213 <member name="P:System.Net.HttpListenerContext.User">
214 <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"></see> object.</summary>
215 <returns>An <see cref="System.Security.Principal.IPrincipal"></see> object that describes the client, or null if the <see cref="System.Net.HttpListener"></see> that supplied this <see cref="System.Net.HttpListenerContext"></see> does not require authentication.</returns>
217 <member name="T:System.Net.HttpListenerException">
218 <summary>The exception that is thrown when an error occurs processing an HTTP request.</summary>
220 <member name="M:System.Net.HttpListenerException.#ctor">
221 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class.</summary>
223 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32)">
224 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class using the specified error code.</summary>
225 <param name="errorCode">A <see cref="T:System.Int32"></see> value that identifies the error that occurred.</param>
227 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32,System.String)">
228 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class using the specified error code and message.</summary>
229 <param name="errorCode">A <see cref="T:System.Int32"></see> value that identifies the error that occurred.</param>
230 <param name="message">A <see cref="T:System.String"></see> that describes the error that occurred.</param>
232 <member name="M:System.Net.HttpListenerException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
233 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class from the specified instances of the <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> and <see cref="T:System.Runtime.Serialization.StreamingContext"></see> classes.</summary>
234 <param name="serializationInfo">A <see cref="T:System.Runtime.Serialization.SerializationInfo"></see> object that contains the information required to deserialize the new <see cref="T:System.Net.HttpListenerException"></see> object.</param>
235 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> object.</param>
237 <member name="P:System.Net.HttpListenerException.ErrorCode">
238 <summary>Gets a value that identifies the error that occurred.</summary>
239 <returns>A <see cref="System.Int32"></see> value.</returns>
241 <member name="T:System.Net.HttpListenerPrefixCollection">
242 <summary>Represents the collection used to store Uniform Resource Identifier (URI) prefixes for <see cref="T:System.Net.HttpListener"></see> objects.</summary>
244 <member name="M:System.Net.HttpListenerPrefixCollection.Add(System.String)">
245 <summary>Adds a Uniform Resource Identifier (URI) prefix to the collection.</summary>
246 <param name="uriPrefix">A <see cref="T:System.String"></see> that identifies the URI information that is compared in incoming requests. The prefix must be terminated with a forward slash (&quot;/&quot;).</param>
247 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
248 <exception cref="T:System.ArgumentException"><paramref name="uriPrefix">uriPrefix</paramref> does not use the http:// or https:// scheme. These are the only schemes supported for <see cref="System.Net.HttpListener"></see> objects.
250 <paramref name="uriPrefix">uriPrefix</paramref> is not a correctly formatted URI prefix. Make sure the string is terminated with a &quot;/&quot;.</exception>
251 <exception cref="T:System.ObjectDisposedException">The <see cref="System.Net.HttpListener"></see> associated with this collection is closed.</exception>
252 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception&#39;s <see cref="System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception. This exception is thrown if another <see cref="System.Net.HttpListener"></see> has already added the prefix <paramref name="uriPrefix">uriPrefix</paramref>.</exception>
254 <member name="M:System.Net.HttpListenerPrefixCollection.Clear">
255 <summary>Removes all the Uniform Resource Identifier (URI) prefixes from the collection.</summary>
256 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception&#39;s <see cref="System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
257 <exception cref="T:System.ObjectDisposedException">The <see cref="System.Net.HttpListener"></see> associated with this collection is closed.</exception>
259 <member name="M:System.Net.HttpListenerPrefixCollection.Contains(System.String)">
260 <summary>Returns a <see cref="T:System.Boolean"></see> value that indicates whether the specified prefix is contained in the collection.</summary>
261 <param name="uriPrefix">A <see cref="T:System.String"></see> that contains the Uniform Resource Identifier (URI) prefix to test.</param>
262 <returns>true if this collection contains the prefix specified by <paramref name="uriPrefix">uriPrefix</paramref>; otherwise, false.</returns>
263 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
265 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.Array,System.Int32)">
266 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection"></see> to the specified array.</summary>
267 <param name="array">The one dimensional <see cref="T:System.Array"></see> that receives the Uniform Resource Identifier (URI) prefix strings in this collection.</param>
268 <param name="offset">The zero-based index in array at which copying begins.</param>
269 <exception cref="T:System.ArgumentException"><paramref name="array">array</paramref> has more than one dimension.</exception>
270 <exception cref="T:System.ArgumentOutOfRangeException">This collection contains more elements than can be stored in <paramref name="array">array</paramref> starting at <paramref name="offset">offset</paramref>.</exception>
271 <exception cref="T:System.ObjectDisposedException">The <see cref="System.Net.HttpListener"></see> associated with this collection is closed.</exception>
272 <exception cref="T:System.InvalidCastException"><paramref name="array">array</paramref> cannot store string values.</exception>
274 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.String[],System.Int32)">
275 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection"></see> to the specified string array.</summary>
276 <param name="array">The one dimensional string array that receives the Uniform Resource Identifier (URI) prefix strings in this collection.</param>
277 <param name="offset">The zero-based index in array at which copying begins.</param>
278 <exception cref="T:System.ArgumentException"><paramref name="array">array</paramref> has more than one dimension.</exception>
279 <exception cref="T:System.ArgumentOutOfRangeException">This collection contains more elements than can be stored in <paramref name="array">array</paramref> starting at <paramref name="offset">offset</paramref>.</exception>
280 <exception cref="T:System.ObjectDisposedException">The <see cref="System.Net.HttpListener"></see> associated with this collection is closed.</exception>
282 <member name="P:System.Net.HttpListenerPrefixCollection.Count">
283 <summary>Gets the number of prefixes contained in the collection.</summary>
284 <returns>An <see cref="System.Int32"></see> that contains the number of prefixes in this collection.</returns>
286 <member name="M:System.Net.HttpListenerPrefixCollection.GetEnumerator">
287 <summary>Returns an object that can be used to iterate through the collection.</summary>
288 <returns>An object that implements the <see cref="System.Collections.IEnumerator"></see> interface and provides access to the strings in this collection.</returns>
290 <member name="P:System.Net.HttpListenerPrefixCollection.IsReadOnly">
291 <summary>Gets a value that indicates whether access to the collection is read-only.</summary>
292 <returns>Always returns false.</returns>
294 <member name="P:System.Net.HttpListenerPrefixCollection.IsSynchronized">
295 <summary>Gets a value that indicates whether access to the collection is synchronized (thread-safe).</summary>
296 <returns>This property always returns false.</returns>
298 <member name="M:System.Net.HttpListenerPrefixCollection.Remove(System.String)">
299 <summary>Removes the specified Uniform Resource Identifier (URI) from the list of prefixes handled by the <see cref="T:System.Net.HttpListener"></see> object.</summary>
300 <param name="uriPrefix">A <see cref="T:System.String"></see> that contains the URI prefix to remove.</param>
301 <returns>true if the <paramref name="uriPrefix">uriPrefix</paramref> was found in the <see cref="System.Net.HttpListenerPrefixCollection"></see> and removed; otherwise false.</returns>
302 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
303 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. To determine the cause of the exception, check the exception&#39;s error code.</exception>
304 <exception cref="T:System.ObjectDisposedException">The <see cref="System.Net.HttpListener"></see> associated with this collection is closed.</exception>
306 <member name="M:System.Net.HttpListenerPrefixCollection.System#Collections#IEnumerable#GetEnumerator">
307 <summary>Returns an object that can be used to iterate through the collection.</summary>
308 <returns>An object that implements the <see cref="System.Collections.IEnumerator"></see> interface and provides access to the strings in this collection.</returns>
310 <member name="T:System.Net.HttpListenerRequest">
311 <summary>Describes an incoming HTTP request to an <see cref="T:System.Net.HttpListener"></see> object. This class cannot be inherited.</summary>
313 <member name="P:System.Net.HttpListenerRequest.AcceptTypes">
314 <summary>Gets the MIME types accepted by the client.</summary>
315 <returns>A <see cref="System.String"></see> array that contains the type names specified in the request&#39;s Accept header or null if the client request did not include an Accept header.</returns>
317 <member name="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)">
318 <summary>Begins an asynchronous request for the client&#39;s X.509 v.3 certificate.</summary>
319 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
320 <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>
321 <returns>An <see cref="System.IAsyncResult"></see> that indicates the status of the operation.</returns>
323 <member name="P:System.Net.HttpListenerRequest.ClientCertificateError">
324 <summary>Gets an error code that identifies a problem with the <see cref="T:System.Security.Cryptography.X509Certificates.X509Certificate"></see> provided by the client.</summary>
325 <returns>An <see cref="System.Int32"></see> value that contains a Windows error code.</returns>
326 <exception cref="T:System.InvalidOperationException">The client certificate has not been initialized yet by a call to the <see cref="System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)"></see> or <see cref="System.Net.HttpListenerRequest.GetClientCertificate"></see> methods
328 The operation is still in progress.</exception>
330 <member name="P:System.Net.HttpListenerRequest.ContentEncoding">
331 <summary>Gets the content encoding that can be used with data sent with the request</summary>
332 <returns>An <see cref="System.Text.Encoding"></see> object suitable for use with the data in the <see cref="System.Net.HttpListenerRequest.InputStream"></see> property.</returns>
334 <member name="P:System.Net.HttpListenerRequest.ContentLength64">
335 <summary>Gets the length of the body data included in the request.</summary>
336 <returns>The value from the request&#39;s Content-Length header. This value is -1 if the content length is not known.</returns>
338 <member name="P:System.Net.HttpListenerRequest.ContentType">
339 <summary>Gets the MIME type of the body data included in the request.</summary>
340 <returns>A <see cref="System.String"></see> that contains the text of the request&#39;s Content-Type header.</returns>
342 <member name="P:System.Net.HttpListenerRequest.Cookies">
343 <summary>Gets the cookies sent with the request.</summary>
344 <returns>A <see cref="System.Net.CookieCollection"></see> that contains cookies that accompany the request. This property returns an empty collection if the request does not contain cookies.</returns>
346 <member name="M:System.Net.HttpListenerRequest.EndGetClientCertificate(System.IAsyncResult)">
347 <summary>Ends an asynchronous request for the client&#39;s X.509 v.3 certificate.</summary>
348 <param name="asyncResult">The pending request for the certificate.</param>
349 <returns>The <see cref="System.IAsyncResult"></see> object that is returned when the operation started.</returns>
350 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
351 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling <see cref="System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)"></see><paramref name="e.">e.</paramref></exception>
352 <exception cref="T:System.InvalidOperationException">This method was already called for the operation identified by <paramref name="asyncResult">asyncResult</paramref>.</exception>
354 <member name="M:System.Net.HttpListenerRequest.GetClientCertificate">
355 <summary>Retrieves the client&#39;s X.509 v.3 certificate.</summary>
356 <returns>A <see cref="System.Security.Cryptography.X509Certificates"></see> object that contains the client&#39;s X.509 v.3 certificate.</returns>
357 <exception cref="T:System.InvalidOperationException">A call to this method to retrieve the client&#39;s X.509 v.3 certificate is in progress and therefore another call to this method cannot be made.</exception>
359 <member name="M:System.Net.HttpListenerRequest.GetClientCertificateAsync">
360 <summary>Retrieves the client&#39;s X.509 v.3 certificate as an asynchronous operation.</summary>
361 <returns>Returns <see cref="System.Threading.Tasks.Task`1"></see>.
362 The task object representing the asynchronous operation. The <see cref="System.Threading.Tasks.Task`1.Result"></see> property on the task object returns a <see cref="System.Security.Cryptography.X509Certificates"></see> object that contains the client&#39;s X.509 v.3 certificate.</returns>
364 <member name="P:System.Net.HttpListenerRequest.HasEntityBody">
365 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the request has associated body data.</summary>
366 <returns>true if the request has associated body data; otherwise, false.</returns>
368 <member name="P:System.Net.HttpListenerRequest.Headers">
369 <summary>Gets the collection of header name/value pairs sent in the request.</summary>
370 <returns>A <see cref="System.Net.WebHeaderCollection"></see> that contains the HTTP headers included in the request.</returns>
372 <member name="P:System.Net.HttpListenerRequest.HttpMethod">
373 <summary>Gets the HTTP method specified by the client.</summary>
374 <returns>A <see cref="System.String"></see> that contains the method used in the request.</returns>
376 <member name="P:System.Net.HttpListenerRequest.InputStream">
377 <summary>Gets a stream that contains the body data sent by the client.</summary>
378 <returns>A readable <see cref="System.IO.Stream"></see> object that contains the bytes sent by the client in the body of the request. This property returns <see cref="System.IO.Stream.Null"></see> if no data is sent with the request.</returns>
380 <member name="P:System.Net.HttpListenerRequest.IsAuthenticated">
381 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the client sending this request is authenticated.</summary>
382 <returns>true if the client was authenticated; otherwise, false.</returns>
384 <member name="P:System.Net.HttpListenerRequest.IsLocal">
385 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the request is sent from the local computer.</summary>
386 <returns>true if the request originated on the same computer as the <see cref="System.Net.HttpListener"></see> object that provided the request; otherwise, false.</returns>
388 <member name="P:System.Net.HttpListenerRequest.IsSecureConnection">
389 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the TCP connection used to send the request is using the Secure Sockets Layer (SSL) protocol.</summary>
390 <returns>true if the TCP connection is using SSL; otherwise, false.</returns>
392 <member name="P:System.Net.HttpListenerRequest.IsWebSocketRequest">
393 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the TCP connection was a WebSocket request.</summary>
394 <returns>Returns <see cref="System.Boolean"></see>.
395 true if the TCP connection is a WebSocket request; otherwise, false.</returns>
397 <member name="P:System.Net.HttpListenerRequest.KeepAlive">
398 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the client requests a persistent connection.</summary>
399 <returns>true if the connection should be kept open; otherwise, false.</returns>
401 <member name="P:System.Net.HttpListenerRequest.LocalEndPoint">
402 <summary>Get the server IP address and port number to which the request is directed.</summary>
403 <returns>An <see cref="System.Net.IPEndPoint"></see> that represents the IP address that the request is sent to.</returns>
405 <member name="P:System.Net.HttpListenerRequest.ProtocolVersion">
406 <summary>Gets the HTTP version used by the requesting client.</summary>
407 <returns>A <see cref="System.Version"></see> that identifies the client&#39;s version of HTTP.</returns>
409 <member name="P:System.Net.HttpListenerRequest.QueryString">
410 <summary>Gets the query string included in the request.</summary>
411 <returns>A <see cref="System.Collections.Specialized.NameValueCollection"></see> object that contains the query data included in the request <see cref="System.Net.HttpListenerRequest.Url"></see>.</returns>
413 <member name="P:System.Net.HttpListenerRequest.RawUrl">
414 <summary>Gets the URL information (without the host and port) requested by the client.</summary>
415 <returns>A <see cref="System.String"></see> that contains the raw URL for this request.</returns>
417 <member name="P:System.Net.HttpListenerRequest.RemoteEndPoint">
418 <summary>Gets the client IP address and port number from which the request originated.</summary>
419 <returns>An <see cref="System.Net.IPEndPoint"></see> that represents the IP address and port number from which the request originated.</returns>
421 <member name="P:System.Net.HttpListenerRequest.RequestTraceIdentifier">
422 <summary>Gets the request identifier of the incoming HTTP request.</summary>
423 <returns>A <see cref="System.Guid"></see> object that contains the identifier of the HTTP request.</returns>
425 <member name="P:System.Net.HttpListenerRequest.ServiceName">
426 <summary>Gets the Service Provider Name (SPN) that the client sent on the request.</summary>
427 <returns>A <see cref="System.String"></see> that contains the SPN the client sent on the request.</returns>
429 <member name="P:System.Net.HttpListenerRequest.TransportContext">
430 <summary>Gets the <see cref="T:System.Net.TransportContext"></see> for the client request.</summary>
431 <returns>A <see cref="System.Net.TransportContext"></see> object for the client request.</returns>
433 <member name="P:System.Net.HttpListenerRequest.Url">
434 <summary>Gets the <see cref="T:System.Uri"></see> object requested by the client.</summary>
435 <returns>A <see cref="System.Uri"></see> object that identifies the resource requested by the client.</returns>
437 <member name="P:System.Net.HttpListenerRequest.UrlReferrer">
438 <summary>Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.</summary>
439 <returns>A <see cref="System.Uri"></see> object that contains the text of the request&#39;s <see cref="System.Net.HttpRequestHeader.Referer"></see> header, or null if the header was not included in the request.</returns>
441 <member name="P:System.Net.HttpListenerRequest.UserAgent">
442 <summary>Gets the user agent presented by the client.</summary>
443 <returns>A <see cref="System.String"></see> object that contains the text of the request&#39;s User-Agent header.</returns>
445 <member name="P:System.Net.HttpListenerRequest.UserHostAddress">
446 <summary>Gets the server IP address and port number to which the request is directed.</summary>
447 <returns>A <see cref="System.String"></see> that contains the host address information.</returns>
449 <member name="P:System.Net.HttpListenerRequest.UserHostName">
450 <summary>Gets the DNS name and, if provided, the port number specified by the client.</summary>
451 <returns>A <see cref="System.String"></see> value that contains the text of the request&#39;s Host header.</returns>
453 <member name="P:System.Net.HttpListenerRequest.UserLanguages">
454 <summary>Gets the natural languages that are preferred for the response.</summary>
455 <returns>A <see cref="System.String"></see> array that contains the languages specified in the request&#39;s <see cref="System.Net.HttpRequestHeader.AcceptLanguage"></see> header or null if the client request did not include an <see cref="System.Net.HttpRequestHeader.AcceptLanguage"></see> header.</returns>
457 <member name="T:System.Net.HttpListenerResponse">
458 <summary>Represents a response to a request being handled by an <see cref="T:System.Net.HttpListener"></see> object.</summary>
460 <member name="M:System.Net.HttpListenerResponse.Abort">
461 <summary>Closes the connection to the client without sending a response.</summary>
463 <member name="M:System.Net.HttpListenerResponse.AddHeader(System.String,System.String)">
464 <summary>Adds the specified header and value to the HTTP headers for this response.</summary>
465 <param name="name">The name of the HTTP header to set.</param>
466 <param name="value">The value for the name header.</param>
467 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is null or an empty string (&quot;&quot;).</exception>
468 <exception cref="T:System.ArgumentException">You are not allowed to specify a value for the specified header.
470 <paramref name="name">name</paramref> or <paramref name="value">value</paramref> contains invalid characters.</exception>
471 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value">value</paramref> is greater than 65,535 characters.</exception>
473 <member name="M:System.Net.HttpListenerResponse.AppendCookie(System.Net.Cookie)">
474 <summary>Adds the specified <see cref="T:System.Net.Cookie"></see> to the collection of cookies for this response.</summary>
475 <param name="cookie">The <see cref="T:System.Net.Cookie"></see> to add to the collection to be sent with this response.</param>
476 <exception cref="T:System.ArgumentNullException"><paramref name="cookie">cookie</paramref> is null.</exception>
478 <member name="M:System.Net.HttpListenerResponse.AppendHeader(System.String,System.String)">
479 <summary>Appends a value to the specified HTTP header to be sent with this response.</summary>
480 <param name="name">The name of the HTTP header to append value to.</param>
481 <param name="value">The value to append to the name header.</param>
482 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is null or an empty string (&quot;&quot;).
484 You are not allowed to specify a value for the specified header.
486 <paramref name="name">name</paramref> or <paramref name="value">value</paramref> contains invalid characters.</exception>
487 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value">value</paramref> is greater than 65,535 characters.</exception>
489 <member name="M:System.Net.HttpListenerResponse.Close">
490 <summary>Sends the response to the client and releases the resources held by this <see cref="T:System.Net.HttpListenerResponse"></see> instance.</summary>
492 <member name="M:System.Net.HttpListenerResponse.Close(System.Byte[],System.Boolean)">
493 <summary>Returns the specified byte array to the client and releases the resources held by this <see cref="T:System.Net.HttpListenerResponse"></see> instance.</summary>
494 <param name="responseEntity">A <see cref="T:System.Byte"></see> array that contains the response to send to the client.</param>
495 <param name="willBlock">true to block execution while flushing the stream to the client; otherwise, false.</param>
496 <exception cref="T:System.ArgumentNullException"><paramref name="responseEntity">responseEntity</paramref> is null.</exception>
497 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
499 <member name="P:System.Net.HttpListenerResponse.ContentEncoding">
500 <summary>Gets or sets the <see cref="T:System.Text.Encoding"></see> for this response&#39;s <see cref="P:System.Net.HttpListenerResponse.OutputStream"></see>.</summary>
501 <returns>An <see cref="System.Text.Encoding"></see> object suitable for use with the data in the <see cref="System.Net.HttpListenerResponse.OutputStream"></see> property, or null if no encoding is specified.</returns>
503 <member name="P:System.Net.HttpListenerResponse.ContentLength64">
504 <summary>Gets or sets the number of bytes in the body data included in the response.</summary>
505 <returns>The value of the response&#39;s Content-Length header.</returns>
506 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than zero.</exception>
507 <exception cref="T:System.InvalidOperationException">The response is already being sent.</exception>
508 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
510 <member name="P:System.Net.HttpListenerResponse.ContentType">
511 <summary>Gets or sets the MIME type of the content returned.</summary>
512 <returns>A <see cref="System.String"></see> instance that contains the text of the response&#39;s Content-Type header.</returns>
513 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is null.</exception>
514 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string (&quot;&quot;).</exception>
515 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
517 <member name="P:System.Net.HttpListenerResponse.Cookies">
518 <summary>Gets or sets the collection of cookies returned with the response.</summary>
519 <returns>A <see cref="System.Net.CookieCollection"></see> that contains cookies to accompany the response. The collection is empty if no cookies have been added to the response.</returns>
521 <member name="M:System.Net.HttpListenerResponse.CopyFrom(System.Net.HttpListenerResponse)">
522 <summary>Copies properties from the specified <see cref="T:System.Net.HttpListenerResponse"></see> to this response.</summary>
523 <param name="templateResponse">The <see cref="T:System.Net.HttpListenerResponse"></see> instance to copy.</param>
525 <member name="P:System.Net.HttpListenerResponse.Headers">
526 <summary>Gets or sets the collection of header name/value pairs returned by the server.</summary>
527 <returns>A <see cref="System.Net.WebHeaderCollection"></see> instance that contains all the explicitly set HTTP headers to be included in the response.</returns>
528 <exception cref="T:System.InvalidOperationException">The <see cref="System.Net.WebHeaderCollection"></see> instance specified for a set operation is not valid for a response.</exception>
530 <member name="P:System.Net.HttpListenerResponse.KeepAlive">
531 <summary>Gets or sets a value indicating whether the server requests a persistent connection.</summary>
532 <returns>true if the server requests a persistent connection; otherwise, false. The default is true.</returns>
533 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
535 <member name="P:System.Net.HttpListenerResponse.OutputStream">
536 <summary>Gets a <see cref="T:System.IO.Stream"></see> object to which a response can be written.</summary>
537 <returns>A <see cref="System.IO.Stream"></see> object to which a response can be written.</returns>
538 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
540 <member name="P:System.Net.HttpListenerResponse.ProtocolVersion">
541 <summary>Gets or sets the HTTP version used for the response.</summary>
542 <returns>A <see cref="System.Version"></see> object indicating the version of HTTP used when responding to the client. Note that this property is now obsolete.</returns>
543 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is null.</exception>
544 <exception cref="T:System.ArgumentException">The value specified for a set operation does not have its <see cref="System.Version.Major"></see> property set to 1 or does not have its <see cref="System.Version.Minor"></see> property set to either 0 or 1.</exception>
545 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
547 <member name="M:System.Net.HttpListenerResponse.Redirect(System.String)">
548 <summary>Configures the response to redirect the client to the specified URL.</summary>
549 <param name="url">The URL that the client should use to locate the requested resource.</param>
551 <member name="P:System.Net.HttpListenerResponse.RedirectLocation">
552 <summary>Gets or sets the value of the HTTP Location header in this response.</summary>
553 <returns>A <see cref="System.String"></see> that contains the absolute URL to be sent to the client in the Location header.</returns>
554 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string (&quot;&quot;).</exception>
555 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
557 <member name="P:System.Net.HttpListenerResponse.SendChunked">
558 <summary>Gets or sets whether the response uses chunked transfer encoding.</summary>
559 <returns>true if the response is set to use chunked transfer encoding; otherwise, false. The default is false.</returns>
561 <member name="M:System.Net.HttpListenerResponse.SetCookie(System.Net.Cookie)">
562 <summary>Adds or updates a <see cref="T:System.Net.Cookie"></see> in the collection of cookies sent with this response.</summary>
563 <param name="cookie">A <see cref="T:System.Net.Cookie"></see> for this response.</param>
564 <exception cref="T:System.ArgumentNullException"><paramref name="cookie">cookie</paramref> is null.</exception>
565 <exception cref="T:System.ArgumentException">The cookie already exists in the collection and could not be replaced.</exception>
567 <member name="P:System.Net.HttpListenerResponse.StatusCode">
568 <summary>Gets or sets the HTTP status code to be returned to the client.</summary>
569 <returns>An <see cref="System.Int32"></see> value that specifies the HTTP status code for the requested resource. The default is <see cref="System.Net.HttpStatusCode.OK"></see>, indicating that the server successfully processed the client&#39;s request and included the requested resource in the response body.</returns>
570 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
571 <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>
573 <member name="P:System.Net.HttpListenerResponse.StatusDescription">
574 <summary>Gets or sets a text description of the HTTP status code returned to the client.</summary>
575 <returns>The text description of the HTTP status code returned to the client. The default is the RFC 2616 description for the <see cref="System.Net.HttpListenerResponse.StatusCode"></see> property value, or an empty string (&quot;&quot;) if an RFC 2616 description does not exist.</returns>
576 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is null.</exception>
577 <exception cref="T:System.ArgumentException">The value specified for a set operation contains non-printable characters.</exception>
579 <member name="M:System.Net.HttpListenerResponse.System#IDisposable#Dispose">
580 <summary>Releases all resources used by the <see cref="T:System.Net.HttpListenerResponse"></see>.</summary>
582 <member name="T:System.Net.HttpListenerTimeoutManager">
583 <summary>The timeout manager to use for an <see cref="T:System.Net.HttpListener"></see> object.</summary>
585 <member name="P:System.Net.HttpListenerTimeoutManager.DrainEntityBody">
586 <summary>Gets or sets the time, in seconds, allowed for the <see cref="T:System.Net.HttpListener"></see> to drain the entity body on a Keep-Alive connection.</summary>
587 <returns>Returns <see cref="System.TimeSpan"></see>.
588 The time, in seconds, allowed for the <see cref="System.Net.HttpListener"></see> to drain the entity body on a Keep-Alive connection.</returns>
590 <member name="P:System.Net.HttpListenerTimeoutManager.EntityBody">
591 <summary>Gets or sets the time, in seconds, allowed for the request entity body to arrive.</summary>
592 <returns>Returns <see cref="System.TimeSpan"></see>.
593 The time, in seconds, allowed for the request entity body to arrive.</returns>
595 <member name="P:System.Net.HttpListenerTimeoutManager.HeaderWait">
596 <summary>Gets or sets the time, in seconds, allowed for the <see cref="T:System.Net.HttpListener"></see> to parse the request header.</summary>
597 <returns>Returns <see cref="System.TimeSpan"></see>.
598 The time, in seconds, allowed for the <see cref="System.Net.HttpListener"></see> to parse the request header.</returns>
600 <member name="P:System.Net.HttpListenerTimeoutManager.IdleConnection">
601 <summary>Gets or sets the time, in seconds, allowed for an idle connection.</summary>
602 <returns>Returns <see cref="System.TimeSpan"></see>.
603 The time, in seconds, allowed for an idle connection.</returns>
605 <member name="P:System.Net.HttpListenerTimeoutManager.MinSendBytesPerSecond">
606 <summary>Gets or sets the minimum send rate, in bytes-per-second, for the response.</summary>
607 <returns>Returns <see cref="System.Int64"></see>.
608 The minimum send rate, in bytes-per-second, for the response.</returns>
610 <member name="P:System.Net.HttpListenerTimeoutManager.RequestQueue">
611 <summary>Gets or sets the time, in seconds, allowed for the request to remain in the request queue before the <see cref="T:System.Net.HttpListener"></see> picks it up.</summary>
612 <returns>Returns <see cref="System.TimeSpan"></see>.
613 The time, in seconds, allowed for the request to remain in the request queue before the <see cref="System.Net.HttpListener"></see> picks it up.</returns>
615 <member name="T:System.Net.AuthenticationSchemeSelector">
616 <summary>Selects the authentication scheme for an <see cref="T:System.Net.HttpListener"></see> instance.</summary>
617 <param name="httpRequest">The <see cref="T:System.Net.HttpListenerRequest"></see> instance for which to select an authentication scheme.</param>
618 <returns>One of the <see cref="System.Net.AuthenticationSchemes"></see> values that indicates the method of authentication to use for the specified client request.</returns>
620 <member name="T:System.Net.WebSockets.HttpListenerWebSocketContext">
621 <summary>Provides access to information received by the <see cref="T:System.Net.HttpListener"></see> class when accepting WebSocket connections.</summary>
623 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.CookieCollection">
624 <summary>Gets the cookies received by the <see cref="T:System.Net.HttpListener"></see> object in the WebSocket opening handshake.</summary>
625 <returns>Returns <see cref="System.Net.CookieCollection"></see>.
626 The cookies received by the <see cref="System.Net.HttpListener"></see> object.</returns>
628 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Headers">
629 <summary>Gets the HTTP headers received by the <see cref="T:System.Net.HttpListener"></see> object in the WebSocket opening handshake.</summary>
630 <returns>Returns <see cref="System.Collections.Specialized.NameValueCollection"></see>.
631 The HTTP headers received by the <see cref="System.Net.HttpListener"></see> object.</returns>
633 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsAuthenticated">
634 <summary>Gets a value that indicates if the WebSocket client is authenticated.</summary>
635 <returns>Returns <see cref="System.Boolean"></see>.
636 true if the WebSocket client is authenticated; otherwise false.</returns>
638 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsLocal">
639 <summary>Gets a value that indicates if the WebSocket client connected from the local machine.</summary>
640 <returns>Returns <see cref="System.Boolean"></see>.
641 true if the WebSocket client connected from the local machine; otherwise false.</returns>
643 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsSecureConnection">
644 <summary>Gets a value that indicates if the WebSocket connection is secured using Secure Sockets Layer (SSL).</summary>
645 <returns>Returns <see cref="System.Boolean"></see>.
646 true if the WebSocket connection is secured using SSL; otherwise false.</returns>
648 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Origin">
649 <summary>Gets the value of the Origin HTTP header included in the WebSocket opening handshake.</summary>
650 <returns>Returns <see cref="System.String"></see>.
651 The value of the Origin HTTP header.</returns>
653 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.RequestUri">
654 <summary>Gets the URI requested by the WebSocket client.</summary>
655 <returns>Returns <see cref="System.Uri"></see>.
656 The URI requested by the WebSocket client.</returns>
658 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketKey">
659 <summary>Gets the value of the SecWebSocketKey HTTP header included in the WebSocket opening handshake.</summary>
660 <returns>Returns <see cref="System.String"></see>.
661 The value of the SecWebSocketKey HTTP header.</returns>
663 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketProtocols">
664 <summary>Gets the list of the Secure WebSocket protocols included in the WebSocket opening handshake.</summary>
665 <returns>Returns <see cref="System.Collections.Generic.IEnumerable`1"></see>.
666 The list of the Secure WebSocket protocols.</returns>
668 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketVersion">
669 <summary>Gets the list of sub-protocols requested by the WebSocket client.</summary>
670 <returns>Returns <see cref="System.String"></see>.
671 The list of sub-protocols requested by the WebSocket client.</returns>
673 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.User">
674 <summary>Gets an object used to obtain identity, authentication information, and security roles for the WebSocket client.</summary>
675 <returns>Returns <see cref="System.Security.Principal.IPrincipal"></see>.
676 The identity, authentication information, and security roles for the WebSocket client.</returns>
678 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.WebSocket">
679 <summary>Gets the WebSocket instance used to send and receive data over the WebSocket connection.</summary>
680 <returns>Returns <see cref="System.Net.WebSockets.WebSocket"></see>.
681 The WebSocket instance.</returns>