Socket.ReceiveFromAsync Yöntem

Tanım

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
Kaynak:
Socket.cs
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

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

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

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:

Ç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.

Şunlara uygulanır

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Kaynak:
Socket.Tasks.cs
Kaynak:
Socket.Tasks.cs
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

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

remoteEndPoint, null değeridir.

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

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

Şunlara uygulanır

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Kaynak:
Socket.Tasks.cs
Kaynak:
Socket.Tasks.cs
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

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

remoteEndPoint, null değeridir.

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

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

Şunlara uygulanır

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Kaynak:
Socket.Tasks.cs
Kaynak:
Socket.Tasks.cs
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

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

remoteEndPoint, null değeridir.

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

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

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

Şunlara uygulanır

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

Kaynak:
Socket.Tasks.cs
Kaynak:
Socket.Tasks.cs
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

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

remoteEndPoint, null değeridir.

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

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

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

Şunlara uygulanır

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

Kaynak:
Socket.Tasks.cs
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

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

receivedAddress, null değeridir.

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

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

Şunlara uygulanır