Compartir vía

UdpClient.Send Método

  • Referencia

Definición

Espacio de nombres:
System.Net.Sockets
Ensamblado:
System.Net.Sockets.dll
Ensamblado:
System.dll
Ensamblado:
netstandard.dll

Envía un datagrama UDP a un host remoto.

Sobrecargas

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

Envía un datagrama UDP a un puerto específico en un host remoto especificado.
Send(ReadOnlySpan<Byte>, String, Int32)

Envía un datagrama UDP a un puerto específico en un host remoto especificado.
Send(Byte[], Int32, IPEndPoint)

Envía un datagrama UDP al host en el punto de conexión remoto especificado.
Send(Byte[], Int32)

Envía un datagrama UDP a un host remoto.
Send(ReadOnlySpan<Byte>)

Envía un datagrama UDP a un host remoto.
Send(ReadOnlySpan<Byte>, IPEndPoint)

Envía un datagrama UDP al host en el punto de conexión remoto especificado.

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

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP a un puerto específico en un host remoto especificado.

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

Parámetros

dgram
Byte[]

Matriz de tipo Byte que especifica el datagrama UDP que quiere enviar, representado como una matriz de bytes.

bytes
Int32

Número de bytes del datagrama.

hostname
String

Nombre del host remoto al que pretende enviar el datagrama.

port
Int32

Número de puerto remoto con el que quiere comunicarse.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

ArgumentNullException

dgram es null.

InvalidOperationException

La clase UdpClient ya estableció un host remoto predeterminado.

ObjectDisposedException

La clase UdpClient está cerrada.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el siguiente ejemplo se muestra el Send método. En este ejemplo se usa un nombre de host y un número de puerto para identificar el host de destino.

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

Comentarios

El Send método envía datagramas a los valores especificados por los hostname parámetros y port y devuelve el número de bytes enviados correctamente. Puede enviar datagramas a la dirección de difusión predeterminada especificando "255.255.255.255" para el valor del hostname parámetro.

Si desea enviar datagramas a cualquier otra dirección de difusión, use el Client método para obtener el subyacente Sockety establezca la opción SocketOptionName.Broadcastde socket en . También puede revertir al uso de la Socket clase .

Nota

No proporcione un nombre de host o un número de puerto a este método si ya ha establecido un host remoto con el Connect método . Si lo hace, el Send método producirá una SocketExceptionexcepción . Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

Se aplica a

Send(ReadOnlySpan<Byte>, String, Int32)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP a un puerto específico en un host remoto especificado.

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

Parámetros

datagram
ReadOnlySpan<Byte>

de ReadOnlySpan<T> tipo Byte que especifica el datagrama UDP que se va a enviar.

hostname
String

Nombre del host remoto al que pretende enviar el datagrama.

port
Int32

Número de puerto remoto con el que quiere comunicarse.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

InvalidOperationException

La clase UdpClient ya estableció un host remoto predeterminado.

ObjectDisposedException

La clase UdpClient está cerrada.

SocketException

Se produjo un error al acceder al socket.

Se aplica a

Send(Byte[], Int32, IPEndPoint)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP al host en el punto de conexión remoto especificado.

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

Parámetros

dgram
Byte[]

Matriz de tipo Byte que especifica el datagrama UDP que quiere enviar, representado como una matriz de bytes.

bytes
Int32

Número de bytes del datagrama.

endPoint
IPEndPoint

IPEndPoint que representa el host y el puerto al que se va a enviar el datagrama.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

ArgumentNullException

dgram es null.

InvalidOperationException

UdpClient ya ha establecido un host remoto predeterminado.

ObjectDisposedException

UdpClient está cerrado.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el siguiente ejemplo se muestra el Send método. En este ejemplo se usa un IPEndPoint para especificar el host de destino.

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

Comentarios

El Send método envía datagramas al punto de conexión especificado y devuelve el número de bytes enviados correctamente. Antes de llamar a esta sobrecarga, primero debe crear un IPEndPoint mediante la dirección IP y el número de puerto del host remoto al que se entregarán los datagramas. Puede enviar datagramas a la dirección de difusión predeterminada, 255.255.255.255, especificando SocketOptionName.Broadcast para la Address propiedad de IPEndPoint. Después de crear este IPEndPoint, páselo al Send método como parámetro endPoint .

Si desea enviar datagramas a cualquier otra dirección de difusión, use el Client método para obtener el subyacente Sockety establezca la opción SocketOptionName.Broadcastde socket en . También puede revertir al uso de la Socket clase .

Nota

No proporcione un endPoint parámetro a este método si ya ha establecido un host remoto con el Connect método . Si lo hace, el Send método producirá una SocketExceptionexcepción . Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Consulte también

Se aplica a

Send(Byte[], Int32)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP a un host remoto.

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

Parámetros

dgram
Byte[]

Matriz de tipo Byte que especifica el datagrama UDP que quiere enviar, representado como una matriz de bytes.

bytes
Int32

Número de bytes del datagrama.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

ArgumentNullException

dgram es null.

InvalidOperationException

La clase UdpClient ya estableció un host remoto predeterminado.

ObjectDisposedException

La clase UdpClient está cerrada.

SocketException

Se produjo un error al acceder al socket.

Ejemplos

En el siguiente ejemplo se muestra el Send método. Debe establecer un host remoto predeterminado antes de usar esta sobrecarga.

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

Comentarios

Esta sobrecarga envía datagramas al host remoto establecido en el Connect método y devuelve el número de bytes enviados. Si no llama a Connect antes de llamar a esta sobrecarga, el Send método producirá una SocketExceptionexcepción . Si recibe un SocketException, use SocketException.ErrorCode para obtener el código de error específico. Una vez que haya obtenido este código, puede consultar la documentación del código de error de la API de Windows Sockets versión 2 para obtener una descripción detallada del error.

Si desea enviar datagramas a un host remoto diferente, debe llamar al Connect método y especificar el host remoto deseado. Use cualquiera de las demás Send sobrecargas de método para enviar datagramas a una dirección de difusión.

Consulte también

Se aplica a

Send(ReadOnlySpan<Byte>)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP a un host remoto.

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

Parámetros

datagram
ReadOnlySpan<Byte>

de ReadOnlySpan<T> tipo Byte que especifica el datagrama UDP que se va a enviar.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

InvalidOperationException

no UdpClient ha establecido un host remoto predeterminado.

ObjectDisposedException

La clase UdpClient está cerrada.

SocketException

Se produjo un error al acceder al socket.

Se aplica a

Send(ReadOnlySpan<Byte>, IPEndPoint)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
UDPClient.cs

Envía un datagrama UDP al host en el punto de conexión remoto especificado.

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

Parámetros

datagram
ReadOnlySpan<Byte>

de ReadOnlySpan<T> tipo Byte que especifica el datagrama UDP que se va a enviar.

endPoint
IPEndPoint

IPEndPoint que representa el host y el puerto al que se va a enviar el datagrama.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

InvalidOperationException

UdpClient ya ha establecido un host remoto predeterminado y endPoint no nulles .

ObjectDisposedException

UdpClient está cerrado.

SocketException

Se produjo un error al acceder al socket.

Se aplica a