UdpClient.Send Metodo

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

netstandard.dll, System.Net.Sockets.dll

Invia un datagramma UDP a un host remoto.

Overload

Nome	Descrizione
Send(Byte[], Int32, String, Int32)	Invia un datagramma UDP a una porta specificata in un host remoto specificato.
Send(ReadOnlySpan<Byte>, String, Int32)	Invia un datagramma UDP a una porta specificata in un host remoto specificato.
Send(Byte[], Int32, IPEndPoint)	Invia un datagramma UDP all'host nell'endpoint remoto specificato.
Send(Byte[], Int32)	Invia un datagramma UDP a un host remoto.
Send(ReadOnlySpan<Byte>)	Invia un datagramma UDP a un host remoto.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Invia un datagramma UDP all'host nell'endpoint remoto specificato.

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

Origine:

UDPClient.cs

Invia un datagramma UDP a una porta specificata in un host remoto specificato.

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

Parametri

dgram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP che si intende inviare come matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

hostname

String

Nome dell'host remoto a cui si intende inviare il datagramma.

port

Int32

Numero di porta remota con cui si intende comunicare.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

Ha UdpClient già stabilito un host remoto predefinito.

ObjectDisposedException

L'oggetto UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato il Send metodo . Questo esempio usa un nome host e un numero di porta per identificare l'host di destinazione.

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

Commenti

Il Send metodo invia datagrammi ai valori specificati dai hostname parametri e port e restituisce il numero di byte inviati correttamente. È possibile inviare datagrammi all'indirizzo di trasmissione predefinito specificando "255.255.255.255" per il valore del hostname parametro.

Se si desidera inviare datagrammi a qualsiasi altro indirizzo di trasmissione, usare il Client metodo per ottenere l'oggetto sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast. È anche possibile ripristinare l'uso della Socket classe .

Annotazioni

Non specificare un nome host o un numero di porta a questo metodo se è già stato stabilito un host remoto con il Connect metodo . In questo caso, il Send metodo genererà un'eccezione SocketException. Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

Origine:

UDPClient.cs

Invia un datagramma UDP a una porta specificata in un host remoto specificato.

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

Parametri

datagram

ReadOnlySpan<Byte>

Oggetto ReadOnlySpan<T> di tipo Byte che specifica il datagramma UDP che si intende inviare.

hostname

String

Nome dell'host remoto a cui si intende inviare il datagramma.

port

Int32

Numero di porta remota con cui si intende comunicare.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

InvalidOperationException

Ha UdpClient già stabilito un host remoto predefinito.

ObjectDisposedException

L'oggetto UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Send(Byte[], Int32, IPEndPoint)

Origine:

UDPClient.cs

Invia un datagramma UDP all'host nell'endpoint remoto specificato.

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

Parametri

dgram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP che si intende inviare, rappresentato come matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

endPoint

IPEndPoint

Oggetto IPEndPoint che rappresenta l'host e la porta a cui inviare il datagramma.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito.

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato il Send metodo . In questo esempio viene usato un IPEndPoint oggetto per specificare l'host di destinazione.

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

Commenti

Il Send metodo invia i datagrammi all'endpoint specificato e restituisce il numero di byte inviati correttamente. Prima di chiamare questo overload, è necessario creare un IPEndPoint oggetto usando l'indirizzo IP e il numero di porta dell'host remoto a cui verranno recapitati i datagrammi. È possibile inviare datagrammi all'indirizzo di trasmissione predefinito, 255.255.255.255, specificando SocketOptionName.Broadcast per la Address proprietà di IPEndPoint. Dopo aver creato questo IPEndPointoggetto , passarlo al Send metodo come endPoint parametro .

Se si desidera inviare datagrammi a qualsiasi altro indirizzo di trasmissione, usare il Client metodo per ottenere l'oggetto sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast. È anche possibile ripristinare l'uso della Socket classe .

Annotazioni

Non fornire un endPoint parametro a questo metodo se è già stato stabilito un host remoto con il Connect metodo . In questo caso, il Send metodo genererà un'eccezione SocketException. Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

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

Send(Byte[], Int32)

Origine:

UDPClient.cs

Invia un datagramma 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

Parametri

dgram

Byte[]

Matrice di tipo Byte che specifica il datagramma UDP che si intende inviare come matrice di byte.

bytes

Int32

Numero di byte nel datagramma.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

ArgumentNullException

dgram è null.

InvalidOperationException

Ha UdpClient già stabilito un host remoto predefinito.

ObjectDisposedException

L'oggetto UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato il Send metodo . È necessario stabilire un host remoto predefinito prima di usare questo overload.

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

Commenti

Questo overload invia i datagrammi all'host remoto stabilito nel Connect metodo e restituisce il numero di byte inviati. Se non si chiama prima di chiamare Connect questo overload, il Send metodo genererà un'eccezione SocketException. Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Se si desidera inviare datagrammi a un host remoto diverso, è necessario chiamare il Connect metodo e specificare l'host remoto desiderato. Usare uno degli altri Send overload del metodo per inviare datagrammi a un indirizzo di trasmissione.

Vedi anche

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

Origine:

UDPClient.cs

Invia un datagramma 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

Parametri

datagram

ReadOnlySpan<Byte>

Oggetto ReadOnlySpan<T> di tipo Byte che specifica il datagramma UDP che si intende inviare.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

InvalidOperationException

Non UdpClient è stato stabilito un host remoto predefinito.

ObjectDisposedException

L'oggetto UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.

Send(ReadOnlySpan<Byte>, IPEndPoint)

Origine:

UDPClient.cs

Invia un datagramma UDP all'host nell'endpoint remoto specificato.

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

Parametri

datagram

ReadOnlySpan<Byte>

Oggetto ReadOnlySpan<T> di tipo Byte che specifica il datagramma UDP che si intende inviare.

endPoint

IPEndPoint

Oggetto IPEndPoint che rappresenta l'host e la porta a cui inviare il datagramma.

Restituisce

Int32

Numero di byte inviati.

Eccezioni

InvalidOperationException

UdpClient ha già stabilito un host remoto predefinito e endPoint non nullè .

ObjectDisposedException

UdpClient è chiuso.

SocketException

Si è verificato un errore durante l'accesso al socket.