Socket.ReceiveFromAsync 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
ReceiveFromAsync(SocketAsyncEventArgs)	Belirtilen bir 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 bir 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, yöntem çağrısı işlemin sonucunu almak için döndürdükten hemen sonra incelenebilir.

Özel durumlar

ArgumentNullException

RemoteEndPoint null olamaz.

InvalidOperationException

Parametresinde e belirtilen 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 öncelikli olarak bağlantısız bir yuvada veri 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, gerçek uzak uç noktaya başarılı bir şekilde almada güncelleştirilir.

SocketAsyncEventArgs.SocketFlags parametresindeki e özelliği, Window Sockets hizmet sağlayıcısına okuma isteği hakkında ek bilgiler 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 SocketAsyncEventArgs.UserToken önce istenen herhangi bir kullanıcı durumu nesnesine özelliğini ayarlayabilirReceiveFromAsync, böylece bilgiler geri çağırma yönteminde alınabilir. Geri çağırma için tek bir nesneden daha fazla bilgi gerekiyorsa, gerekli diğer durum bilgilerini üye olarak tutmak için küçük bir sınıf oluşturulabilir.

İleti odaklı yuvalar için, arabelleğe arabellek toplam boyutuna kadar gelen bir 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'e eşittir.

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'e eşittir.

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 iptal edilmesi gerektiğini belirten bir iptal belirteci.

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'e eşittir.

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 iptal edilmesi gerektiğini belirten bir iptal belirteci.

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'e eşittir.

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 iptal edilmesi gerektiğini belirten bir iptal belirteci.

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'e eşittir.

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.