UdpClient.SendAsync 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.
Mengirim datagram UDP secara asinkron ke host jarak jauh.
Overload
| SendAsync(Byte[], Int32) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
| SendAsync(ReadOnlyMemory<Byte>, CancellationToken) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
| SendAsync(Byte[], Int32, IPEndPoint) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
| SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
| SendAsync(Byte[], Int32, String, Int32) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
| SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken) |
Mengirim datagram UDP secara asinkron ke host jarak jauh. |
SendAsync(Byte[], Int32)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public:
System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes);public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes);member this.SendAsync : byte[] * int -> System.Threading.Tasks.Task<int>Public Function SendAsync (datagram As Byte(), bytes As Integer) As Task(Of Integer)Parameter
- datagram
- Byte[]
Array jenis Byte yang menentukan datagram UDP yang ingin Anda kirim direpresentasikan sebagai array byte.
- bytes
- Int32
Jumlah byte dalam datagram.
Mengembalikan
Menampilkan Task<TResult>.
Pengecualian
dgramadalah null.
UdpClient telah menetapkan host jarak jauh default.
Sudah UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
Keterangan
Kelebihan beban ini mengirimkan datagram ke host jarak jauh yang ditetapkan dalam Connect metode . Jika Anda tidak memanggil Connect sebelum memanggil kelebihan beban ini, metode akan melemparkan SocketException. Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.
Jika Anda ingin mengirim datagram ke host jarak jauh yang berbeda, Anda harus memanggil Connect metode dan menentukan host jarak jauh yang diinginkan. Gunakan salah satu metode lain SendAsync yang kelebihan beban untuk mengirim datagram ke alamat siaran.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(Byte[], Int32).
Berlaku untuk
SendAsync(ReadOnlyMemory<Byte>, CancellationToken)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Threading.CancellationToken cancellationToken = default);member this.SendAsync : ReadOnlyMemory<byte> * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parameter
- datagram
- ReadOnlyMemory<Byte>
ReadOnlyMemory<T> Jenis Byte yang menentukan datagram UDP yang ingin Anda kirim.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai default-nya adalah Tidak Ada.
Mengembalikan
ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.
Pengecualian
Sudah UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
SendAsync(Byte[], Int32, IPEndPoint)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public:
System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::Net::IPEndPoint ^ endPoint);public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint? endPoint);public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, System.Net.IPEndPoint endPoint);member this.SendAsync : byte[] * int * System.Net.IPEndPoint -> System.Threading.Tasks.Task<int>Public Function SendAsync (datagram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Task(Of Integer)Parameter
- datagram
- Byte[]
Array jenis Byte yang menentukan datagram UDP yang ingin Anda kirim direpresentasikan sebagai array byte.
- bytes
- Int32
Jumlah byte dalam datagram.
- endPoint
- IPEndPoint
IPEndPoint Yang mewakili host dan port untuk mengirim datagram.
Mengembalikan
Menampilkan Task<TResult>.
Pengecualian
dgramadalah null.
UdpClient telah menetapkan host jarak jauh default.
UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
Keterangan
Metode ini mengirim datagram ke titik akhir yang ditentukan. Sebelum memanggil kelebihan beban ini, Anda harus terlebih dahulu membuat IPEndPoint menggunakan alamat IP dan nomor port host jarak jauh tempat datagram Anda akan dikirimkan. Anda dapat mengirim datagram ke alamat siaran default, 255.255.255.255, dengan menentukan SocketOptionName.Broadcast properti Address dari IPEndPoint. Setelah Anda membuat ini IPEndPoint, teruskan ke metode ini sebagai endPoint parameter .
Jika Anda ingin mengirim datagram ke alamat siaran lainnya, gunakan Client metode untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast. Anda juga dapat kembali menggunakan Socket kelas .
Peringatan
Jangan berikan endPoint parameter untuk metode ini jika Anda telah membuat host jarak jauh dengan metode .Connect Jika Anda melakukannya, metode ini akan melempar .SocketException Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(Byte[], Int32, IPEndPoint).
Berlaku untuk
SendAsync(ReadOnlyMemory<Byte>, IPEndPoint, CancellationToken)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, System.Net.IPEndPoint? endPoint, System.Threading.CancellationToken cancellationToken = default);member this.SendAsync : ReadOnlyMemory<byte> * System.Net.IPEndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), endPoint As IPEndPoint, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parameter
- datagram
- ReadOnlyMemory<Byte>
ReadOnlyMemory<T> Jenis Byte yang menentukan datagram UDP yang ingin Anda kirim.
- endPoint
- IPEndPoint
IPEndPoint Yang mewakili host dan port untuk mengirim datagram.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai default-nya adalah Tidak Ada.
Mengembalikan
ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.
Pengecualian
UdpClient telah menetapkan host jarak jauh default dan endPoint bukan null.
Sudah UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.
Berlaku untuk
SendAsync(Byte[], Int32, String, Int32)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public:
System::Threading::Tasks::Task<int> ^ SendAsync(cli::array <System::Byte> ^ datagram, int bytes, System::String ^ hostname, int port);public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string? hostname, int port);public System.Threading.Tasks.Task<int> SendAsync (byte[] datagram, int bytes, string hostname, int port);member this.SendAsync : byte[] * int * string * int -> System.Threading.Tasks.Task<int>Public Function SendAsync (datagram As Byte(), bytes As Integer, hostname As String, port As Integer) As Task(Of Integer)Parameter
- datagram
- Byte[]
Array jenis Byte yang menentukan datagram UDP yang ingin Anda kirim direpresentasikan sebagai array byte.
- bytes
- Int32
Jumlah byte dalam datagram.
- hostname
- String
Nama host jarak jauh tempat Anda ingin mengirim datagram.
- port
- Int32
Nomor port jarak jauh yang ingin Anda komunikasikan.
Mengembalikan
Menampilkan Task<TResult>.
Pengecualian
dgramadalah null.
UdpClient telah menetapkan host jarak jauh default.
Sudah UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
Keterangan
Metode ini mengirim datagram ke nilai yang ditentukan oleh hostname parameter dan port . Anda dapat mengirim datagram ke alamat siaran default dengan menentukan "255.255.255.255" untuk hostname nilai parameter.
Jika Anda ingin mengirim datagram ke alamat siaran lainnya, gunakan Client metode untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast. Anda juga dapat kembali menggunakan Socket kelas .
Peringatan
Jangan berikan nama host atau nomor port ke metode ini jika Anda telah membuat host jarak jauh dengan metode .Connect Jika Anda melakukannya, metode ini akan melempar .SocketException Jika Anda menerima SocketException, gunakan SocketException.ErrorCode untuk mendapatkan kode kesalahan tertentu. Setelah mendapatkan kode ini, Anda dapat merujuk ke dokumentasi kode kesalahan API Windows Sockets versi 2 untuk deskripsi terperinci tentang kesalahan tersebut.
Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh Send(Byte[], Int32, String, Int32).
Berlaku untuk
SendAsync(ReadOnlyMemory<Byte>, String, Int32, CancellationToken)
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
- Sumber:
- UDPClient.cs
Mengirim datagram UDP secara asinkron ke host jarak jauh.
public System.Threading.Tasks.ValueTask<int> SendAsync (ReadOnlyMemory<byte> datagram, string? hostname, int port, System.Threading.CancellationToken cancellationToken = default);member this.SendAsync : ReadOnlyMemory<byte> * string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<int>Public Function SendAsync (datagram As ReadOnlyMemory(Of Byte), hostname As String, port As Integer, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of Integer)Parameter
- datagram
- ReadOnlyMemory<Byte>
ReadOnlyMemory<T> Jenis Byte yang menentukan datagram UDP yang ingin Anda kirim.
- hostname
- String
Nama host jarak jauh tempat Anda ingin mengirim datagram.
- port
- Int32
Nomor port jarak jauh yang ingin Anda komunikasikan.
- cancellationToken
- CancellationToken
Token yang akan dipantau untuk permintaan pembatalan. Nilai default-nya adalah Tidak Ada.
Mengembalikan
ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.
Pengecualian
UdpClient telah menetapkan host jarak jauh default.
Sudah UdpClient ditutup.
Terjadi kesalahan saat mengakses soket.
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