UdpClient.Send Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Net.Sockets

Zestaw:: System.Net.Sockets.dll

Zestaw:: System.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Wysyła datagram UDP do hosta zdalnego.

Przeciążenia

Send(Byte[], Int32, String, Int32)	Wysyła datagram UDP do określonego portu na określonym hoście zdalnym.
Send(ReadOnlySpan<Byte>, String, Int32)	Wysyła datagram UDP do określonego portu na określonym hoście zdalnym.
Send(Byte[], Int32, IPEndPoint)	Wysyła datagram UDP do hosta w określonym zdalnym punkcie końcowym.
Send(Byte[], Int32)	Wysyła datagram UDP do hosta zdalnego.
Send(ReadOnlySpan<Byte>)	Wysyła datagram UDP do hosta zdalnego.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Wysyła datagram UDP do hosta w określonym zdalnym punkcie końcowym.

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

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do określonego portu na określonym hoście zdalnym.

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

Parametry

dgram: Byte[]

Tablica typu Byte określająca datagram UDP, który ma być wysyłany jako tablica bajtów.

bytes: Int32

Liczba bajtów w datagramie.

hostname: String

Nazwa hosta zdalnego, do którego zamierzasz wysłać datagram.

port: Int32

Numer portu zdalnego, z którym zamierzasz się komunikować.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

ArgumentNullException

dgram to null.

InvalidOperationException

Element UdpClient już ustanowił domyślny host zdalny.

ObjectDisposedException

Element UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano metodę Send . W tym przykładzie użyto nazwy hosta i numeru portu w celu zidentyfikowania hosta docelowego.

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

Uwagi

Metoda Send wysyła datagramy do wartości określonych przez hostname parametry i port i i zwraca liczbę bajtów pomyślnie wysłanych. Datagramy można wysyłać do domyślnego adresu emisji, określając wartość parametru hostname "255.255.255.255".

Jeśli chcesz wysłać datagramy do dowolnego innego adresu emisji, użyj Client metody , aby uzyskać bazowy Socketelement , i ustaw opcję gniazda na SocketOptionName.Broadcast. Możesz również przywrócić klasę Socket .

Uwaga

Nie należy podawać nazwy hosta ani numeru portu do tej metody, jeśli host zdalny został już ustanowiony za pomocą Connect metody . Jeśli to zrobisz, Send metoda zgłosi błąd SocketException. Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

Dotyczy

Send(ReadOnlySpan<Byte>, String, Int32)

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do określonego portu na określonym hoście zdalnym.

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

Parametry

datagram: ReadOnlySpan<Byte>

Byte Typ ReadOnlySpan<T> określający datagram UDP, który ma być wysyłany.

hostname: String

Nazwa hosta zdalnego, do którego zamierzasz wysłać datagram.

port: Int32

Numer portu zdalnego, z którym zamierzasz się komunikować.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

InvalidOperationException

Element UdpClient już ustanowił domyślny host zdalny.

ObjectDisposedException

Element UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Dotyczy

Send(Byte[], Int32, IPEndPoint)

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do hosta w określonym zdalnym punkcie końcowym.

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

Parametry

dgram: Byte[]

Tablica typu Byte określająca datagram UDP, który ma być wysyłany, reprezentowany jako tablica bajtów.

bytes: Int32

Liczba bajtów w datagramie.

endPoint: IPEndPoint

Element IPEndPoint reprezentujący hosta i port, do którego ma być wysyłany datagram.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

ArgumentNullException

dgram to null.

InvalidOperationException

UdpClient już nawiązał domyślny host zdalny.

ObjectDisposedException

UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano metodę Send . W tym przykładzie użyto elementu do IPEndPoint określenia hosta docelowego.

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

Uwagi

Metoda Send wysyła datagramy do określonego punktu końcowego i zwraca liczbę bajtów pomyślnie wysłanych. Przed wywołaniem tego przeciążenia należy najpierw utworzyć IPEndPoint przy użyciu adresu IP i numeru portu hosta zdalnego, do którego zostaną dostarczone twoje datagramy. Datagramy można wysyłać do domyślnego adresu emisji 255.255.255.255, określając SocketOptionName.Broadcast właściwość Address IPEndPoint. Po utworzeniu Send tej IPEndPointmetody przekaż ją do metody jako parametru endPoint .

Uwaga

Nie należy podać parametru endPoint tej metody, jeśli host zdalny został już ustanowiony za pomocą Connect metody . Jeśli to zrobisz, Send metoda zgłosi błąd SocketException. Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

Dotyczy

Send(Byte[], Int32)

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do hosta zdalnego.

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

Parametry

dgram: Byte[]

Tablica typu Byte określająca datagram UDP, który ma być wysyłany jako tablica bajtów.

bytes: Int32

Liczba bajtów w datagramie.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

ArgumentNullException

dgram to null.

InvalidOperationException

Element UdpClient już ustanowił domyślny host zdalny.

ObjectDisposedException

Element UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano metodę Send . Przed użyciem tego przeciążenia należy ustanowić domyślny host zdalny.

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

Uwagi

To przeciążenie wysyła datagramy do hosta zdalnego ustanowionego Connect w metodzie i zwraca liczbę wysłanych bajtów. Jeśli nie wywołasz wywołania Connect tego przeciążenia przed wywołaniem tego przeciążenia, Send metoda zgłosi błąd SocketException. Jeśli zostanie wyświetlony komunikat SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API gniazd systemu Windows w wersji 2 , aby uzyskać szczegółowy opis błędu.

Jeśli chcesz wysłać datagramy do innego hosta zdalnego, musisz wywołać metodę Connect i określić żądany host zdalny. Użyj jednego z innych Send przeciążeń metody, aby wysyłać datagramy do adresu emisji.

Zobacz też

Connect(String, Int32)

Dotyczy

Send(ReadOnlySpan<Byte>)

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do hosta zdalnego.

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

Parametry

datagram: ReadOnlySpan<Byte>

Byte Typ ReadOnlySpan<T> określający datagram UDP, który ma być wysyłany.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

InvalidOperationException

Nie UdpClient określono domyślnego hosta zdalnego.

ObjectDisposedException

Element UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Dotyczy

Send(ReadOnlySpan<Byte>, IPEndPoint)

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Źródło:: UDPClient.cs

Wysyła datagram UDP do hosta w określonym zdalnym punkcie końcowym.

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

Parametry

datagram: ReadOnlySpan<Byte>

Byte Typ ReadOnlySpan<T> określający datagram UDP, który ma być wysyłany.

endPoint: IPEndPoint

Element IPEndPoint reprezentujący hosta i port, do którego ma być wysyłany datagram.

Zwraca

Int32

Liczba wysłanych bajtów.

Wyjątki

InvalidOperationException

UdpClient już ustanowić domyślny host zdalny i endPoint nie nulljest .

ObjectDisposedException

UdpClient jest zamknięty.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Dotyczy

UdpClient.Send Metoda

Definicja

Przeciążenia

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

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Send(ReadOnlySpan<Byte>, String, Int32)

Parametry

Zwraca

Wyjątki

Dotyczy

Send(Byte[], Int32, IPEndPoint)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Send(Byte[], Int32)

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Send(ReadOnlySpan<Byte>)

Parametry

Zwraca

Wyjątki

Dotyczy

Send(ReadOnlySpan<Byte>, IPEndPoint)

Parametry

Zwraca

Wyjątki

Dotyczy

Opinia

Dodatkowe zasoby