Socket.Select Método

Definición

Sobrecargas

Select(IList, IList, IList, TimeSpan)

Determina el estado de uno o varios sockets.

Select(IList, IList, IList, Int32)

Determina el estado de uno o varios sockets.

Select(IList, IList, IList, TimeSpan)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Determina el estado de uno o varios sockets.

public static void Select (System.Collections.IList? checkRead, System.Collections.IList? checkWrite, System.Collections.IList? checkError, TimeSpan timeout);

Parámetros

checkRead
IList

Un IList de instancias de Socket para comprobar la legibilidad.

checkWrite
IList

Un IList de instancias de Socket para comprobar la writy.

checkError
IList

Un IList de instancias de Socket para comprobar si hay errores.

timeout
TimeSpan

Valor de tiempo de espera. Un valor igual a -1 microsegundos indica un tiempo de espera infinito.

Excepciones

Los parámetros checkRead, checkWritey checkError son todos null o vacíos. Al menos uno de checkRead, checkWriteo checkError debe contener al menos un Socket.

El parámetro checkRead, checkWriteo checkError contiene demasiados sockets.

El timeout era menor que -1 microsegundos o mayor que MaxValue microsegundos

Error al intentar acceder al socket.

Se ha eliminado uno o varios sockets.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 7, 8, 9

Select(IList, IList, IList, Int32)

Source:
Socket.cs
Source:
Socket.cs
Source:
Socket.cs

Determina el estado de uno o varios sockets.

public static void Select (System.Collections.IList? checkRead, System.Collections.IList? checkWrite, System.Collections.IList? checkError, int microSeconds);
public static void Select (System.Collections.IList checkRead, System.Collections.IList checkWrite, System.Collections.IList checkError, int microSeconds);

Parámetros

checkRead
IList

Un IList de instancias de Socket para comprobar la legibilidad.

checkWrite
IList

Un IList de instancias de Socket para comprobar la writy.

checkError
IList

Un IList de instancias de Socket para comprobar si hay errores.

microSeconds
Int32

Valor de tiempo de espera, en microsegundos. Un valor de -1 indica un tiempo de espera infinito.

Excepciones

Los parámetros checkRead, checkWritey checkError son todos null o vacíos. Al menos uno de checkRead, checkWriteo checkError debe contener al menos un Socket.

Error al intentar acceder al socket.

.NET 5 y versiones posteriores: se eliminan uno o varios sockets.

El parámetro checkRead, checkWriteo checkError contiene demasiados sockets.

Ejemplos

En el ejemplo de código siguiente se usa Select para determinar qué sockets de escucha tienen una solicitud de conexión.

IPHostEntry ipHostEntry = Dns.Resolve(Dns.GetHostName());
IPAddress ipAddress = ipHostEntry.AddressList[0];

Socket socket0 = null;
Socket socket1 = null;
Socket socket2 = null;
Socket socket3 = null;
Socket socket4 = null;
Socket socket5 = null;

ArrayList listenList = new ArrayList();
listenList.Add(socket0);
listenList.Add(socket1);
listenList.Add(socket2);

ArrayList acceptList = new ArrayList();
acceptList.Add(socket3);
acceptList.Add(socket4);
acceptList.Add(socket5);

for( int i = 0; i < 3; i++ )
{
  listenList[i] = new Socket(AddressFamily.InterNetwork,
                             SocketType.Stream,
                             ProtocolType.Tcp);
  ((Socket)listenList[i]).Bind(new IPEndPoint(ipAddress, 11000 + i));
  ((Socket)listenList[i]).Listen(10);
}

// Only the sockets that contain a connection request
// will remain in listenList after Select returns.

Socket.Select(listenList, null, null, 1000);

for( int i = 0; i < listenList.Count; i++ )
{
  acceptList[i] = ((Socket)listenList[i]).Accept();
}

Comentarios

Select es un método estático que determina el estado de una o varias instancias de Socket. Debe colocar uno o varios sockets en un IList para poder usar el método Select. Compruebe la legibilidad llamando a Select con el IList como parámetro checkRead. Para comprobar la writy de los sockets, use el parámetro checkWrite. Para detectar condiciones de error, use checkError. Después de llamar a Select, el IList se rellenará solo con los sockets que cumplan las condiciones.

Si se encuentra en un estado de escucha, la legibilidad significa que una llamada a Accept se realizará correctamente sin bloqueo. Si ya ha aceptado la conexión, la legibilidad significa que los datos están disponibles para la lectura. En estos casos, todas las operaciones de recepción se realizarán correctamente sin bloqueo. La legibilidad también puede indicar si el Socket remoto ha apagado la conexión; en ese caso, una llamada a Receive devolverá inmediatamente, con cero bytes devueltos.

Select devuelve cuando al menos uno de los sockets de interés (los sockets de la checkRead, checkWritey checkError listas) cumplen sus criterios especificados o se supera el parámetro microSeconds, lo que ocurra primero. Establecer microSeconds en -1 especifica un tiempo de espera infinito.

Si realiza una llamada sin bloqueo a Connect, la writability significa que se ha conectado correctamente. Si ya tiene establecida una conexión, la writy significa que todas las operaciones de envío se realizarán correctamente sin bloqueo.

Si ha realizado una llamada sin bloqueo a Connect, el parámetro checkerror identifica los sockets que no se han conectado correctamente.

Nota

Use el método Poll si solo desea determinar el estado de un único Socket.

Nota

Este método no puede detectar ciertos tipos de problemas de conexión, como un cable de red roto o que el host remoto se cerró de forma incorrecta. Debe intentar enviar o recibir datos para detectar estos tipos de errores.

Nota

Si recibe un SocketException, use la propiedad SocketException.ErrorCode para obtener el código de error específico. Después de obtener este código, consulte el código de error de la API versión 2 de Windows Sockets documentación para obtener una descripción detallada del error.

Consulte también

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1