Socket.Select Metoda

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestawy:

netstandard.dll, System.Net.Sockets.dll

Przeciążenia

Nazwa	Opis
Select(IList, IList, IList, TimeSpan)	Określa stan co najmniej jednego gniazda.
Select(IList, IList, IList, Int32)	Określa stan co najmniej jednego gniazda.

Select(IList, IList, IList, TimeSpan)

Źródło:

Socket.cs

Określa stan co najmniej jednego gniazda.

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

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

static member Select : System.Collections.IList * System.Collections.IList * System.Collections.IList * TimeSpan -> unit

Public Shared Sub Select (checkRead As IList, checkWrite As IList, checkError As IList, timeout As TimeSpan)

Parametry

checkRead

IList

Wystąpienie IList do Socket sprawdzania czytelności.

checkWrite

IList

Wystąpienie IList do Socket sprawdzania możliwości zapisu.

checkError

IList

Wystąpienie IList do sprawdzania Socket błędów.

timeout

TimeSpan

Wartość limitu czasu. Wartość równa -1 mikrosekund wskazuje nieskończony limit czasu.

Wyjątki

ArgumentNullException

Parametry checkRead, checkWritei checkError są wszystkie null lub puste. Co najmniej jeden z checkReadelementów , checkWritelub checkError musi zawierać co najmniej jeden Socketobiekt .

ArgumentOutOfRangeException

Parametr checkRead, checkWritelub checkError zawiera zbyt wiele gniazd.

ArgumentOutOfRangeException

Był timeout mniejszy niż -1 mikrosekund lub większy niż MaxValue mikrosekundy

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Co najmniej jedno gniazdo zostało usunięte.

Select(IList, IList, IList, Int32)

Źródło:

Socket.cs

Określa stan co najmniej jednego gniazda.

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);

static member Select : System.Collections.IList * System.Collections.IList * System.Collections.IList * int -> unit

Public Shared Sub Select (checkRead As IList, checkWrite As IList, checkError As IList, microSeconds As Integer)

Parametry

checkRead

IList

Wystąpienie IList do Socket sprawdzania czytelności.

checkWrite

IList

Wystąpienie IList do Socket sprawdzania możliwości zapisu.

checkError

IList

Wystąpienie IList do sprawdzania Socket błędów.

microSeconds

Int32

Wartość limitu czasu w mikrosekundach. Wartość -1 wskazuje nieskończony limit czasu.

Wyjątki

ArgumentNullException

Parametry checkRead, checkWritei checkError są wszystkie null lub puste. Co najmniej jeden z checkReadelementów , checkWritelub checkError musi zawierać co najmniej jeden Socketobiekt .

SocketException

Wystąpił błąd podczas próby uzyskania dostępu do gniazda.

ObjectDisposedException

Platforma .NET 5 lub nowsza: co najmniej jedno gniazdo jest usuwane.

ArgumentOutOfRangeException

Parametr checkRead, checkWritelub checkError zawiera zbyt wiele gniazd.

Przykłady

Poniższy przykład kodu używa Select metody do określenia, które gniazda nasłuchiwania mają żądanie połączenia.

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();
}

Dim ipHostEntry As IPHostEntry = Dns.Resolve(Dns.GetHostName())
Dim ipAddress As IPAddress = ipHostEntry.AddressList(0)

Dim socket0 As Socket = Nothing
Dim socket1 As Socket = Nothing
Dim socket2 As Socket = Nothing
Dim socket3 As Socket = Nothing
Dim socket4 As Socket = Nothing
Dim socket5 As Socket = Nothing

Dim listenList As New ArrayList()
listenList.Add(socket0)
listenList.Add(socket1)
listenList.Add(socket2)

Dim acceptList As New ArrayList()
acceptList.Add(socket3)
acceptList.Add(socket4)
acceptList.Add(socket5)

Dim i As Integer
For i = 0 To 2
   listenList(i) = New Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp)
   CType(listenList(i), Socket).Bind(New IPEndPoint(ipAddress, 11000 + i))
   CType(listenList(i), Socket).Listen(10)
Next i

'Only the sockets that contain a connection request
'will remain in listenList after Select returns.
Socket.Select(listenList, Nothing, Nothing, 1000)

For i = 0 To listenList.Count - 1
   acceptList(i) = CType(listenList(i), Socket).Accept()
Next i

Uwagi

Select jest metodą statyczną, która określa stan co najmniej jednego Socket wystąpienia. Przed użyciem Select metody należy umieścić co najmniej jedno gniazdo w obiekcie IList . Sprawdź czytelność, wywołując SelectIList parametr jako checkRead parametr . Aby sprawdzić gniazda pod kątem możliwości zapisu, użyj parametru checkWrite . Aby wykryć warunki błędu, użyj polecenia checkError. Po wywołaniu SelectIList metody element zostanie wypełniony tylko tymi gniazdami, które spełniają warunki.

Jeśli jesteś w stanie nasłuchiwania, czytelność oznacza, że wywołanie Accept zakończy się powodzeniem bez blokowania. Jeśli połączenie zostało już zaakceptowane, czytelność oznacza, że dane są dostępne do odczytu. W takich przypadkach wszystkie operacje odbierania zostaną wykonane pomyślnie bez blokowania. Czytelność może również wskazywać, czy zdalne Socket zamknęło połączenie. W takim przypadku wywołanie , które Receive zwróci natychmiast, a zwracane są zero bajtów.

Select zwraca wartość, gdy co najmniej jedno gniazdo zainteresowania (gniazda w checkReadlistach , checkWritei checkError ) spełnia określone kryteria lub microSeconds parametr zostanie przekroczony, w zależności od tego, co nastąpi wcześniej. Ustawienie microSeconds wartości -1 określa nieskończony limit czasu.

Jeśli wykonasz wywołanie nieblokujące do Connectmetody , zapis oznacza, że połączenie zostało nawiązane pomyślnie. Jeśli masz już ustanowione połączenie, zapis oznacza, że wszystkie operacje wysyłania powiedzą się bez blokowania.

Jeśli wykonano wywołanie nieblokujące funkcji Connect, checkerror parametr identyfikuje gniazda, które nie zostały pomyślnie połączone.

Nuta

Poll Użyj metody , jeśli chcesz określić tylko stan pojedynczego Socketelementu .

Nuta

Ta metoda nie może wykryć niektórych rodzajów problemów z połączeniem, takich jak uszkodzony sieciowy lub że host zdalny został zamknięty nieprzyzwoicie. Aby wykryć tego rodzaju błędy, należy spróbować wysłać lub odebrać dane.

Nuta

Jeśli zostanie wyświetlony element SocketException, użyj SocketException.ErrorCode właściwości , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu zapoznaj się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

• IList
• Accept()
• Connect(EndPoint)
• Poll(Int32, SelectMode)