UdpClient.Send Método

Definición

Espacio de nombres:

System.Net.Sockets

Ensamblados:

netstandard.dll, System.Net.Sockets.dll

Envía un datagrama UDP a un host remoto.

Sobrecargas

Nombre	Description
Send(Byte[], Int32, String, Int32)	Envía un datagrama UDP a un puerto especificado en un host remoto especificado.
Send(ReadOnlySpan<Byte>, String, Int32)	Envía un datagrama UDP a un puerto especificado 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

Envía un datagrama UDP a un puerto especificado 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);

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 se va a enviar representado como una matriz de bytes.

bytes

Int32

Número de bytes en el datagrama.

hostname

String

Nombre del host remoto al que desea 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

ya UdpClient ha establecido un host remoto predeterminado.

ObjectDisposedException

UdpClient Está cerrado.

SocketException

Error al acceder al socket.

Ejemplos

En el ejemplo siguiente 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 = 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 método para obtener el Client 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

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

Source:

UDPClient.cs

Envía un datagrama UDP a un puerto especificado 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 desea enviar el datagrama.

port

Int32

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

Devoluciones

Int32

Número de bytes enviados.

Excepciones

InvalidOperationException

ya UdpClient ha establecido un host remoto predeterminado.

ObjectDisposedException

UdpClient Está cerrado.

SocketException

Error al acceder al socket.

Send(Byte[], Int32, IPEndPoint)

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);

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 se va a enviar, representado como una matriz de bytes.

bytes

Int32

Número de bytes en el datagrama.

endPoint

IPEndPoint

que IPEndPoint 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

Error al acceder al socket.

Ejemplos

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

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 método para obtener el Client 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

• Broadcast
• Connect(String, Int32)
• Socket
• IPEndPoint

Send(Byte[], Int32)

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 se va a enviar representado como una matriz de bytes.

bytes

Int32

Número de bytes en el datagrama.

Devoluciones

Int32

Número de bytes enviados.

Excepciones

ArgumentNullException

dgram es null.

InvalidOperationException

ya UdpClient ha establecido un host remoto predeterminado.

ObjectDisposedException

UdpClient Está cerrado.

SocketException

Error al acceder al socket.

Ejemplos

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

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 Connect a 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 otras Send sobrecargas de método para enviar datagramas a una dirección de difusión.

Consulte también

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

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

UdpClient Está cerrado.

SocketException

Error al acceder al socket.

Send(ReadOnlySpan<Byte>, IPEndPoint)

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

que IPEndPoint 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

Error al acceder al socket.