Socket.ReceiveFromAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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 -> boolPublic Function ReceiveFromAsync (e As SocketAsyncEventArgs) As BooleanParameter
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
Tidak RemoteEndPoint boleh null.
Operasi soket sudah berlangsung menggunakan SocketAsyncEventArgs objek yang ditentukan dalam e parameter .
Sudah Socket ditutup.
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.
Sudah Socket ditutup.
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.
Sudah Socket ditutup.
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
- 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.
Sudah Socket ditutup.
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
- 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.
Sudah Socket ditutup.
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
- 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.
Sudah Socket ditutup.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk