Socket.Select Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Aşırı Yüklemeler

Name	Description
Select(IList, IList, IList, TimeSpan)	Bir veya daha fazla yuvanın durumunu belirler.
Select(IList, IList, IList, Int32)	Bir veya daha fazla yuvanın durumunu belirler.

Select(IList, IList, IList, TimeSpan)

Kaynak:

Socket.cs

Bir veya daha fazla yuvanın durumunu belirler.

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)

Parametreler

checkRead

IList

Okunabilirliği denetlemek için örneklerden Socket biriIList.

checkWrite

IList

Yazılabilirliği denetlemek için örneklerden Socket biriIList.

checkError

IList

Hataları denetlemek için örneklerden Socket biriIList.

timeout

TimeSpan

Zaman aşımı değeri. -1 mikrosaniyeye eşit bir değer sonsuz zaman aşımına işaret eder.

Özel durumlar

ArgumentNullException

, checkWriteve checkError parametrelerinin checkReadtümü null veya boş. en az biri checkRead, checkWriteveya checkError en az bir Socketiçermelidir.

ArgumentOutOfRangeException

checkRead, checkWriteveya checkError parametresi çok fazla yuva içeriyor.

ArgumentOutOfRangeException

-1 timeout mikrosaniyeden küçük veya mikrosaniyeden MaxValue büyük

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Bir veya daha fazla yuva atılmış.

Select(IList, IList, IList, Int32)

Kaynak:

Socket.cs

Bir veya daha fazla yuvanın durumunu belirler.

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)

Parametreler

checkRead

IList

Okunabilirliği denetlemek için örneklerden Socket biriIList.

checkWrite

IList

Yazılabilirliği denetlemek için örneklerden Socket biriIList.

checkError

IList

Hataları denetlemek için örneklerden Socket biriIList.

microSeconds

Int32

Mikrosaniye olarak zaman aşımı değeri. -1 değeri sonsuz bir zaman aşımı olduğunu gösterir.

Özel durumlar

ArgumentNullException

, checkWriteve checkError parametrelerinin checkReadtümü null veya boş. en az biri checkRead, checkWriteveya checkError en az bir Socketiçermelidir.

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

.NET 5 ve üzeri: Bir veya daha fazla yuva atılır.

ArgumentOutOfRangeException

checkRead, checkWriteveya checkError parametresi çok fazla yuva içeriyor.

Örnekler

Aşağıdaki kod örneği, hangi dinleme yuvalarının bağlantı isteğine sahip olduğunu belirlemek için kullanır Select .

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

Açıklamalar

Select bir veya daha fazla Socket örneğin durumunu belirleyen statik bir yöntemdir. yöntemini kullanabilmeniz için önce bir IList veya daha fazla yuva yerleştirmelisiniz Select . parametresiyle IListcheckRead çağırarak Select okunabilirliği denetleyin. Yuvalarınızın yazılabilirliğini denetlemek için parametresini checkWrite kullanın. Hata koşullarını algılamak için kullanın checkError. çağrısından Selectsonra , IList yalnızca koşulları karşılayan yuvalarla doldurulur.

Dinleme durumundaysanız okunabilirlik, çağrısının Accept engellenmeden başarılı olacağı anlamına gelir. Bağlantıyı zaten kabul ettiyseniz okunabilirlik, verilerin okunabilmesi anlamına gelir. Bu gibi durumlarda, engelleme olmadan tüm alma işlemleri başarılı olur. Okunabilirlik, uzak Socket sunucunun bağlantıyı kapatıp kapatmadığını da gösterebilir; bu durumda çağrısı Receive sıfır bayt döndürülerek hemen döndürülür.

Select, ilgili yuvalardan en az biri (, checkWriteve checkError listelerindeki checkReadyuvalar) belirtilen ölçütleri karşıladığında veya microSeconds parametre aşıldığında (hangisi önce gelirse) döndürür. -1 ayarı microSeconds sonsuz bir zaman aşımı belirtir.

için engelleyici olmayan bir çağrı Connectyaparsanız yazılabilirlik, başarıyla bağlandığınız anlamına gelir. Önceden kurulmuş bir bağlantınız varsa, yazılabilirlik tüm gönderme işlemlerinin engellenmeden başarılı olacağı anlamına gelir.

öğesine Connectcheckerror engelleyici olmayan bir çağrı yaptıysanız parametresi, başarıyla bağlanmamış yuvaları tanımlar.

Not

Yalnızca tek Socketbir öğesinin Poll durumunu belirlemek istiyorsanız yöntemini kullanın.

Not

Bu yöntem, bozuk bir ağ kablosu gibi belirli türdeki bağlantı sorunlarını veya uzak konağın düzgün bir şekilde kapatıldığını algılayamaz. Bu tür hataları algılamak için veri göndermeye veya almaya çalışmanız gerekir.

Not

bir SocketExceptionalırsanız, özelliğini kullanarak SocketException.ErrorCode belirli bir hata kodunu alın. Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

Ayrıca bkz.

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