Socket.ReceiveFromAsync Metode

Definisi

Ruang nama:

System.Net.Sockets

Rakitan:

System.Net.Sockets.dll

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

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

Boolean

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

ArgumentNullException

Tidak RemoteEndPoint boleh null.

InvalidOperationException

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

ObjectDisposedException

Sudah Socket ditutup.

SocketException

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:

• SocketAsyncEventArgs.Buffer

• SocketAsyncEventArgs.Count

• SocketAsyncEventArgs.Offset

• SocketAsyncEventArgs.RemoteEndPoint

• SocketAsyncEventArgs.Completed

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

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

ReceiveFromAsync(ArraySegment<Byte>, EndPoint)

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

Task<SocketReceiveFromResult>

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

Pengecualian

ArgumentNullException

remoteEndPointadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

ReceiveFromAsync(ArraySegment<Byte>, SocketFlags, EndPoint)

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

Task<SocketReceiveFromResult>

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

Pengecualian

ArgumentNullException

remoteEndPointadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

ReceiveFromAsync(Memory<Byte>, EndPoint, CancellationToken)

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

ValueTask<SocketReceiveFromResult>

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

Pengecualian

ArgumentNullException

remoteEndPointadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

OperationCanceledException

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

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

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

ValueTask<SocketReceiveFromResult>

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

Pengecualian

ArgumentNullException

remoteEndPointadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

SecurityException

Penelepon dalam tumpukan panggilan tidak memiliki izin yang diperlukan.

OperationCanceledException

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

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

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

ValueTask<Int32>

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

Pengecualian

ArgumentNullException

receivedAddressadalah null.

SocketException

Terjadi kesalahan saat mencoba mengakses soket.

ObjectDisposedException

Sudah Socket ditutup.

OperationCanceledException

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