1 <?xml version="1.0" encoding="utf-8"?><span>
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"></see> instance.</summary>
9 <param name="httpRequest">The <see cref="T:System.Net.HttpListenerRequest"></see> instance for which to select an authentication scheme.</param>
12 <member name="T:System.Net.HttpListener.ExtendedProtectionSelector">
13 <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>
14 <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>
17 <member name="T:System.Net.HttpListener">
18 <summary>Provides a simple, programmatically controlled HTTP protocol listener. This class cannot be inherited.</summary>
20 <member name="M:System.Net.HttpListener.#ctor">
21 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListener"></see> class.</summary>
22 <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>
24 <member name="M:System.Net.HttpListener.Abort">
25 <summary>Shuts down the <see cref="T:System.Net.HttpListener"></see> object immediately, discarding all currently queued requests.</summary>
27 <member name="P:System.Net.HttpListener.AuthenticationSchemes">
28 <summary>Gets or sets the scheme used to authenticate clients.</summary>
29 <returns>A bitwise combination of <see cref="T:System.Net.AuthenticationSchemes"></see> enumeration values that indicates how clients are to be authenticated. The default value is <see cref="F:System.Net.AuthenticationSchemes.Anonymous"></see>.</returns>
30 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
32 <member name="P:System.Net.HttpListener.AuthenticationSchemeSelectorDelegate">
33 <summary>Gets or sets the delegate called to determine the protocol used to authenticate clients.</summary>
34 <returns>An <see cref="T:System.Net.AuthenticationSchemeSelector"></see> delegate that invokes the method used to select an authentication protocol. The default value is null.</returns>
35 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
37 <member name="M:System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)">
38 <summary>Begins asynchronously retrieving an incoming request.</summary>
39 <param name="callback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when a client request is available.</param>
40 <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>
41 <returns>An <see cref="T:System.IAsyncResult"></see> object that indicates the status of the asynchronous operation.</returns>
42 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
43 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped.</exception>
44 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
46 <member name="M:System.Net.HttpListener.Close">
47 <summary>Shuts down the <see cref="T:System.Net.HttpListener"></see>.</summary>
49 <member name="P:System.Net.HttpListener.DefaultServiceNames">
50 <summary>Gets a default list of Service Provider Names (SPNs) as determined by registered prefixes.</summary>
51 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ServiceNameCollection"></see> that contains a list of SPNs.</returns>
53 <member name="M:System.Net.HttpListener.EndGetContext(System.IAsyncResult)">
54 <summary>Completes an asynchronous operation to retrieve an incoming client request.</summary>
55 <param name="asyncResult">An <see cref="T:System.IAsyncResult"></see> object that was obtained when the asynchronous operation was started.</param>
56 <returns>An <see cref="T:System.Net.HttpListenerContext"></see> object that represents the client request.</returns>
57 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling the <see cref="M:System.Net.HttpListener.BeginGetContext(System.AsyncCallback,System.Object)"></see> method.</exception>
58 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
59 <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Net.HttpListener.EndGetContext(System.IAsyncResult)"></see> method was already called for the specified <paramref name="asyncResult">asyncResult</paramref> object.</exception>
60 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
62 <member name="P:System.Net.HttpListener.ExtendedProtectionPolicy">
63 <summary>Get or set the <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> to use for extended protection for a session.</summary>
64 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that specifies the policy to use for extended protection.</returns>
65 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy"></see> property, but the <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> property was not null.</exception>
66 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy"></see> property to null.</exception>
67 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionPolicy"></see> property after the <see cref="M:System.Net.HttpListener.Start"></see> method was already called.</exception>
68 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
69 <exception cref="T:System.PlatformNotSupportedException">The <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.PolicyEnforcement"></see> property was set to <see cref="F:System.Security.Authentication.ExtendedProtection.PolicyEnforcement.Always"></see> on a platform that does not support extended protection.</exception>
71 <member name="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate">
72 <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>
73 <returns>A <see cref="T:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy"></see> that specifies the policy to use for extended protection.</returns>
74 <exception cref="T:System.ArgumentException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property, but the <see cref="P:System.Security.Authentication.ExtendedProtection.ExtendedProtectionPolicy.CustomChannelBinding"></see> property must be null.</exception>
75 <exception cref="T:System.ArgumentNullException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property to null.</exception>
76 <exception cref="T:System.InvalidOperationException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property after the <see cref="M:System.Net.HttpListener.Start"></see> method was already called.</exception>
77 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
78 <exception cref="T:System.PlatformNotSupportedException">An attempt was made to set the <see cref="P:System.Net.HttpListener.ExtendedProtectionSelectorDelegate"></see> property on a platform that does not support extended protection.</exception>
80 <member name="M:System.Net.HttpListener.GetContext">
81 <summary>Waits for an incoming request and returns when one is received.</summary>
82 <returns>An <see cref="T:System.Net.HttpListenerContext"></see> object that represents a client request.</returns>
83 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
84 <exception cref="T:System.InvalidOperationException">This object has not been started or is currently stopped. -or- The <see cref="T:System.Net.HttpListener"></see> does not have any Uniform Resource Identifier (URI) prefixes to respond to.</exception>
85 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
87 <member name="M:System.Net.HttpListener.GetContextAsync">
88 <summary>Waits for an incoming request as an asynchronous operation.</summary>
89 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="T:System.Net.HttpListenerContext"></see> object that represents a client request.</returns>
91 <member name="P:System.Net.HttpListener.IgnoreWriteExceptions">
92 <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>
93 <returns>true if this <see cref="T: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>
94 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
96 <member name="P:System.Net.HttpListener.IsListening">
97 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener"></see> has been started.</summary>
98 <returns>true if the <see cref="T:System.Net.HttpListener"></see> was started; otherwise, false.</returns>
100 <member name="P:System.Net.HttpListener.IsSupported">
101 <summary>Gets a value that indicates whether <see cref="T:System.Net.HttpListener"></see> can be used with the current operating system.</summary>
102 <returns>true if <see cref="T:System.Net.HttpListener"></see> is supported; otherwise, false.</returns>
104 <member name="P:System.Net.HttpListener.Prefixes">
105 <summary>Gets the Uniform Resource Identifier (URI) prefixes handled by this <see cref="T:System.Net.HttpListener"></see> object.</summary>
106 <returns>An <see cref="T:System.Net.HttpListenerPrefixCollection"></see> that contains the URI prefixes that this <see cref="T:System.Net.HttpListener"></see> object is configured to handle.</returns>
107 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
109 <member name="P:System.Net.HttpListener.Realm">
110 <summary>Gets or sets the realm, or resource partition, associated with this <see cref="T:System.Net.HttpListener"></see> object.</summary>
111 <returns>A <see cref="T:System.String"></see> value that contains the name of the realm associated with the <see cref="T:System.Net.HttpListener"></see> object.</returns>
112 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
114 <member name="M:System.Net.HttpListener.Start">
115 <summary>Allows this instance to receive incoming requests.</summary>
116 <exception cref="T:System.Net.HttpListenerException">A Win32 function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
117 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
119 <member name="M:System.Net.HttpListener.Stop">
120 <summary>Causes this instance to stop receiving incoming requests.</summary>
121 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
123 <member name="P:System.Net.HttpListener.TimeoutManager">
124 <summary>The timeout manager for this <see cref="T:System.Net.HttpListener"></see> instance.</summary>
125 <returns>Returns <see cref="T:System.Net.HttpListenerTimeoutManager"></see>. The timeout manager for this <see cref="T:System.Net.HttpListener"></see> instance.</returns>
127 <member name="P:System.Net.HttpListener.UnsafeConnectionNtlmAuthentication">
128 <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>
129 <returns>true if the <see cref="T: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>
130 <exception cref="T:System.ObjectDisposedException">This object has been closed.</exception>
132 <member name="M:System.Net.HttpListener.System#IDisposable#Dispose">
133 <summary>Releases the resources held by this <see cref="T:System.Net.HttpListener"></see> object.</summary>
135 <member name="T:System.Net.HttpListenerBasicIdentity">
136 <summary>Holds the user name and password from a basic authentication request.</summary>
138 <member name="M:System.Net.HttpListenerBasicIdentity.#ctor(System.String,System.String)">
139 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerBasicIdentity"></see> class using the specified user name and password.</summary>
140 <param name="username">The user name.</param>
141 <param name="password">The password.</param>
143 <member name="P:System.Net.HttpListenerBasicIdentity.Password">
144 <summary>Indicates the password from a basic authentication attempt.</summary>
145 <returns>A <see cref="T:System.String"></see> that holds the password.</returns>
147 <member name="T:System.Net.HttpListenerContext">
148 <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>
150 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String)">
151 <summary>Accept a WebSocket connection as an asynchronous operation.</summary>
152 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
153 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
154 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string -or- <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
155 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
157 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.TimeSpan)">
158 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol and WebSocket keep-alive interval as an asynchronous operation.</summary>
159 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
160 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
161 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
162 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string -or- <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
163 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small.</exception>
164 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
166 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.Int32,System.TimeSpan)">
167 <summary>Accept a WebSocket connection specifying the supported WebSocket sub-protocol, receive buffer size, and WebSocket keep-alive interval as an asynchronous operation.</summary>
168 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
169 <param name="receiveBufferSize">The receive buffer size in bytes.</param>
170 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
171 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
172 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string -or- <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
173 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small. -or- <paramref name="receiveBufferSize">receiveBufferSize</paramref> is less than 16 bytes -or- <paramref name="receiveBufferSize">receiveBufferSize</paramref> is greater than 64K bytes.</exception>
174 <exception cref="T:System.Net.WebSockets.WebSocketException">An error occurred when sending the response to complete the WebSocket handshake.</exception>
176 <member name="M:System.Net.HttpListenerContext.AcceptWebSocketAsync(System.String,System.Int32,System.TimeSpan,System.ArraySegment{System.Byte})">
177 <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>
178 <param name="subProtocol">The supported WebSocket sub-protocol.</param>
179 <param name="receiveBufferSize">The receive buffer size in bytes.</param>
180 <param name="keepAliveInterval">The WebSocket protocol keep-alive interval in milliseconds.</param>
181 <param name="internalBuffer">An internal buffer to use for this operation.</param>
182 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P:System.Threading.Tasks.Task`1.Result"></see> property on the task object returns an <see cref="T:System.Net.WebSockets.HttpListenerWebSocketContext"></see> object.</returns>
183 <exception cref="T:System.ArgumentException"><paramref name="subProtocol">subProtocol</paramref> is an empty string -or- <paramref name="subProtocol">subProtocol</paramref> contains illegal characters.</exception>
184 <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="keepAliveInterval">keepAliveInterval</paramref> is too small. -or- <paramref name="receiveBufferSize">receiveBufferSize</paramref> is less than 16 bytes -or- <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="P:System.Net.HttpListenerContext.Request">
188 <summary>Gets the <see cref="T:System.Net.HttpListenerRequest"></see> that represents a client's request for a resource.</summary>
189 <returns>An <see cref="T:System.Net.HttpListenerRequest"></see> object that represents the client request.</returns>
191 <member name="P:System.Net.HttpListenerContext.Response">
192 <summary>Gets the <see cref="T:System.Net.HttpListenerResponse"></see> object that will be sent to the client in response to the client's request.</summary>
193 <returns>An <see cref="T:System.Net.HttpListenerResponse"></see> object used to send a response back to the client.</returns>
195 <member name="P:System.Net.HttpListenerContext.User">
196 <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>
197 <returns>An <see cref="T:System.Security.Principal.IPrincipal"></see> object that describes the client, or null if the <see cref="T:System.Net.HttpListener"></see> that supplied this <see cref="T:System.Net.HttpListenerContext"></see> does not require authentication.</returns>
199 <member name="T:System.Net.HttpListenerException">
200 <summary>The exception that is thrown when an error occurs processing an HTTP request.</summary>
202 <member name="M:System.Net.HttpListenerException.#ctor">
203 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class.</summary>
205 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32)">
206 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class using the specified error code.</summary>
207 <param name="errorCode">A <see cref="T:System.Int32"></see> value that identifies the error that occurred.</param>
209 <member name="M:System.Net.HttpListenerException.#ctor(System.Int32,System.String)">
210 <summary>Initializes a new instance of the <see cref="T:System.Net.HttpListenerException"></see> class using the specified error code and message.</summary>
211 <param name="errorCode">A <see cref="T:System.Int32"></see> value that identifies the error that occurred.</param>
212 <param name="message">A <see cref="T:System.String"></see> that describes the error that occurred.</param>
214 <member name="M:System.Net.HttpListenerException.#ctor(System.Runtime.Serialization.SerializationInfo,System.Runtime.Serialization.StreamingContext)">
215 <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>
216 <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>
217 <param name="streamingContext">A <see cref="T:System.Runtime.Serialization.StreamingContext"></see> object.</param>
219 <member name="P:System.Net.HttpListenerException.ErrorCode">
220 <summary>Gets a value that identifies the error that occurred.</summary>
221 <returns>A <see cref="T:System.Int32"></see> value.</returns>
223 <member name="T:System.Net.HttpListenerPrefixCollection">
224 <summary>Represents the collection used to store Uniform Resource Identifier (URI) prefixes for <see cref="T:System.Net.HttpListener"></see> objects.</summary>
226 <member name="M:System.Net.HttpListenerPrefixCollection.Add(System.String)">
227 <summary>Adds a Uniform Resource Identifier (URI) prefix to the collection.</summary>
228 <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 ("/").</param>
229 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
230 <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="T:System.Net.HttpListener"></see> objects. -or- <paramref name="uriPrefix">uriPrefix</paramref> is not a correctly formatted URI prefix. Make sure the string is terminated with a "/".</exception>
231 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener"></see> associated with this collection is closed.</exception>
232 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception. This exception is thrown if another <see cref="T:System.Net.HttpListener"></see> has already added the prefix <paramref name="uriPrefix">uriPrefix</paramref>.</exception>
234 <member name="M:System.Net.HttpListenerPrefixCollection.Clear">
235 <summary>Removes all the Uniform Resource Identifier (URI) prefixes from the collection.</summary>
236 <exception cref="T:System.Net.HttpListenerException">A Windows function call failed. Check the exception's <see cref="P:System.Net.HttpListenerException.ErrorCode"></see> property to determine the cause of the exception.</exception>
237 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener"></see> associated with this collection is closed.</exception>
239 <member name="M:System.Net.HttpListenerPrefixCollection.Contains(System.String)">
240 <summary>Returns a <see cref="T:System.Boolean"></see> value that indicates whether the specified prefix is contained in the collection.</summary>
241 <param name="uriPrefix">A <see cref="T:System.String"></see> that contains the Uniform Resource Identifier (URI) prefix to test.</param>
242 <returns>true if this collection contains the prefix specified by <paramref name="uriPrefix">uriPrefix</paramref>; otherwise, false.</returns>
243 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
245 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.Array,System.Int32)">
246 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection"></see> to the specified array.</summary>
247 <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>
248 <param name="offset">The zero-based index in array at which copying begins.</param>
249 <exception cref="T:System.ArgumentException"><paramref name="array">array</paramref> has more than one dimension.</exception>
250 <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>
251 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener"></see> associated with this collection is closed.</exception>
252 <exception cref="T:System.InvalidCastException"><paramref name="array">array</paramref> cannot store string values.</exception>
254 <member name="M:System.Net.HttpListenerPrefixCollection.CopyTo(System.String[],System.Int32)">
255 <summary>Copies the contents of an <see cref="T:System.Net.HttpListenerPrefixCollection"></see> to the specified string array.</summary>
256 <param name="array">The one dimensional string array that receives the Uniform Resource Identifier (URI) prefix strings in this collection.</param>
257 <param name="offset">The zero-based index in array at which copying begins.</param>
258 <exception cref="T:System.ArgumentException"><paramref name="array">array</paramref> has more than one dimension.</exception>
259 <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>
260 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener"></see> associated with this collection is closed.</exception>
262 <member name="P:System.Net.HttpListenerPrefixCollection.Count">
263 <summary>Gets the number of prefixes contained in the collection.</summary>
264 <returns>An <see cref="T:System.Int32"></see> that contains the number of prefixes in this collection.</returns>
266 <member name="M:System.Net.HttpListenerPrefixCollection.GetEnumerator">
267 <summary>Returns an object that can be used to iterate through the collection.</summary>
268 <returns>An object that implements the <see cref="T:System.Collections.IEnumerator"></see> interface and provides access to the strings in this collection.</returns>
270 <member name="P:System.Net.HttpListenerPrefixCollection.IsReadOnly">
271 <summary>Gets a value that indicates whether access to the collection is read-only.</summary>
272 <returns>Always returns false.</returns>
274 <member name="P:System.Net.HttpListenerPrefixCollection.IsSynchronized">
275 <summary>Gets a value that indicates whether access to the collection is synchronized (thread-safe).</summary>
276 <returns>This property always returns false.</returns>
278 <member name="M:System.Net.HttpListenerPrefixCollection.Remove(System.String)">
279 <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>
280 <param name="uriPrefix">A <see cref="T:System.String"></see> that contains the URI prefix to remove.</param>
281 <returns>true if the <paramref name="uriPrefix">uriPrefix</paramref> was found in the <see cref="T:System.Net.HttpListenerPrefixCollection"></see> and removed; otherwise false.</returns>
282 <exception cref="T:System.ArgumentNullException"><paramref name="uriPrefix">uriPrefix</paramref> is null.</exception>
283 <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>
284 <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Net.HttpListener"></see> associated with this collection is closed.</exception>
286 <member name="M:System.Net.HttpListenerPrefixCollection.System#Collections#IEnumerable#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="T:System.Collections.IEnumerator"></see> interface and provides access to the strings in this collection.</returns>
290 <member name="T:System.Net.HttpListenerRequest">
291 <summary>Describes an incoming HTTP request to an <see cref="T:System.Net.HttpListener"></see> object. This class cannot be inherited.</summary>
293 <member name="P:System.Net.HttpListenerRequest.AcceptTypes">
294 <summary>Gets the MIME types accepted by the client.</summary>
295 <returns>A <see cref="T:System.String"></see> array that contains the type names specified in the request's Accept header or null if the client request did not include an Accept header.</returns>
297 <member name="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)">
298 <summary>Begins an asynchronous request for the client's X.509 v.3 certificate.</summary>
299 <param name="requestCallback">An <see cref="T:System.AsyncCallback"></see> delegate that references the method to invoke when the operation is complete.</param>
300 <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>
301 <returns>An <see cref="T:System.IAsyncResult"></see> that indicates the status of the operation.</returns>
303 <member name="P:System.Net.HttpListenerRequest.ClientCertificateError">
304 <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>
305 <returns>An <see cref="T:System.Int32"></see> value that contains a Windows error code.</returns>
306 <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)"></see> or <see cref="M:System.Net.HttpListenerRequest.GetClientCertificate"></see> methods -or - The operation is still in progress.</exception>
308 <member name="P:System.Net.HttpListenerRequest.ContentEncoding">
309 <summary>Gets the content encoding that can be used with data sent with the request</summary>
310 <returns>An <see cref="T:System.Text.Encoding"></see> object suitable for use with the data in the <see cref="P:System.Net.HttpListenerRequest.InputStream"></see> property.</returns>
312 <member name="P:System.Net.HttpListenerRequest.ContentLength64">
313 <summary>Gets the length of the body data included in the request.</summary>
314 <returns>The value from the request's Content-Length header. This value is -1 if the content length is not known.</returns>
316 <member name="P:System.Net.HttpListenerRequest.ContentType">
317 <summary>Gets the MIME type of the body data included in the request.</summary>
318 <returns>A <see cref="T:System.String"></see> that contains the text of the request's Content-Type header.</returns>
320 <member name="P:System.Net.HttpListenerRequest.Cookies">
321 <summary>Gets the cookies sent with the request.</summary>
322 <returns>A <see cref="T: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>
324 <member name="M:System.Net.HttpListenerRequest.EndGetClientCertificate(System.IAsyncResult)">
325 <summary>Ends an asynchronous request for the client's X.509 v.3 certificate.</summary>
326 <param name="asyncResult">The pending request for the certificate.</param>
327 <returns>The <see cref="T:System.IAsyncResult"></see> object that is returned when the operation started.</returns>
328 <exception cref="T:System.ArgumentNullException"><paramref name="asyncResult">asyncResult</paramref> is null.</exception>
329 <exception cref="T:System.ArgumentException"><paramref name="asyncResult">asyncResult</paramref> was not obtained by calling <see cref="M:System.Net.HttpListenerRequest.BeginGetClientCertificate(System.AsyncCallback,System.Object)"></see><paramref name="e.">e.</paramref></exception>
330 <exception cref="T:System.InvalidOperationException">This method was already called for the operation identified by <paramref name="asyncResult">asyncResult</paramref>.</exception>
332 <member name="M:System.Net.HttpListenerRequest.GetClientCertificate">
333 <summary>Retrieves the client's X.509 v.3 certificate.</summary>
334 <returns>A <see cref="System.Security.Cryptography.X509Certificates"></see> object that contains the client's X.509 v.3 certificate.</returns>
335 <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>
337 <member name="M:System.Net.HttpListenerRequest.GetClientCertificateAsync">
338 <summary>Retrieves the client's X.509 v.3 certificate as an asynchronous operation.</summary>
339 <returns>Returns <see cref="T:System.Threading.Tasks.Task`1"></see>. The task object representing the asynchronous operation. The <see cref="P: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's X.509 v.3 certificate.</returns>
341 <member name="P:System.Net.HttpListenerRequest.HasEntityBody">
342 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the request has associated body data.</summary>
343 <returns>true if the request has associated body data; otherwise, false.</returns>
345 <member name="P:System.Net.HttpListenerRequest.Headers">
346 <summary>Gets the collection of header name/value pairs sent in the request.</summary>
347 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> that contains the HTTP headers included in the request.</returns>
349 <member name="P:System.Net.HttpListenerRequest.HttpMethod">
350 <summary>Gets the HTTP method specified by the client.</summary>
351 <returns>A <see cref="T:System.String"></see> that contains the method used in the request.</returns>
353 <member name="P:System.Net.HttpListenerRequest.InputStream">
354 <summary>Gets a stream that contains the body data sent by the client.</summary>
355 <returns>A readable <see cref="T:System.IO.Stream"></see> 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"></see> if no data is sent with the request.</returns>
357 <member name="P:System.Net.HttpListenerRequest.IsAuthenticated">
358 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the client sending this request is authenticated.</summary>
359 <returns>true if the client was authenticated; otherwise, false.</returns>
361 <member name="P:System.Net.HttpListenerRequest.IsLocal">
362 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the request is sent from the local computer.</summary>
363 <returns>true if the request originated on the same computer as the <see cref="T:System.Net.HttpListener"></see> object that provided the request; otherwise, false.</returns>
365 <member name="P:System.Net.HttpListenerRequest.IsSecureConnection">
366 <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>
367 <returns>true if the TCP connection is using SSL; otherwise, false.</returns>
369 <member name="P:System.Net.HttpListenerRequest.IsWebSocketRequest">
370 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the TCP connection was a WebSocket request.</summary>
371 <returns>Returns <see cref="T:System.Boolean"></see>. true if the TCP connection is a WebSocket request; otherwise, false.</returns>
373 <member name="P:System.Net.HttpListenerRequest.KeepAlive">
374 <summary>Gets a <see cref="T:System.Boolean"></see> value that indicates whether the client requests a persistent connection.</summary>
375 <returns>true if the connection should be kept open; otherwise, false.</returns>
377 <member name="P:System.Net.HttpListenerRequest.LocalEndPoint">
378 <summary>Get the server IP address and port number to which the request is directed.</summary>
379 <returns>An <see cref="T:System.Net.IPEndPoint"></see> that represents the IP address that the request is sent to.</returns>
381 <member name="P:System.Net.HttpListenerRequest.ProtocolVersion">
382 <summary>Gets the HTTP version used by the requesting client.</summary>
383 <returns>A <see cref="T:System.Version"></see> that identifies the client's version of HTTP.</returns>
385 <member name="P:System.Net.HttpListenerRequest.QueryString">
386 <summary>Gets the query string included in the request.</summary>
387 <returns>A <see cref="T:System.Collections.Specialized.NameValueCollection"></see> object that contains the query data included in the request <see cref="P:System.Net.HttpListenerRequest.Url"></see>.</returns>
389 <member name="P:System.Net.HttpListenerRequest.RawUrl">
390 <summary>Gets the URL information (without the host and port) requested by the client.</summary>
391 <returns>A <see cref="T:System.String"></see> that contains the raw URL for this request.</returns>
393 <member name="P:System.Net.HttpListenerRequest.RemoteEndPoint">
394 <summary>Gets the client IP address and port number from which the request originated.</summary>
395 <returns>An <see cref="T:System.Net.IPEndPoint"></see> that represents the IP address and port number from which the request originated.</returns>
397 <member name="P:System.Net.HttpListenerRequest.RequestTraceIdentifier">
398 <summary>Gets the request identifier of the incoming HTTP request.</summary>
399 <returns>A <see cref="T:System.Guid"></see> object that contains the identifier of the HTTP request.</returns>
401 <member name="P:System.Net.HttpListenerRequest.ServiceName">
402 <summary>Gets the Service Provider Name (SPN) that the client sent on the request.</summary>
403 <returns>A <see cref="T:System.String"></see> that contains the SPN the client sent on the request.</returns>
405 <member name="P:System.Net.HttpListenerRequest.TransportContext">
406 <summary>Gets the <see cref="T:System.Net.TransportContext"></see> for the client request.</summary>
407 <returns>A <see cref="T:System.Net.TransportContext"></see> object for the client request.</returns>
409 <member name="P:System.Net.HttpListenerRequest.Url">
410 <summary>Gets the <see cref="T:System.Uri"></see> object requested by the client.</summary>
411 <returns>A <see cref="T:System.Uri"></see> object that identifies the resource requested by the client.</returns>
413 <member name="P:System.Net.HttpListenerRequest.UrlReferrer">
414 <summary>Gets the Uniform Resource Identifier (URI) of the resource that referred the client to the server.</summary>
415 <returns>A <see cref="T:System.Uri"></see> object that contains the text of the request's <see cref="F:System.Net.HttpRequestHeader.Referer"></see> header, or null if the header was not included in the request.</returns>
417 <member name="P:System.Net.HttpListenerRequest.UserAgent">
418 <summary>Gets the user agent presented by the client.</summary>
419 <returns>A <see cref="T:System.String"></see> object that contains the text of the request's User-Agent header.</returns>
421 <member name="P:System.Net.HttpListenerRequest.UserHostAddress">
422 <summary>Gets the server IP address and port number to which the request is directed.</summary>
423 <returns>A <see cref="T:System.String"></see> that contains the host address information.</returns>
425 <member name="P:System.Net.HttpListenerRequest.UserHostName">
426 <summary>Gets the DNS name and, if provided, the port number specified by the client.</summary>
427 <returns>A <see cref="T:System.String"></see> value that contains the text of the request's Host header.</returns>
429 <member name="P:System.Net.HttpListenerRequest.UserLanguages">
430 <summary>Gets the natural languages that are preferred for the response.</summary>
431 <returns>A <see cref="T:System.String"></see> array that contains the languages specified in the request's <see cref="F:System.Net.HttpRequestHeader.AcceptLanguage"></see> header or null if the client request did not include an <see cref="F:System.Net.HttpRequestHeader.AcceptLanguage"></see> header.</returns>
433 <member name="T:System.Net.HttpListenerResponse">
434 <summary>Represents a response to a request being handled by an <see cref="T:System.Net.HttpListener"></see> object.</summary>
436 <member name="M:System.Net.HttpListenerResponse.Abort">
437 <summary>Closes the connection to the client without sending a response.</summary>
439 <member name="M:System.Net.HttpListenerResponse.AddHeader(System.String,System.String)">
440 <summary>Adds the specified header and value to the HTTP headers for this response.</summary>
441 <param name="name">The name of the HTTP header to set.</param>
442 <param name="value">The value for the name header.</param>
443 <exception cref="T:System.ArgumentNullException"><paramref name="name">name</paramref> is null or an empty string ("").</exception>
444 <exception cref="T:System.ArgumentException">You are not allowed to specify a value for the specified header. -or- <paramref name="name">name</paramref> or <paramref name="value">value</paramref> contains invalid characters.</exception>
445 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value">value</paramref> is greater than 65,535 characters.</exception>
447 <member name="M:System.Net.HttpListenerResponse.AppendCookie(System.Net.Cookie)">
448 <summary>Adds the specified <see cref="T:System.Net.Cookie"></see> to the collection of cookies for this response.</summary>
449 <param name="cookie">The <see cref="T:System.Net.Cookie"></see> to add to the collection to be sent with this response.</param>
450 <exception cref="T:System.ArgumentNullException"><paramref name="cookie">cookie</paramref> is null.</exception>
452 <member name="M:System.Net.HttpListenerResponse.AppendHeader(System.String,System.String)">
453 <summary>Appends a value to the specified HTTP header to be sent with this response.</summary>
454 <param name="name">The name of the HTTP header to append value to.</param>
455 <param name="value">The value to append to the name header.</param>
456 <exception cref="T:System.ArgumentException"><paramref name="name">name</paramref> is null or an empty string (""). -or- You are not allowed to specify a value for the specified header. -or- <paramref name="name">name</paramref> or <paramref name="value">value</paramref> contains invalid characters.</exception>
457 <exception cref="T:System.ArgumentOutOfRangeException">The length of <paramref name="value">value</paramref> is greater than 65,535 characters.</exception>
459 <member name="M:System.Net.HttpListenerResponse.Close">
460 <summary>Sends the response to the client and releases the resources held by this <see cref="T:System.Net.HttpListenerResponse"></see> instance.</summary>
462 <member name="M:System.Net.HttpListenerResponse.Close(System.Byte[],System.Boolean)">
463 <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>
464 <param name="responseEntity">A <see cref="T:System.Byte"></see> array that contains the response to send to the client.</param>
465 <param name="willBlock">true to block execution while flushing the stream to the client; otherwise, false.</param>
466 <exception cref="T:System.ArgumentNullException"><paramref name="responseEntity">responseEntity</paramref> is null.</exception>
467 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
469 <member name="P:System.Net.HttpListenerResponse.ContentEncoding">
470 <summary>Gets or sets the <see cref="T:System.Text.Encoding"></see> for this response's <see cref="P:System.Net.HttpListenerResponse.OutputStream"></see>.</summary>
471 <returns>An <see cref="T:System.Text.Encoding"></see> object suitable for use with the data in the <see cref="P:System.Net.HttpListenerResponse.OutputStream"></see> property, or null if no encoding is specified.</returns>
473 <member name="P:System.Net.HttpListenerResponse.ContentLength64">
474 <summary>Gets or sets the number of bytes in the body data included in the response.</summary>
475 <returns>The value of the response's Content-Length header.</returns>
476 <exception cref="T:System.ArgumentOutOfRangeException">The value specified for a set operation is less than zero.</exception>
477 <exception cref="T:System.InvalidOperationException">The response is already being sent.</exception>
478 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
480 <member name="P:System.Net.HttpListenerResponse.ContentType">
481 <summary>Gets or sets the MIME type of the content returned.</summary>
482 <returns>A <see cref="T:System.String"></see> instance that contains the text of the response's Content-Type header.</returns>
483 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is null.</exception>
484 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string ("").</exception>
485 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
487 <member name="P:System.Net.HttpListenerResponse.Cookies">
488 <summary>Gets or sets the collection of cookies returned with the response.</summary>
489 <returns>A <see cref="T: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>
491 <member name="M:System.Net.HttpListenerResponse.CopyFrom(System.Net.HttpListenerResponse)">
492 <summary>Copies properties from the specified <see cref="T:System.Net.HttpListenerResponse"></see> to this response.</summary>
493 <param name="templateResponse">The <see cref="T:System.Net.HttpListenerResponse"></see> instance to copy.</param>
495 <member name="P:System.Net.HttpListenerResponse.Headers">
496 <summary>Gets or sets the collection of header name/value pairs returned by the server.</summary>
497 <returns>A <see cref="T:System.Net.WebHeaderCollection"></see> instance that contains all the explicitly set HTTP headers to be included in the response.</returns>
498 <exception cref="T:System.InvalidOperationException">The <see cref="T:System.Net.WebHeaderCollection"></see> instance specified for a set operation is not valid for a response.</exception>
500 <member name="P:System.Net.HttpListenerResponse.KeepAlive">
501 <summary>Gets or sets a value indicating whether the server requests a persistent connection.</summary>
502 <returns>true if the server requests a persistent connection; otherwise, false. The default is true.</returns>
503 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
505 <member name="P:System.Net.HttpListenerResponse.OutputStream">
506 <summary>Gets a <see cref="T:System.IO.Stream"></see> object to which a response can be written.</summary>
507 <returns>A <see cref="T:System.IO.Stream"></see> object to which a response can be written.</returns>
508 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
510 <member name="P:System.Net.HttpListenerResponse.ProtocolVersion">
511 <summary>Gets or sets the HTTP version used for the response.</summary>
512 <returns>A <see cref="T:System.Version"></see> object indicating the version of HTTP used when responding to the client. Note that this property is now obsolete.</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 does not have its <see cref="P:System.Version.Major"></see> property set to 1 or does not have its <see cref="P:System.Version.Minor"></see> property set to either 0 or 1.</exception>
515 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
517 <member name="M:System.Net.HttpListenerResponse.Redirect(System.String)">
518 <summary>Configures the response to redirect the client to the specified URL.</summary>
519 <param name="url">The URL that the client should use to locate the requested resource.</param>
521 <member name="P:System.Net.HttpListenerResponse.RedirectLocation">
522 <summary>Gets or sets the value of the HTTP Location header in this response.</summary>
523 <returns>A <see cref="T:System.String"></see> that contains the absolute URL to be sent to the client in the Location header.</returns>
524 <exception cref="T:System.ArgumentException">The value specified for a set operation is an empty string ("").</exception>
525 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
527 <member name="P:System.Net.HttpListenerResponse.SendChunked">
528 <summary>Gets or sets whether the response uses chunked transfer encoding.</summary>
529 <returns>true if the response is set to use chunked transfer encoding; otherwise, false. The default is false.</returns>
531 <member name="M:System.Net.HttpListenerResponse.SetCookie(System.Net.Cookie)">
532 <summary>Adds or updates a <see cref="T:System.Net.Cookie"></see> in the collection of cookies sent with this response.</summary>
533 <param name="cookie">A <see cref="T:System.Net.Cookie"></see> for this response.</param>
534 <exception cref="T:System.ArgumentNullException"><paramref name="cookie">cookie</paramref> is null.</exception>
535 <exception cref="T:System.ArgumentException">The cookie already exists in the collection and could not be replaced.</exception>
537 <member name="P:System.Net.HttpListenerResponse.StatusCode">
538 <summary>Gets or sets the HTTP status code to be returned to the client.</summary>
539 <returns>An <see cref="T:System.Int32"></see> value that specifies the HTTP status code for the requested resource. The default is <see cref="F:System.Net.HttpStatusCode.OK"></see>, indicating that the server successfully processed the client's request and included the requested resource in the response body.</returns>
540 <exception cref="T:System.ObjectDisposedException">This object is closed.</exception>
541 <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>
543 <member name="P:System.Net.HttpListenerResponse.StatusDescription">
544 <summary>Gets or sets a text description of the HTTP status code returned to the client.</summary>
545 <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"></see> property value, or an empty string ("") if an RFC 2616 description does not exist.</returns>
546 <exception cref="T:System.ArgumentNullException">The value specified for a set operation is null.</exception>
547 <exception cref="T:System.ArgumentException">The value specified for a set operation contains non-printable characters.</exception>
549 <member name="M:System.Net.HttpListenerResponse.System#IDisposable#Dispose">
550 <summary>Releases all resources used by the <see cref="T:System.Net.HttpListenerResponse"></see>.</summary>
552 <member name="T:System.Net.HttpListenerTimeoutManager">
553 <summary>The timeout manager to use for an <see cref="T:System.Net.HttpListener"></see> object.</summary>
555 <member name="P:System.Net.HttpListenerTimeoutManager.DrainEntityBody">
556 <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>
557 <returns>Returns <see cref="T:System.TimeSpan"></see>. The time, in seconds, allowed for the <see cref="T:System.Net.HttpListener"></see> to drain the entity body on a Keep-Alive connection.</returns>
559 <member name="P:System.Net.HttpListenerTimeoutManager.EntityBody">
560 <summary>Gets or sets the time, in seconds, allowed for the request entity body to arrive.</summary>
561 <returns>Returns <see cref="T:System.TimeSpan"></see>. The time, in seconds, allowed for the request entity body to arrive.</returns>
563 <member name="P:System.Net.HttpListenerTimeoutManager.HeaderWait">
564 <summary>Gets or sets the time, in seconds, allowed for the <see cref="T:System.Net.HttpListener"></see> to parse the request header.</summary>
565 <returns>Returns <see cref="T:System.TimeSpan"></see>. The time, in seconds, allowed for the <see cref="T:System.Net.HttpListener"></see> to parse the request header.</returns>
567 <member name="P:System.Net.HttpListenerTimeoutManager.IdleConnection">
568 <summary>Gets or sets the time, in seconds, allowed for an idle connection.</summary>
569 <returns>Returns <see cref="T:System.TimeSpan"></see>. The time, in seconds, allowed for an idle connection.</returns>
571 <member name="P:System.Net.HttpListenerTimeoutManager.MinSendBytesPerSecond">
572 <summary>Gets or sets the minimum send rate, in bytes-per-second, for the response.</summary>
573 <returns>Returns <see cref="T:System.Int64"></see>. The minimum send rate, in bytes-per-second, for the response.</returns>
575 <member name="P:System.Net.HttpListenerTimeoutManager.RequestQueue">
576 <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>
577 <returns>Returns <see cref="T:System.TimeSpan"></see>. 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.</returns>
579 <member name="T:System.Net.WebSockets.HttpListenerWebSocketContext">
580 <summary>Provides access to information received by the <see cref="T:System.Net.HttpListener"></see> class when accepting WebSocket connections.</summary>
582 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.CookieCollection">
583 <summary>Gets the cookies received by the <see cref="T:System.Net.HttpListener"></see> object in the WebSocket opening handshake.</summary>
584 <returns>Returns <see cref="T:System.Net.CookieCollection"></see>. The cookies received by the <see cref="T:System.Net.HttpListener"></see> object.</returns>
586 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Headers">
587 <summary>Gets the HTTP headers received by the <see cref="T:System.Net.HttpListener"></see> object in the WebSocket opening handshake.</summary>
588 <returns>Returns <see cref="T:System.Collections.Specialized.NameValueCollection"></see>. The HTTP headers received by the <see cref="T:System.Net.HttpListener"></see> object.</returns>
590 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsAuthenticated">
591 <summary>Gets a value that indicates if the WebSocket client is authenticated.</summary>
592 <returns>Returns <see cref="T:System.Boolean"></see>. true if the WebSocket client is authenticated; otherwise false.</returns>
594 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsLocal">
595 <summary>Gets a value that indicates if the WebSocket client connected from the local machine.</summary>
596 <returns>Returns <see cref="T:System.Boolean"></see>. true if the WebSocket client connected from the local machine; otherwise false.</returns>
598 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.IsSecureConnection">
599 <summary>Gets a value that indicates if the WebSocket connection is secured using Secure Sockets Layer (SSL).</summary>
600 <returns>Returns <see cref="T:System.Boolean"></see>. true if the WebSocket connection is secured using SSL; otherwise false.</returns>
602 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.Origin">
603 <summary>Gets the value of the Origin HTTP header included in the WebSocket opening handshake.</summary>
604 <returns>Returns <see cref="T:System.String"></see>. The value of the Origin HTTP header.</returns>
606 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.RequestUri">
607 <summary>Gets the URI requested by the WebSocket client.</summary>
608 <returns>Returns <see cref="T:System.Uri"></see>. The URI requested by the WebSocket client.</returns>
610 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketKey">
611 <summary>Gets the value of the SecWebSocketKey HTTP header included in the WebSocket opening handshake.</summary>
612 <returns>Returns <see cref="T:System.String"></see>. The value of the SecWebSocketKey HTTP header.</returns>
614 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketProtocols">
615 <summary>Gets the list of the Secure WebSocket protocols included in the WebSocket opening handshake.</summary>
616 <returns>Returns <see cref="T:System.Collections.Generic.IEnumerable`1"></see>. The list of the Secure WebSocket protocols.</returns>
618 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.SecWebSocketVersion">
619 <summary>Gets the list of sub-protocols requested by the WebSocket client.</summary>
620 <returns>Returns <see cref="T:System.String"></see>. The list of sub-protocols requested by the WebSocket client.</returns>
622 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.User">
623 <summary>Gets an object used to obtain identity, authentication information, and security roles for the WebSocket client.</summary>
624 <returns>Returns <see cref="T:System.Security.Principal.IPrincipal"></see>. The identity, authentication information, and security roles for the WebSocket client.</returns>
626 <member name="P:System.Net.WebSockets.HttpListenerWebSocketContext.WebSocket">
627 <summary>Gets the WebSocket instance used to send and receive data over the WebSocket connection.</summary>
628 <returns>Returns <see cref="T:System.Net.WebSockets.WebSocket"></see>. The WebSocket instance.</returns>