Bagikan melalui


Socket.ReceiveFromAsync Metode

Definisi

Overload

ReceiveFromAsync(SocketAsyncEventArgs)

Mulai menerima data secara asinkron dari perangkat jaringan tertentu.

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Menerima data dan mengembalikan titik akhir host pengirim.

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Menerima data dan mengembalikan titik akhir host pengirim.

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Menerima data dan mengembalikan titik akhir host pengirim.

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

Menerima data dan mengembalikan titik akhir host pengirim.

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

Menerima datagram ke dalam buffer data, menggunakan , dan menyimpan titik akhir yang ditentukan SocketFlags.

ReceiveFromAsync(SocketAsyncEventArgs)

Sumber:
Socket.cs
Sumber:
Socket.cs
Sumber:
Socket.cs

Mulai menerima data secara asinkron dari perangkat jaringan tertentu.

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

Parameter

e
SocketAsyncEventArgs

Objek SocketAsyncEventArgs yang digunakan untuk operasi soket asinkron ini.

Mengembalikan

true jika operasi I/O tertunda. Peristiwa Completed pada e parameter akan dinaikkan setelah menyelesaikan operasi.

false jika operasi I/O selesai secara sinkron. Dalam hal ini, Peristiwa Completed pada e parameter tidak akan dinaikkan dan e objek yang diteruskan sebagai parameter dapat diperiksa segera setelah panggilan metode kembali untuk mengambil hasil operasi.

Pengecualian

Operasi soket sudah berlangsung menggunakan SocketAsyncEventArgs objek yang ditentukan dalam e parameter .

Terjadi kesalahan saat mencoba mengakses soket.

Keterangan

Metode ReceiveFromAsync ini digunakan terutama untuk menerima data pada soket tanpa koneksi. Alamat lokal soket harus diketahui.

Pemanggil harus mengatur SocketAsyncEventArgs.RemoteEndPoint properti ke EndPoint jenis yang sama dengan titik akhir host jarak jauh. Properti akan diperbarui saat berhasil menerima ke titik akhir jarak jauh aktual.

SocketAsyncEventArgs.SocketFlags Properti pada e parameter menyediakan penyedia layanan Window Sockets dengan informasi tambahan tentang permintaan baca. Untuk informasi selengkapnya tentang cara menggunakan parameter ini, lihat System.Net.Sockets.SocketFlags.

Properti dan peristiwa berikut pada System.Net.Sockets.SocketAsyncEventArgs objek diperlukan agar berhasil memanggil metode ini:

Pemanggil dapat mengatur SocketAsyncEventArgs.UserToken properti ke objek status pengguna apa pun yang diinginkan sebelum memanggil ReceiveFromAsync metode , sehingga informasi akan dapat diambil dalam metode panggilan balik. Jika panggilan balik membutuhkan lebih banyak informasi daripada satu objek, kelas kecil dapat dibuat untuk menyimpan informasi status lain yang diperlukan sebagai anggota.

Untuk soket berorientasi pesan, pesan masuk ditempatkan ke dalam buffer hingga ukuran total buffer. Properti SocketAsyncEventArgs.Count dan SocketAsyncEventArgs.Offset menentukan di mana dalam buffer data ditempatkan dan jumlah data.

Untuk soket gaya aliran byte, data masuk ditempatkan ke dalam buffer hingga buffer terisi, koneksi ditutup, atau data yang di-buffer secara internal habis. Properti SocketAsyncEventArgs.Count dan SocketAsyncEventArgs.Offset menentukan di mana dalam buffer data ditempatkan dan jumlah data.

Lihat juga

Berlaku untuk

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs

Menerima data dan mengembalikan titik akhir host pengirim.

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)

Parameter

buffer
ArraySegment<Byte>

Buffer untuk data yang diterima.

remoteEndPoint
EndPoint

Titik akhir dengan jenis yang sama dengan titik akhir host jarak jauh.

Mengembalikan

Tugas asinkron yang selesai dengan SocketReceiveFromResult berisi jumlah byte yang diterima dan titik akhir host pengirim.

Pengecualian

remoteEndPointadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

Berlaku untuk

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs

Menerima data dan mengembalikan titik akhir host pengirim.

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)

Parameter

buffer
ArraySegment<Byte>

Buffer untuk data yang diterima.

socketFlags
SocketFlags

Kombinasi bitwise dari nilai SocketFlags yang akan digunakan saat menerima data.

remoteEndPoint
EndPoint

Titik akhir dengan jenis yang sama dengan titik akhir host jarak jauh.

Mengembalikan

Tugas asinkron yang selesai dengan SocketReceiveFromResult berisi jumlah byte yang diterima dan titik akhir host pengirim.

Pengecualian

remoteEndPointadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

Berlaku untuk

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs

Menerima data dan mengembalikan titik akhir host pengirim.

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)

Parameter

buffer
Memory<Byte>

Buffer untuk data yang diterima.

remoteEndPoint
EndPoint

Titik akhir dengan jenis yang sama dengan titik akhir host jarak jauh.

cancellationToken
CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

Tugas asinkron yang selesai dengan SocketReceiveFromResult berisi jumlah byte yang diterima dan titik akhir host pengirim.

Pengecualian

remoteEndPointadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk

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

Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs

Menerima data dan mengembalikan titik akhir host pengirim.

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)

Parameter

buffer
Memory<Byte>

Buffer untuk data yang diterima.

socketFlags
SocketFlags

Kombinasi bitwise dari nilai SocketFlags yang akan digunakan saat menerima data.

remoteEndPoint
EndPoint

Titik akhir dengan jenis yang sama dengan titik akhir host jarak jauh.

cancellationToken
CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

Tugas asinkron yang selesai dengan SocketReceiveFromResult berisi jumlah byte yang diterima dan titik akhir host pengirim.

Pengecualian

remoteEndPointadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk

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

Sumber:
Socket.Tasks.cs
Sumber:
Socket.Tasks.cs

Menerima datagram ke dalam buffer data, menggunakan , dan menyimpan titik akhir yang ditentukan SocketFlags.

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)

Parameter

buffer
Memory<Byte>

Buffer untuk data yang diterima.

socketFlags
SocketFlags

Kombinasi bitwise dari SocketFlags nilai yang akan digunakan saat menerima data.

receivedAddress
SocketAddress

SocketAddress Instans yang diperbarui dengan nilai peer jarak jauh saat metode ini kembali.

cancellationToken
CancellationToken

Token pembatalan yang dapat digunakan untuk memberi sinyal operasi asinkron harus dibatalkan.

Mengembalikan

Tugas asinkron yang selesai dengan SocketReceiveFromResult berisi jumlah byte yang diterima dan titik akhir host pengirim.

Pengecualian

receivedAddressadalah null.

Terjadi kesalahan saat mencoba mengakses soket.

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Berlaku untuk