diff --git a/xml/System.Net.Sockets/Socket.xml b/xml/System.Net.Sockets/Socket.xml index 7d5a45f4eb7..a62ccf7e4a8 100644 --- a/xml/System.Net.Sockets/Socket.xml +++ b/xml/System.Net.Sockets/Socket.xml @@ -444,6 +444,13 @@ This method populates the instance with data ga Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + + This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. + An error occurred when attempting to access the socket. + The has been closed. @@ -479,6 +486,13 @@ This method populates the instance with data ga Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + + This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. + An error occurred when attempting to access the socket. + The has been closed. @@ -563,7 +577,6 @@ This method populates the instance with data ga This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. An error occurred when attempting to access the socket. - Windows XP or later is required for this method. The has been closed. @@ -606,6 +619,13 @@ This method populates the instance with data ga Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + + This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. + An error occurred when attempting to access the socket. + The has been closed. @@ -643,6 +663,13 @@ This method populates the instance with data ga Accepts an incoming connection. An asynchronous task that completes with the accepted Socket. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + + This exception also occurs if the socket is already connected or a socket operation was already in progress using the specified parameter. + An error occurred when attempting to access the socket. + The has been closed. @@ -3859,6 +3886,12 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + The is listening. + An error occurred when attempting to access the socket. + The local endpoint and the parameter are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -3946,7 +3979,7 @@ This method populates the instance with data ga The parameter cannot be null and the cannot be null. The is listening or a socket operation was already in progress using the object specified in the parameter. An error occurred when attempting to access the socket. - Windows XP or later is required for this method. This exception also occurs if the local endpoint and the are not the same address family. + The local endpoint and the are not the same address family. The has been closed. A caller higher in the call stack does not have permission for the requested operation. @@ -3992,6 +4025,12 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + The is listening. + An error occurred when attempting to access the socket. + The local endpoint and the parameter are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4029,6 +4068,18 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + The socket is not in the or families. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4066,6 +4117,19 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + The parameter cannot be empty array. + + is less than . + + -or- + + is greater than . + The is listening. + The socket is not in the or families. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4103,6 +4167,18 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + The socket is not in the or families. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4142,6 +4218,17 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4181,6 +4268,19 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + The parameter cannot be empty array. + + is less than . + + -or- + + is greater than . + The is listening. + The socket is not in the or families. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4271,7 +4371,7 @@ This method populates the instance with data ga The parameter cannot be null and the cannot be null. The is listening or a socket operation was already in progress using the object specified in the parameter. An error occurred when attempting to access the socket. - Windows XP or later is required for this method. This exception also occurs if the local endpoint and the are not the same address family. + The local endpoint and the are not the same address family. The has been closed. A caller higher in the call stack does not have permission for the requested operation. @@ -4313,6 +4413,18 @@ This method populates the instance with data ga Establishes a connection to a remote host. An asynchronous task that completes when the connection is established. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + The socket is not in the or families. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -4504,7 +4616,6 @@ This method populates the instance with data ga The parameter cannot be null. A socket operation was already in progress using the object specified in the parameter. - Windows XP or later is required for this method. The has been closed. An error occurred when attempting to access the socket. @@ -4546,6 +4657,8 @@ This method populates the instance with data ga Disconnects a connected socket from the remote host. An asynchronous task that completes when the socket is disconnected. To be added. + The object has been closed. + An error occurred when attempting to access the socket. @@ -8585,6 +8698,8 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -8619,6 +8734,9 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The parameter was null. + The has been closed. + An error occurred when attempting to access the socket. @@ -8699,7 +8817,6 @@ If you're using a connectionless , An argument was invalid. The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. A socket operation was already in progress using the object specified in the parameter. - Windows XP or later is required for this method. The has been closed. An error occurred when attempting to access the socket. @@ -8746,6 +8863,8 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -8783,6 +8902,9 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The parameter was null. + The has been closed. + An error occurred when attempting to access the socket. @@ -8818,6 +8940,8 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -8856,6 +8980,8 @@ If you're using a connectionless , Receives data from a connected socket. An asynchronous task that completes with the number of bytes received. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -9540,7 +9666,6 @@ If you're using a connectionless , The cannot be null. A socket operation was already in progress using the object specified in the parameter. - Windows XP or later is required for this method. The has been closed. An error occurred when attempting to access the socket. @@ -9586,6 +9711,10 @@ If you're using a connectionless , Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. + A caller in the call stack does not have the required permissions. @@ -9625,6 +9754,10 @@ If you're using a connectionless , Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. + A caller in the call stack does not have the required permissions. @@ -9662,6 +9795,10 @@ If you're using a connectionless , Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. + A caller in the call stack does not have the required permissions. @@ -9702,6 +9839,10 @@ If you're using a connectionless , Receives data and returns the endpoint of the sending host. An asynchronous task that completes with a containing the number of bytes received and the endpoint of the sending host. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. + A caller in the call stack does not have the required permissions. @@ -9958,7 +10099,6 @@ You must call the Bind method before performing this operation. ]]> The cannot be null. - Windows XP or later is required for this method. The has been closed. An error occurred when attempting to access the socket. @@ -10004,6 +10144,9 @@ You must call the Bind method before performing this operation. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. To be added. + The object has been closed. + is . + You must call the Bind method before performing this operation. @@ -10043,6 +10186,9 @@ You must call the Bind method before performing this operation. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. To be added. + The object has been closed. + is . + You must call the Bind method before performing this operation. @@ -10080,6 +10226,9 @@ You must call the Bind method before performing this operation. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. To be added. + The object has been closed. + is . + You must call the Bind method before performing this operation. @@ -10120,6 +10269,9 @@ You must call the Bind method before performing this operation. Receives data and returns additional information about the sender of the message. An asynchronous task that completes with a containing the number of bytes received and additional information about the sending host. To be added. + The object has been closed. + is . + You must call the Bind method before performing this operation. @@ -11422,6 +11574,8 @@ This member outputs trace information when you enable network tracing in your ap Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. To be added. + An error occurred when attempting to access the socket. + The has been closed. @@ -11456,6 +11610,10 @@ This member outputs trace information when you enable network tracing in your ap Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. To be added. + + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -11536,7 +11694,6 @@ This member outputs trace information when you enable network tracing in your ap The or properties on the parameter must reference valid buffers. One or the other of these properties may be set, but not both at the same time. A socket operation was already in progress using the object specified in the parameter. - Windows XP or later is required for this method. The has been closed. The is not yet connected or was not obtained via an , ,or , method. @@ -11583,6 +11740,8 @@ This member outputs trace information when you enable network tracing in your ap Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. To be added. + An error occurred when attempting to access the socket. + The has been closed. @@ -11620,6 +11779,10 @@ This member outputs trace information when you enable network tracing in your ap Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. To be added. + + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -11693,6 +11856,8 @@ This member outputs trace information when you enable network tracing in your ap Sends data on a connected socket. An asynchronous task that completes with the number of bytes sent. To be added. + An error occurred when attempting to access the socket. + The has been closed. @@ -12789,7 +12954,6 @@ This member outputs trace information when you enable network tracing in your ap The cannot be null. A socket operation was already in progress using the object specified in the parameter. - Windows XP or later is required for this method. The has been closed. The protocol specified is connection-oriented, but the is not yet connected. @@ -12835,6 +12999,9 @@ This member outputs trace information when you enable network tracing in your ap Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -12874,6 +13041,9 @@ This member outputs trace information when you enable network tracing in your ap Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -12911,6 +13081,9 @@ This member outputs trace information when you enable network tracing in your ap Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -12951,6 +13124,9 @@ This member outputs trace information when you enable network tracing in your ap Sends data to the specified remote host. An asynchronous task that completes with the number of bytes sent. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. diff --git a/xml/System.Net.Sockets/SocketTaskExtensions.xml b/xml/System.Net.Sockets/SocketTaskExtensions.xml index ff1a1cc142a..f4f2012c88d 100644 --- a/xml/System.Net.Sockets/SocketTaskExtensions.xml +++ b/xml/System.Net.Sockets/SocketTaskExtensions.xml @@ -90,6 +90,11 @@ Performs an asynchronous operation on to accept an incoming connection attempt on the socket. An asynchronous task that completes with a to handle communication with the remote host. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + An error occurred when attempting to access the socket. + The has been closed. @@ -140,6 +145,11 @@ Performs an asynchronous operation on to accept an incoming connection attempt on the socket. An asynchronous task that completes with a to handle communication with the remote host. To be added. + An invalid operation was requested. This exception occurs if the accepting is not listening for connections or the accepted socket is bound. + + You must call the and method before calling the method. + An error occurred when attempting to access the socket. + The has been closed. @@ -189,6 +199,12 @@ Establishes a connection to a remote host. An asynchronous Task. To be added. + The parameter cannot be null. + The is listening. + An error occurred when attempting to access the socket. + The local endpoint and the parameter are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -229,6 +245,12 @@ Establishes a connection to a remote host. A task that represents the asynchronous connection operation. To be added. + The parameter cannot be null. + The is listening. + An error occurred when attempting to access the socket. + The local endpoint and the parameter are not the same address family. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -280,6 +302,17 @@ Establishes a connection to a remote host. The host is specified by an IP address and a port number. A task that represents an asynchronous connection operation. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -331,6 +364,18 @@ Establishes a connection to a remote host. The host is specified by an array of IP addresses and a port number. A task that represents the asynchronous connect operation. To be added. + The parameter cannot be null. + The parameter cannot be empty array. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -382,6 +427,17 @@ Establishes a connection to a remote host. The host is specified by a host name and a port number. An asynchronous task. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -424,6 +480,17 @@ Establishes a connection to a remote host, which is specified by an IP address and a port number. A task that represents the asynchronous connection operation. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -466,6 +533,18 @@ Establishes a connection to a remote host, which is specified by an array of IP addresses and a port number. A task that represents the asynchronous connection operation. To be added. + The parameter cannot be null. + The parameter cannot be empty array. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -508,6 +587,17 @@ Establishes a connection to a remote host, which is specified by a host name and a port number. A task that represents an asynchronous connection operation. To be added. + The parameter cannot be null. + + is less than . + + -or- + + is greater than . + The is listening. + An error occurred when attempting to access the socket. + The has been closed. + A caller higher in the call stack does not have permission for the requested operation. @@ -559,6 +649,8 @@ Receives data from a connected socket. A task that represents the asynchronous receive operation. The value of the parameter contains the number of bytes received. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -610,6 +702,9 @@ Receives data from a connected socket. A task that represents the asynchronous receive operation. The value of the parameter contains the number of bytes received. To be added. + The parameter was null. + The has been closed. + An error occurred when attempting to access the socket. @@ -654,6 +749,8 @@ Receives data from a connected socket. A task that completes with the number of bytes received, or 0 if the end of the stream has been reached. To be added. + The has been closed. + An error occurred when attempting to access the socket. @@ -707,6 +804,15 @@ Receives data from a specified network device. An asynchronous Task that completes with a SocketReceiveFromResult struct. To be added. + + is . + + -or- + + is . + An error occurred when attempting to access the socket. + The has been closed. + A caller in the call stack does not have the required permissions. @@ -760,6 +866,9 @@ Receives the specified number of bytes of data into the specified location of the data buffer, using the specified , and stores the endpoint and packet information. An asynchronous Task that completes with a struct. To be added. + The object has been closed. + The is . + You must call the Bind method before performing this operation. @@ -811,6 +920,8 @@ Sends data to a connected socket. An asynchronous task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. To be added. + An error occurred when attempting to access the socket. + The has been closed. @@ -862,6 +973,9 @@ Sends data to a connected socket. An asynchronous task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. @@ -906,6 +1020,8 @@ Sends data to a connected socket. A task that completes with number of bytes sent to the socket if the operation was successful. Otherwise, the task will complete with an invalid socket error. To be added. + An error occurred when attempting to access the socket. + The has been closed. @@ -959,6 +1075,9 @@ Sends data asynchronously to a specific remote host. An asynchronous task that completes with number of bytes sent if the operation was successful. Otherwise, the task will complete with an invalid socket error. To be added. + is . + An error occurred when attempting to access the socket. + The has been closed. diff --git a/xml/System.Net/IPEndPoint.xml b/xml/System.Net/IPEndPoint.xml index f22081e75e3..a36ecb49848 100644 --- a/xml/System.Net/IPEndPoint.xml +++ b/xml/System.Net/IPEndPoint.xml @@ -199,11 +199,7 @@ -or- - is greater than . - - -or- - - is less than 0 or greater than 0x00000000FFFFFFFF. + is greater than .