UdpClient.Send Methode

Definition

Namespace:

System.Net.Sockets

Assemblys:

netstandard.dll, System.Net.Sockets.dll

Sendet ein UDP-Datagramm an einen Remotehost.

Überlädt

Name	Beschreibung
Send(Byte[], Int32, String, Int32)	Sendet ein UDP-Datagramm an einen angegebenen Port auf einem angegebenen Remotehost.
Send(ReadOnlySpan<Byte>, String, Int32)	Sendet ein UDP-Datagramm an einen angegebenen Port auf einem angegebenen Remotehost.
Send(Byte[], Int32, IPEndPoint)	Sendet ein UDP-Datagramm an den Host am angegebenen Remoteendpunkt.
Send(Byte[], Int32)	Sendet ein UDP-Datagramm an einen Remotehost.
Send(ReadOnlySpan<Byte>)	Sendet ein UDP-Datagramm an einen Remotehost.
Send(ReadOnlySpan<Byte>, IPEndPoint)	Sendet ein UDP-Datagramm an den Host am angegebenen Remoteendpunkt.

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

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an einen angegebenen Port auf einem angegebenen Remotehost.

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

Parameter

dgram

Byte[]

Ein Array vom Typ Byte , das das UDP-Datagramm angibt, das Als Bytearray dargestellt werden soll.

bytes

Int32

Die Anzahl der Bytes im Datagramm.

hostname

String

Der Name des Remotehosts, an den Sie das Datagramm senden möchten.

port

Int32

Die Remoteportnummer, mit der Sie kommunizieren möchten.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

ArgumentNullException

dgram ist null.

InvalidOperationException

Der UdpClient Standard-Remotehost wurde bereits eingerichtet.

ObjectDisposedException

Das UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Beispiel wird die Send Methode veranschaulicht. In diesem Beispiel wird ein Hostname und eine Portnummer verwendet, um den Zielhost zu identifizieren.

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

Hinweise

Die Send Methode sendet Datagramme an die durch die hostname Parameter angegebenen Werte und port gibt die Anzahl der erfolgreich gesendeten Bytes zurück. Sie können Datagramme an die Standardübertragungsadresse senden, indem Sie für den hostname Parameterwert "255.255.255.255" angeben.

Wenn Sie Datagramme an eine andere Übertragungsadresse senden möchten, verwenden Sie die Client Methode, um die zugrunde liegende Socketabzurufen, und legen Sie die Socketoption auf SocketOptionName.Broadcast. Sie können auch die Verwendung der Socket Klasse wiederherstellen.

Hinweis

Geben Sie dieser Methode keinen Hostnamen oder eine Portnummer an, wenn Sie bereits einen Remotehost mit der Connect Methode eingerichtet haben. Wenn Sie dies tun, löst die Send Methode ein SocketException. Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, können Sie sich in der Windows Sockets Version 2-API-Fehlercodedokumentation um eine detaillierte Beschreibung des Fehlers informieren.

Weitere Informationen

• Broadcast
• Connect(String, Int32)
• Socket

Send(ReadOnlySpan<Byte>, String, Int32)

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an einen angegebenen Port auf einem angegebenen Remotehost.

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>

Ein ReadOnlySpan<T> Typ Byte , der das UDP-Datagramm angibt, das Sie senden möchten.

hostname

String

Der Name des Remotehosts, an den Sie das Datagramm senden möchten.

port

Int32

Die Remoteportnummer, mit der Sie kommunizieren möchten.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

InvalidOperationException

Der UdpClient Standard-Remotehost wurde bereits eingerichtet.

ObjectDisposedException

Das UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.

Send(Byte[], Int32, IPEndPoint)

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an den Host am angegebenen Remoteendpunkt.

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

Parameter

dgram

Byte[]

Ein Array vom Typ Byte , das das UDP-Datagramm angibt, das Sie senden möchten, dargestellt als Bytearray.

bytes

Int32

Die Anzahl der Bytes im Datagramm.

endPoint

IPEndPoint

Ein IPEndPoint Wert, der den Host und den Port darstellt, an den das Datagramm gesendet werden soll.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

ArgumentNullException

dgram ist null.

InvalidOperationException

UdpClient hat bereits einen Standard-Remotehost eingerichtet.

ObjectDisposedException

UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Beispiel wird die Send Methode veranschaulicht. In diesem Beispiel wird ein IPEndPoint Zielhost angegeben.

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

Hinweise

Die Send Methode sendet Datagramme an den angegebenen Endpunkt und gibt die Anzahl der erfolgreich gesendeten Bytes zurück. Bevor Sie diese Überladung aufrufen, müssen Sie zuerst eine IPEndPoint Verwendung der IP-Adresse und der Portnummer des Remotehosts erstellen, an den Ihre Datagramme übermittelt werden. Sie können Datagramme an die Standardübertragungsadresse 255.255.255.255 senden, indem SocketOptionName.Broadcast Sie die Address Eigenschaft der .IPEndPoint Nachdem Sie dies IPEndPointerstellt haben, übergeben Sie sie als Parameter an die SendendPoint Methode.

Wenn Sie Datagramme an eine andere Übertragungsadresse senden möchten, verwenden Sie die Client Methode, um die zugrunde liegende Socketabzurufen, und legen Sie die Socketoption auf SocketOptionName.Broadcast. Sie können auch die Verwendung der Socket Klasse wiederherstellen.

Hinweis

Geben endPoint Sie für diese Methode keinen Parameter an, wenn Sie bereits einen Remotehost mit der Connect Methode eingerichtet haben. Wenn Sie dies tun, löst die Send Methode ein SocketException. Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, können Sie sich in der Windows Sockets Version 2-API-Fehlercodedokumentation um eine detaillierte Beschreibung des Fehlers informieren.

Weitere Informationen

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

Send(Byte[], Int32)

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an einen Remotehost.

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[]

Ein Array vom Typ Byte , das das UDP-Datagramm angibt, das Als Bytearray dargestellt werden soll.

bytes

Int32

Die Anzahl der Bytes im Datagramm.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

ArgumentNullException

dgram ist null.

InvalidOperationException

Der UdpClient Standard-Remotehost wurde bereits eingerichtet.

ObjectDisposedException

Das UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.

Beispiele

Im folgenden Beispiel wird die Send Methode veranschaulicht. Sie müssen einen Standard-Remotehost einrichten, bevor Sie diese Überladung verwenden.

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

Hinweise

Diese Überladung sendet Datagramme an den Remotehost, der in der Connect Methode eingerichtet wurde, und gibt die Anzahl der gesendeten Bytes zurück. Wenn Sie diese Überladung nicht aufrufen Connect , löst die Send Methode eine SocketException. Wenn Sie einen SocketException, verwenden, SocketException.ErrorCode um den spezifischen Fehlercode zu erhalten. Nachdem Sie diesen Code erhalten haben, können Sie sich in der Windows Sockets Version 2-API-Fehlercodedokumentation um eine detaillierte Beschreibung des Fehlers informieren.

Wenn Sie Datagramme an einen anderen Remotehost senden möchten, müssen Sie die Connect Methode aufrufen und den gewünschten Remotehost angeben. Verwenden Sie eine der anderen Send Methodenüberladungen, um Datagramme an eine Übertragungsadresse zu senden.

Weitere Informationen

• Connect(String, Int32)

Send(ReadOnlySpan<Byte>)

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an einen Remotehost.

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>

Ein ReadOnlySpan<T> Typ Byte , der das UDP-Datagramm angibt, das Sie senden möchten.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

InvalidOperationException

Der UdpClient Standard-Remotehost wurde nicht eingerichtet.

ObjectDisposedException

Das UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.

Send(ReadOnlySpan<Byte>, IPEndPoint)

Quelle:

UDPClient.cs

Sendet ein UDP-Datagramm an den Host am angegebenen Remoteendpunkt.

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>

Ein ReadOnlySpan<T> Typ Byte , der das UDP-Datagramm angibt, das Sie senden möchten.

endPoint

IPEndPoint

Ein IPEndPoint Wert, der den Host und den Port darstellt, an den das Datagramm gesendet werden soll.

Gibt zurück

Int32

Die Anzahl der gesendeten Bytes.

Ausnahmen

InvalidOperationException

UdpClient hat bereits einen Standard-Remotehost eingerichtet und endPoint ist nicht null.

ObjectDisposedException

UdpClient ist geschlossen.

SocketException

Fehler beim Zugriff auf den Socket.