Socket.BeginReceiveMessageFrom Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.Sockets.dll

Kaynak:

Socket.cs

Belirtilen sayıda veriyi zaman uyumsuz olarak veri arabelleğinin SocketFlagsbelirtilen konumuna almaya başlar ve uç nokta ile paket bilgilerini depolar.

public:
 IAsyncResult ^ BeginReceiveMessageFrom(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ % remoteEP, AsyncCallback ^ callback, System::Object ^ state);

public IAsyncResult BeginReceiveMessageFrom(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, ref System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);

member this.BeginReceiveMessageFrom : byte[] * int * int * System.Net.Sockets.SocketFlags * EndPoint * AsyncCallback * obj -> IAsyncResult

Public Function BeginReceiveMessageFrom (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

buffer

Byte[]

Alınan verilerin depolama konumu olan tür Byte dizisi.

offset

Int32

Verilerin depolandığı parametredeki buffer sıfır tabanlı konum.

size

Int32

Alınacak bayt sayısı.

socketFlags

SocketFlags

Değerlerin bit düzeyinde birleşimi SocketFlags .

remoteEP

EndPoint

Zaman uyumlu almada güncelleştirilecek uzak konağın uç noktasıyla aynı türde bir EndPoint başvuru.

callback

AsyncCallback

Temsilci AsyncCallback .

state

Object

Bu istek için durum bilgilerini içeren bir nesne.

Döndürülenler

IAsyncResult

IAsyncResult Zaman uyumsuz okumaya başvuran bir.

Özel durumlar

ArgumentNullException

buffer, null'e eşittir.

-veya-

remoteEP, null'e eşittir.

SocketException

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

ArgumentOutOfRangeException

offset 0'dan küçüktür.

-veya-

offset , uzunluğundan bufferbüyüktür.

-veya-

size 0'dan küçüktür.

-veya-

size parametresinin buffer değeri eksi değerinden offset büyük.

ObjectDisposedException

Kapatılmış Socket .

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerinin kullanılmasını önermiyoruz. Bunun yerine, tabanlı eşdeğerleri kullanın Task.

İşlemin AsyncCallbackBeginReceiveMessageFrom tamamlanması hakkında bildirim almak için uygulamasına bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginReceiveMessageFromsatır içinde yürütüleceğini unutmayın. Bu durumda, CompletedSynchronously döndürülen IAsyncResult üzerindeki özelliği, yöntemin zaman uyumlu olarak tamamlandığını belirtmek için true olarak ayarlanır. yöntemine AsyncStateIAsyncResult geçirilen durum nesnesini almak için BeginReceiveMessageFrom özelliğini kullanın.

Zaman uyumsuz BeginReceiveMessageFrom işlem yöntemi çağrılarak EndReceiveMessageFrom tamamlanmalıdır. Genellikle yöntemi temsilci tarafından çağrılır AsyncCallback . EndReceiveMessageFrom işlem tamamlanana kadar çağıran iş parçacığını engeller.

Bekleyen BeginReceiveMessageFrombir öğesini iptal etmek için yöntemini çağırın Close .

Bu yöntem verileri parametresine buffer okur ve verilerin gönderildiği uzak konak uç noktasının yanı sıra alınan paketle ilgili bilgileri yakalar. Bu uç noktayı alma hakkında bilgi için bkz EndReceiveMessageFrom. . Bu yöntem, bilinmeyen bir konaktan veya birden çok konaktan zaman uyumsuz veri birimleri almayı planlıyorsanız en kullanışlı yöntemdir.

Uyarı

bir SocketExceptionalırsanız, özelliğini kullanarak SocketException.ErrorCode belirli bir hata kodunu alın.

Uyarı

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

Uyarı

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağrı bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları performans artışıyla karşılaşır.