UdpClient.Send Metode

Referensi

Definisi

Ruang nama:: System.Net.Sockets

Rakitan:: System.Net.Sockets.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

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 ke host jarak jauh.

Overload

Send(Byte[], Int32, String, Int32)	Mengirim datagram UDP ke port tertentu pada host jarak jauh tertentu.
Send(ReadOnlySpan<Byte>, String, Int32)	Mengirim datagram UDP ke port tertentu pada host jarak jauh tertentu.
Send(Byte[], Int32, IPEndPoint)	Mengirim datagram UDP ke host di titik akhir jarak jauh yang ditentukan.
Send(Byte[], Int32)	Mengirim datagram UDP ke host jarak jauh.
Send(ReadOnlySpan<Byte>)	Mengirim datagram UDP ke host jarak jauh.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Mengirim datagram UDP ke host di titik akhir jarak jauh yang ditentukan.

Send(Byte[], Int32, String, Int32)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke port tertentu pada host jarak jauh tertentu.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::String ^ hostname, int port);

public int Send (byte[] dgram, int bytes, string? hostname, int port);

public int Send (byte[] dgram, int bytes, string hostname, int port);

member this.Send : byte[] * int * string * int -> int

Public Function Send (dgram As Byte(), bytes As Integer, hostname As String, port As Integer) As Integer

Parameter

dgram: 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

Int32

Jumlah byte yang dikirim.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan Send metode . Contoh ini menggunakan nama host dan nomor port untuk mengidentifikasi host target.

UdpClient^ udpClient = gcnew UdpClient;

array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length, "www.contoso.com", 11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient();

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length, "www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Keterangan

Metode Send mengirim datagram ke nilai yang ditentukan oleh hostname parameter dan port dan mengembalikan jumlah byte yang berhasil dikirim. 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 lain, gunakan Client metode untuk mendapatkan yang mendasar Socket, dan atur opsi soket ke SocketOptionName.Broadcast. Anda juga dapat kembali menggunakan Socket kelas .

Catatan

Jangan berikan nama host atau nomor port ke metode ini jika Anda telah menetapkan host jarak jauh dengan metode .Connect Jika Anda melakukannya, Send metode 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.

Lihat juga

Berlaku untuk

Send(ReadOnlySpan<Byte>, String, Int32)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke port tertentu pada host jarak jauh tertentu.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::String ^ hostname, int port);

public int Send (ReadOnlySpan<byte> datagram, string? hostname, int port);

member this.Send : ReadOnlySpan<byte> * string * int -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), hostname As String, port As Integer) As Integer

Parameter

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<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.

Mengembalikan

Int32

Jumlah byte yang dikirim.

Pengecualian

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Berlaku untuk

Send(Byte[], Int32, IPEndPoint)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke host di titik akhir jarak jauh yang ditentukan.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes, System::Net::IPEndPoint ^ endPoint);

public int Send (byte[] dgram, int bytes, System.Net.IPEndPoint? endPoint);

public int Send (byte[] dgram, int bytes, System.Net.IPEndPoint endPoint);

member this.Send : byte[] * int * System.Net.IPEndPoint -> int

Public Function Send (dgram As Byte(), bytes As Integer, endPoint As IPEndPoint) As Integer

Parameter

dgram: Byte[]

Array jenis Byte yang menentukan datagram UDP yang ingin Anda kirim, direpresentasikan sebagai array byte.

bytes: Int32

Jumlah byte dalam datagram.

endPoint: IPEndPoint

Yang IPEndPoint mewakili host dan port untuk mengirim datagram.

Mengembalikan

Int32

Jumlah byte yang dikirim.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan Send metode . Contoh ini menggunakan IPEndPoint untuk menentukan host target.

UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );

array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there?" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length, ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);	

Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");
try{
    udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint);
}
catch ( Exception e ){
    Console.WriteLine(e.ToString());	
}

Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)

Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there?")
Try
   udpClient.Send(sendBytes, sendBytes.Length, ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Keterangan

Metode Send mengirim datagram ke titik akhir yang ditentukan dan mengembalikan jumlah byte yang berhasil dikirim. 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 Send metode sebagai endPoint parameter .

Catatan

Jangan berikan endPoint parameter untuk metode ini jika Anda telah membuat host jarak jauh dengan metode .Connect Jika Anda melakukannya, Send metode 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.

Lihat juga

Berlaku untuk

Send(Byte[], Int32)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke host jarak jauh.

public:
 int Send(cli::array <System::Byte> ^ dgram, int bytes);

public int Send (byte[] dgram, int bytes);

member this.Send : byte[] * int -> int

Public Function Send (dgram As Byte(), bytes As Integer) As Integer

Parameter

dgram: Byte[]

Array jenis Byte yang menentukan datagram UDP yang ingin Anda kirim direpresentasikan sebagai array byte.

bytes: Int32

Jumlah byte dalam datagram.

Mengembalikan

Int32

Jumlah byte yang dikirim.

Pengecualian

ArgumentNullException

dgramadalah null.

InvalidOperationException

UdpClient telah menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Contoh

Contoh berikut menunjukkan Send metode . Anda harus membuat host jarak jauh default sebelum menggunakan kelebihan beban ini.

UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
array<Byte>^ sendBytes = Encoding::ASCII->GetBytes( "Is anybody there" );
try
{
   udpClient->Send( sendBytes, sendBytes->Length );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

UdpClient udpClient = new UdpClient("www.contoso.com", 11000);
Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there");
try{
    udpClient.Send(sendBytes, sendBytes.Length);
}
catch ( Exception e ){
    Console.WriteLine( e.ToString());
}

Dim udpClient As New UdpClient("www.contoso.com", 11000)
Dim sendBytes As [Byte]() = Encoding.ASCII.GetBytes("Is anybody there")
Try
   udpClient.Send(sendBytes, sendBytes.Length)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Keterangan

Kelebihan beban ini mengirim datagram ke host jarak jauh yang ditetapkan dalam Connect metode dan mengembalikan jumlah byte yang dikirim. Jika Anda tidak memanggil Connect sebelum memanggil kelebihan beban ini, Send metode 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.

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 Send yang kelebihan beban untuk mengirim datagram ke alamat siaran.

Lihat juga

Connect(String, Int32)

Berlaku untuk

Send(ReadOnlySpan<Byte>)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke host jarak jauh.

public:
 int Send(ReadOnlySpan<System::Byte> datagram);

public int Send (ReadOnlySpan<byte> datagram);

member this.Send : ReadOnlySpan<byte> -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte)) As Integer

Parameter

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<T> Jenis Byte yang menentukan datagram UDP yang ingin Anda kirim.

Mengembalikan

Int32

Jumlah byte yang dikirim.

Pengecualian

InvalidOperationException

UdpClient belum menetapkan host jarak jauh default.

ObjectDisposedException

Sudah UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Berlaku untuk

Send(ReadOnlySpan<Byte>, IPEndPoint)

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Sumber:: UDPClient.cs

Mengirim datagram UDP ke host di titik akhir jarak jauh yang ditentukan.

public:
 int Send(ReadOnlySpan<System::Byte> datagram, System::Net::IPEndPoint ^ endPoint);

public int Send (ReadOnlySpan<byte> datagram, System.Net.IPEndPoint? endPoint);

member this.Send : ReadOnlySpan<byte> * System.Net.IPEndPoint -> int

Public Function Send (datagram As ReadOnlySpan(Of Byte), endPoint As IPEndPoint) As Integer

Parameter

datagram: ReadOnlySpan<Byte>

ReadOnlySpan<T> Jenis Byte yang menentukan datagram UDP yang ingin Anda kirim.

endPoint: IPEndPoint

Yang IPEndPoint mewakili host dan port untuk mengirim datagram.

Mengembalikan

Int32

Jumlah byte yang dikirim.

Pengecualian

InvalidOperationException

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

ObjectDisposedException

UdpClient ditutup.

SocketException

Terjadi kesalahan saat mengakses soket.

Berlaku untuk

Bagikan melalui

UdpClient.Send Metode

Definisi

Overload

Send(Byte[], Int32, String, Int32)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Send(ReadOnlySpan<Byte>, String, Int32)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

Send(Byte[], Int32, IPEndPoint)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Send(Byte[], Int32)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Send(ReadOnlySpan<Byte>)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

Send(ReadOnlySpan<Byte>, IPEndPoint)

Parameter

Mengembalikan

Pengecualian

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: