Socket.ReceiveFromAsync Yöntem

Tanım

Ad Alanı:

System.Net.Sockets

Bütünleştirilmiş Kod:

System.Net.Sockets.dll

Aşırı Yüklemeler

ReceiveFromAsync(SocketAsyncEventArgs)	Belirtilen ağ cihazından zaman uyumsuz olarak veri almaya başlar.
ReceiveFromAsync(ArraySegment<Byte>, EndPoint)	Verileri alır ve gönderen konağın uç noktasını döndürür.
ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)	Verileri alır ve gönderen konağın uç noktasını döndürür.
ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)	Verileri alır ve gönderen konağın uç noktasını döndürür.
ReceiveFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)	Verileri alır ve gönderen konağın uç noktasını döndürür.
ReceiveFromAsync(Memory<Byte>, SocketFlags, SocketAddress, CancellationToken)	Belirtilen SocketFlagsöğesini kullanarak veri arabelleğine bir veri birimi alır ve uç noktayı depolar.

ReceiveFromAsync(SocketAsyncEventArgs)

Kaynak:

Socket.cs

Belirtilen ağ cihazından zaman uyumsuz olarak veri almaya başlar.

public:
 bool ReceiveFromAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool ReceiveFromAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.ReceiveFromAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function ReceiveFromAsync (e As SocketAsyncEventArgs) As Boolean

Parametreler

e

SocketAsyncEventArgs

SocketAsyncEventArgs Bu zaman uyumsuz yuva işlemi için kullanılacak nesne.

Döndürülenler

Boolean

true G/Ç işlemi bekliyorsa. Completed parametresindeki e olay, işlem tamamlandıktan sonra tetiklenir.

false G/Ç işlemi zaman uyumlu olarak tamamlandıysa. Bu durumda, Completed parametredeki e olay tetiklenmez ve e parametre olarak geçirilen nesne, işlemin sonucunu almak için yöntem çağrısı döndürüldükten hemen sonra incelenebilir.

Özel durumlar

ArgumentNullException

RemoteEndPoint null olamaz.

InvalidOperationException

parametresinde belirtilen e nesne kullanılarak SocketAsyncEventArgs bir yuva işlemi zaten devam ediyor.

ObjectDisposedException

Kapatılmış Socket .

SocketException

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

Açıklamalar

ReceiveFromAsync yöntemi öncelikle bağlantısız bir yuvadaki verileri almak için kullanılır. Yuvanın yerel adresi bilinmelidir.

Çağıranın SocketAsyncEventArgs.RemoteEndPoint özelliğini uzak konağın uç noktasıyla aynı türde bir EndPoint değere ayarlaması gerekir. Özellik, başarılı alma işleminin gerçek uzak uç noktasına güncelleştirileceğini gösterir.

SocketAsyncEventArgs.SocketFlags parametresindeki e özelliği, Pencere Yuvaları hizmet sağlayıcısına okuma isteği hakkında ek bilgi sağlar. Bu parametreyi kullanma hakkında daha fazla bilgi için bkz System.Net.Sockets.SocketFlags. .

Bu yöntemi başarıyla çağırmak için nesnedeki System.Net.Sockets.SocketAsyncEventArgs aşağıdaki özellikler ve olaylar gereklidir:

• SocketAsyncEventArgs.Buffer

• SocketAsyncEventArgs.Count

• SocketAsyncEventArgs.Offset

• SocketAsyncEventArgs.RemoteEndPoint

• SocketAsyncEventArgs.Completed

Çağıran, yöntemi çağırmadan ReceiveFromAsync önce istenen herhangi bir kullanıcı durumu nesnesine özelliğini ayarlayabilirSocketAsyncEventArgs.UserToken, böylece bilgiler geri çağırma yönteminde alınabilir. Geri çağırma tek bir nesneden daha fazla bilgiye ihtiyaç duyuyorsa, diğer gerekli durum bilgilerini üye olarak tutmak için küçük bir sınıf oluşturulabilir.

İleti odaklı yuvalar için, arabelleğe arabelleğinin toplam boyutuna kadar bir gelen ileti yerleştirilir. SocketAsyncEventArgs.Count ve SocketAsyncEventArgs.Offset özellikleri, verilerin arabelleğe nereye yerleştirileceğini ve veri miktarını belirler.

Bayt akış stili yuvalar için gelen veriler arabellek doldurulana, bağlantı kapatılana veya dahili olarak arabelleğe alınan veriler tükenene kadar arabelleğe yerleştirilir. SocketAsyncEventArgs.Count ve SocketAsyncEventArgs.Offset özellikleri, verilerin arabelleğe nereye yerleştirileceğini ve veri miktarını belirler.

Ayrıca bkz.

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• Offset
• RemoteEndPoint
• UserToken

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Kaynak:

Socket.Tasks.cs

Verileri alır ve gönderen konağın uç noktasını döndürür.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::SocketReceiveFromResult> ^ ReceiveFromAsync(ArraySegment<System::Byte> buffer, System::Net::EndPoint ^ remoteEndPoint);

public System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync (ArraySegment<byte> buffer, System.Net.EndPoint remoteEndPoint);

member this.ReceiveFromAsync : ArraySegment<byte> * System.Net.EndPoint -> System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As ArraySegment(Of Byte), remoteEndPoint As EndPoint) As Task(Of SocketReceiveFromResult)

Parametreler

buffer

ArraySegment<Byte>

Alınan veriler için arabellek.

remoteEndPoint

EndPoint

Uzak konağın uç noktasıyla aynı türde bir uç nokta.

Döndürülenler

Task<SocketReceiveFromResult>

Alınan bayt sayısını ve gönderen konağın uç noktasını içeren bir SocketReceiveFromResult ile tamamlanan zaman uyumsuz görev.

Özel durumlar

ArgumentNullException

remoteEndPoint, null değeridir.

SocketException

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

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınındaki bir çağıranın gerekli izinleri yok.

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Kaynak:

Socket.Tasks.cs

Verileri alır ve gönderen konağın uç noktasını döndürür.

public:
 System::Threading::Tasks::Task<System::Net::Sockets::SocketReceiveFromResult> ^ ReceiveFromAsync(ArraySegment<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEndPoint);

public System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync (ArraySegment<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEndPoint);

member this.ReceiveFromAsync : ArraySegment<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> System.Threading.Tasks.Task<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As ArraySegment(Of Byte), socketFlags As SocketFlags, remoteEndPoint As EndPoint) As Task(Of SocketReceiveFromResult)

Parametreler

buffer

ArraySegment<Byte>

Alınan veriler için arabellek.

socketFlags

SocketFlags

Verileri alırken kullanılacak SocketFlags değerlerinin bit düzeyinde birleşimi.

remoteEndPoint

EndPoint

Uzak konağın uç noktasıyla aynı türde bir uç nokta.

Döndürülenler

Task<SocketReceiveFromResult>

Alınan bayt sayısını ve gönderen konağın uç noktasını içeren bir SocketReceiveFromResult ile tamamlanan zaman uyumsuz görev.

Özel durumlar

ArgumentNullException

remoteEndPoint, null değeridir.

SocketException

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

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınındaki bir çağıranın gerekli izinleri yok.

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Kaynak:

Socket.Tasks.cs

Verileri alır ve gönderen konağın uç noktasını döndürür.

public System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync (Memory<byte> buffer, System.Net.EndPoint remoteEndPoint, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), remoteEndPoint As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of SocketReceiveFromResult)

Parametreler

buffer

Memory<Byte>

Alınan veriler için arabellek.

remoteEndPoint

EndPoint

Uzak konağın uç noktasıyla aynı türde bir uç nokta.

cancellationToken

CancellationToken

Zaman uyumsuz işlemin sinyalini vermek için kullanılabilecek bir iptal belirteci iptal edilmelidir.

Döndürülenler

ValueTask<SocketReceiveFromResult>

Alınan bayt sayısını ve gönderen konağın uç noktasını içeren bir SocketReceiveFromResult ile tamamlanan zaman uyumsuz görev.

Özel durumlar

ArgumentNullException

remoteEndPoint, null değeridir.

SocketException

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

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınındaki bir çağıranın gerekli izinleri yok.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

ReceiveFromAsync(Memory<Byte>, SocketFlags, EndPoint, CancellationToken)

Kaynak:

Socket.Tasks.cs

Verileri alır ve gönderen konağın uç noktasını döndürür.

public System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult> ReceiveFromAsync (Memory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEndPoint, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Net.Sockets.SocketReceiveFromResult>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), socketFlags As SocketFlags, remoteEndPoint As EndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of SocketReceiveFromResult)

Parametreler

buffer

Memory<Byte>

Alınan veriler için arabellek.

socketFlags

SocketFlags

Verileri alırken kullanılacak SocketFlags değerlerinin bit düzeyinde birleşimi.

remoteEndPoint

EndPoint

Uzak konağın uç noktasıyla aynı türde bir uç nokta.

cancellationToken

CancellationToken

Zaman uyumsuz işlemin sinyalini vermek için kullanılabilecek bir iptal belirteci iptal edilmelidir.

Döndürülenler

ValueTask<SocketReceiveFromResult>

Alınan bayt sayısını ve gönderen konağın uç noktasını içeren bir SocketReceiveFromResult ile tamamlanan zaman uyumsuz görev.

Özel durumlar

ArgumentNullException

remoteEndPoint, null değeridir.

SocketException

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

ObjectDisposedException

Kapatılmış Socket .

SecurityException

Çağrı yığınındaki bir çağıranın gerekli izinleri yok.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

ReceiveFromAsync(Memory<Byte>, SocketFlags, SocketAddress, CancellationToken)

Kaynak:

Socket.Tasks.cs

Belirtilen SocketFlagsöğesini kullanarak veri arabelleğine bir veri birimi alır ve uç noktayı depolar.

public System.Threading.Tasks.ValueTask<int> ReceiveFromAsync (Memory<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.SocketAddress receivedAddress, System.Threading.CancellationToken cancellationToken = default);

member this.ReceiveFromAsync : Memory<byte> * System.Net.Sockets.SocketFlags * System.Net.SocketAddress * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>

Public Function ReceiveFromAsync (buffer As Memory(Of Byte), socketFlags As SocketFlags, receivedAddress As SocketAddress, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)

Parametreler

buffer

Memory<Byte>

Alınan veriler için arabellek.

socketFlags

SocketFlags

Verileri alırken kullanılacak değerlerin bit düzeyinde birleşimi SocketFlags .

receivedAddress

SocketAddress

SocketAddress Bu yöntem döndürdüğünde uzak eş değeriyle güncelleştirilen bir örnek.

cancellationToken

CancellationToken

Zaman uyumsuz işlemin sinyalini vermek için kullanılabilecek bir iptal belirteci iptal edilmelidir.

Döndürülenler

ValueTask<Int32>

Alınan bayt sayısını ve gönderen konağın uç noktasını içeren bir SocketReceiveFromResult ile tamamlanan zaman uyumsuz görev.

Özel durumlar

ArgumentNullException

receivedAddress, null değeridir.

SocketException

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

ObjectDisposedException

Kapatılmış Socket .

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.