Bagikan melalui

UdpClient.SendAsync Metode

  • Referensi

Definisi

Ruang nama:
System.Net.Sockets
Rakitan:
System.Net.Sockets.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

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

Task<Int32>

Menampilkan Task<TResult>.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

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<Int32>

ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.

Pengecualian

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

OperationCanceledException

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

Task<Int32>

Menampilkan Task<TResult>.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

UdpClient ditutup.

SocketException

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<Int32>

ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.

Pengecualian

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default dan endPoint bukan null.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

OperationCanceledException

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

Task<Int32>

Menampilkan Task<TResult>.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

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<Int32>

ValueTask<TResult> yang mewakili operasi pengiriman asinkron. Nilai properti Hasilnya berisi jumlah byte yang dikirim.

Pengecualian

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

OperationCanceledException

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

Berlaku untuk