UdpClient Konstruktoren

Definition

Namespace:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Initialisiert eine neue Instanz der UdpClient-Klasse.

Überlädt

UdpClient()	Initialisiert eine neue Instanz der UdpClient-Klasse.
UdpClient(Int32)	Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an die angegebene lokale Anschlussnummer.
UdpClient(IPEndPoint)	Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an den angegebenen lokalen Endpunkt.
UdpClient(AddressFamily)	Initialisiert eine neue Instanz der UdpClient-Klasse.
UdpClient(Int32, AddressFamily)	Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an die angegebene lokale Anschlussnummer.
UdpClient(String, Int32)	Initialisiert eine neue Instanz der UdpClient-Klasse und richtet einen Standardremotehost ein.

UdpClient()

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse.

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Ausnahmen

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie der parameterlose Konstruktor verwendet wird, um eine instance der UdpClient -Klasse zu erstellen.

//Creates an instance of the UdpClient class using the default constructor.
UdpClient^ udpClient = gcnew UdpClient;

//Creates an instance of the UdpClient class using the default constructor.
UdpClient udpClient = new UdpClient();

'Creates an instance of the UdpClient class using the default constructor.
Dim udpClient As New UdpClient()

Hinweise

Dieser Konstruktor erstellt eine neue UdpClient und ermöglicht es dem zugrunde liegenden Dienstanbieter, die am besten geeignete lokale IPv4-Adresse und Portnummer zuzuweisen. Wenn dieser Konstruktor verwendet wird, wird der UdpClient instance mit einer Adressfamilie von IPv4 festgelegt, die nicht durch einen Verbindungsmethodenaufruf mit einem IPv6-Ziel geändert oder überschrieben werden kann.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Dieser Konstruktor eignet sich nicht für das Verknüpfen einer Multicastgruppe, da er keine Socketbindung ausführt. Außerdem funktioniert es nur mit IPv4-Adresstypen.

UdpClient(Int32)

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an die angegebene lokale Anschlussnummer.

public:
 UdpClient(int port);

public UdpClient (int port);

new System.Net.Sockets.UdpClient : int -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer)

Parameter

port

Int32

Die Nummer des lokalen Anschlusses, über den die Kommunikation stattfinden soll.

Ausnahmen

ArgumentOutOfRangeException

Der port-Parameter ist größer als MaxPort oder kleiner als MinPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung einer lokalen Portnummer zum Erstellen einer instance der UdpClient -Klasse.

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try
{
   UdpClient^ udpClient = gcnew UdpClient( 11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class to listen on
// the default interface using a particular port.
try{
         UdpClient udpClient = new UdpClient(11000);
}
catch (Exception e ) {
          Console.WriteLine(e.ToString());
  }

'Creates an instance of the UdpClient class to listen on 
'the default interface using a particular port.
Try
   Dim udpClient As New UdpClient(11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Dieser Konstruktor erstellt einen zugrunde liegenden Socket und bindet ihn an die Portnummer, von der aus Sie kommunizieren möchten. Verwenden Sie diesen Konstruktor, wenn Sie nur die lokale Portnummer festlegen möchten. Der zugrunde liegende Dienstanbieter weist die lokale IP-Adresse zu. Wenn Sie 0 an den Konstruktor übergeben, weist der zugrunde liegende Dienstanbieter eine Portnummer zu. Wenn dieser Konstruktor verwendet wird, wird der UdpClient instance mit einer Adressfamilie von IPv4 festgelegt, die nicht durch einen Verbindungsmethodenaufruf mit einem IPv6-Ziel geändert oder überschrieben werden kann.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Dieser Konstruktor funktioniert nur mit IPv4-Adresstypen.

UdpClient(IPEndPoint)

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an den angegebenen lokalen Endpunkt.

public:
 UdpClient(System::Net::IPEndPoint ^ localEP);

public UdpClient (System.Net.IPEndPoint localEP);

new System.Net.Sockets.UdpClient : System.Net.IPEndPoint -> System.Net.Sockets.UdpClient

Public Sub New (localEP As IPEndPoint)

Parameter

localEP

IPEndPoint

Ein IPEndPoint, der den lokalen Endpunkt darstellt, an den Sie die UDP-Verbindung binden.

Ausnahmen

ArgumentNullException

localEP ist null.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine instance der UdpClient -Klasse mithilfe eines lokalen Endpunkts erstellt wird.

//Creates an instance of the UdpClient class using a local endpoint.
IPAddress^ ipAddress = Dns::Resolve( Dns::GetHostName() )->AddressList[ 0 ];
IPEndPoint^ ipLocalEndPoint = gcnew IPEndPoint( ipAddress,11000 );

try
{
   UdpClient^ udpClient = gcnew UdpClient( ipLocalEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class using a local endpoint.
 IPAddress ipAddress = Dns.Resolve(Dns.GetHostName()).AddressList[0];
 IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 11000);

try{
     UdpClient udpClient = new UdpClient(ipLocalEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class using a local endpoint.
Dim ipAddress As IPAddress = Dns.Resolve(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 11000)

Try
   Dim udpClient As New UdpClient(ipLocalEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Dieser Konstruktor erstellt eine neue UdpClient und bindet ihn an die IPEndPoint durch den localEP -Parameter angegebene. Bevor Sie diesen Konstruktor aufrufen, müssen Sie eine IPEndPoint mit der IP-Adresse und Portnummer erstellen, von der Sie Daten senden und empfangen möchten. Sie müssen keine lokale IP-Adresse und Portnummer für das Senden und Empfangen von Daten angeben. Andernfalls weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale IP-Adresse und Portnummer zu.

Wenn dieser Konstruktor verwendet wird, wird der UdpClient instance mit der durch den Parameter angegebenen Adressfamilie festgelegt, die localEP nicht durch einen Verbindungsmethodenaufruf mit einer anderen Adressfamilie geändert oder überschrieben werden kann.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Weitere Informationen

• IPEndPoint

UdpClient(AddressFamily)

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse.

public:
 UdpClient(System::Net::Sockets::AddressFamily family);

public UdpClient (System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (family As AddressFamily)

Parameter

family

AddressFamily

Einer der AddressFamily-Werte, der das Adressierungsschema für den Socket angibt.

Ausnahmen

ArgumentException

family ist nicht InterNetwork oder InterNetworkV6.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Hinweise

Der family Parameter bestimmt, ob der Listener eine IP-Adresse der Version 4 (IPv4) oder eine IP-Adresse der Version 6 (IPv6) verwendet. Um eine IPv4-Adresse zu verwenden, übergeben Sie den InterNetwork Wert. Um eine IPv6-Adresse zu verwenden, übergeben Sie den InterNetworkV6 Wert. Das Übergeben eines anderen Werts führt dazu, dass die -Methode einen ArgumentExceptionauslöst.

Wenn dieser Konstruktor verwendet wird, wird der UdpClient instance mit der durch den Parameter angegebenen Adressfamilie festgelegt, die family nicht durch einen Verbindungsmethodenaufruf mit einer anderen Adressfamilie geändert oder überschrieben werden kann.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Eignet UdpClient.UdpClient(AddressFamily) sich nicht für das Verknüpfen einer Multicastgruppe, da keine Socketbindung ausgeführt wird.

UdpClient(Int32, AddressFamily)

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse und bindet sie an die angegebene lokale Anschlussnummer.

public:
 UdpClient(int port, System::Net::Sockets::AddressFamily family);

public UdpClient (int port, System.Net.Sockets.AddressFamily family);

new System.Net.Sockets.UdpClient : int * System.Net.Sockets.AddressFamily -> System.Net.Sockets.UdpClient

Public Sub New (port As Integer, family As AddressFamily)

Parameter

port

Int32

Der Anschluss, der auf eingehende Verbindungsversuche überwacht werden soll.

family

AddressFamily

Einer der AddressFamily-Werte, der das Adressierungsschema für den Socket angibt.

Ausnahmen

ArgumentException

family ist nicht InterNetwork oder InterNetworkV6.

ArgumentOutOfRangeException

port ist größer als MaxPort oder kleiner als MinPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen UDP-Client für die Verwendung in einer Multicastgruppe erstellen.

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = gcnew UdpClient( 2000,AddressFamily::InterNetworkV6 );

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.
// Transform the String* address into the internal format.
m_GrpAddr = IPAddress::Parse( "FF01::1" );

// Display the multicast address used.
Console::WriteLine( "Multicast Address: [ {0}]", m_GrpAddr );

// Exercise the use of the IPv6MulticastOption.
Console::WriteLine( "Instantiate IPv6MulticastOption(IPAddress)" );

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption^ ipv6MulticastOption = gcnew IPv6MulticastOption( m_GrpAddr );

// Store the IPAdress multicast options.
IPAddress^ group = ipv6MulticastOption->Group;
__int64 interfaceIndex = ipv6MulticastOption->InterfaceIndex;

// Display IPv6MulticastOption properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0}]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0}]", interfaceIndex );

// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption^ ipv6MulticastOption2 = gcnew IPv6MulticastOption( group,interfaceIndex );

// Store the IPAdress multicast options.
group = ipv6MulticastOption2->Group;
interfaceIndex = ipv6MulticastOption2->InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console::WriteLine( "IPv6MulticastOption::Group: [ {0} ]", group );
Console::WriteLine( "IPv6MulticastOption::InterfaceIndex: [ {0} ]", interfaceIndex );

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator->JoinMulticastGroup( (int)interfaceIndex, group );

// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = gcnew IPEndPoint( m_GrpAddr,1000 );

// Bind and listen on port 2000. This constructor creates a socket
// and binds it to the port on which to receive data. The family
// parameter specifies that this connection uses an IPv6 address.
clientOriginator = new UdpClient(2000, AddressFamily.InterNetworkV6);

// Join or create a multicast group. The multicast address ranges
// to use are specified in RFC#2375. You are free to use
// different addresses.

// Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1");

// Display the multicast address used.
Console.WriteLine("Multicast Address: [" + m_GrpAddr.ToString() + "]");

// Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)");

// Instantiate IPv6MulticastOption using one of the
// overloaded constructors.
IPv6MulticastOption ipv6MulticastOption = new IPv6MulticastOption(m_GrpAddr);

// Store the IPAdress multicast options.
IPAddress group =  ipv6MulticastOption.Group;
long interfaceIndex = ipv6MulticastOption.InterfaceIndex;

// Display IPv6MulticastOption properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");



// Instantiate IPv6MulticastOption using another
// overloaded constructor.
IPv6MulticastOption ipv6MulticastOption2 = new IPv6MulticastOption(group, interfaceIndex);

// Store the IPAdress multicast options.
group =  ipv6MulticastOption2.Group;
interfaceIndex = ipv6MulticastOption2.InterfaceIndex;

// Display the IPv6MulticastOption2 properties.
Console.WriteLine("IPv6MulticastOption.Group: [" + group  + "]");
Console.WriteLine("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex + "]");

// Join the specified multicast group using one of the
// JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup((int)interfaceIndex, group);


// Define the endpoint data port. Note that this port number
// must match the ClientTarget UDP port number which is the
// port on which the ClientTarget is receiving data.
m_ClientTargetdest = new IPEndPoint(m_GrpAddr, 1000);

' Bind and listen on port 2000. This constructor creates a socket 
' and binds it to the port on which to receive data. The family 
' parameter specifies that this connection uses an IPv6 address.
clientOriginator = New UdpClient(2000, AddressFamily.InterNetworkV6)

' Join or create a multicast group. The multicast address ranges 
' to use are specified in RFC#2375. You are free to use 
' different addresses.
' Transform the string address into the internal format.
m_GrpAddr = IPAddress.Parse("FF01::1")

' Display the multicast address used.
Console.WriteLine(("Multicast Address: [" + m_GrpAddr.ToString() + "]"))

' Exercise the use of the IPv6MulticastOption.
Console.WriteLine("Instantiate IPv6MulticastOption(IPAddress)")

' Instantiate IPv6MulticastOption using one of the 
' overloaded constructors.
Dim ipv6MulticastOption As New IPv6MulticastOption(m_GrpAddr)

' Store the IPAdress multicast options.
Dim group As IPAddress = ipv6MulticastOption.Group
Dim interfaceIndex As Long = ipv6MulticastOption.InterfaceIndex

' Display IPv6MulticastOption properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Instantiate IPv6MulticastOption using another 
' overloaded constructor.
Dim ipv6MulticastOption2 As New IPv6MulticastOption(group, interfaceIndex)

' Store the IPAdress multicast options.
group = ipv6MulticastOption2.Group
interfaceIndex = ipv6MulticastOption2.InterfaceIndex

' Display the IPv6MulticastOption2 properties.
Console.WriteLine(("IPv6MulticastOption.Group: [" + group.ToString() + "]"))
Console.WriteLine(("IPv6MulticastOption.InterfaceIndex: [" + interfaceIndex.ToString() + "]"))

' Join the specified multicast group using one of the 
' JoinMulticastGroup overloaded methods.
clientOriginator.JoinMulticastGroup(Fix(interfaceIndex), group)

' Define the endpoint data port. Note that this port number
' must match the ClientTarget UDP port number which is the
' port on which the ClientTarget is receiving data.
m_ClientTargetdest = New IPEndPoint(m_GrpAddr, 1000)

Hinweise

Dieser Konstruktor erstellt einen zugrunde liegenden Socket und bindet ihn an die Portnummer, von der aus Sie kommunizieren möchten.

Der family Parameter bestimmt, ob der Listener eine IP-Adresse der Version 4 (IPv4) oder eine IP-Adresse der Version 6 (IPv6) verwendet. Um eine IPv4-Adresse zu verwenden, übergeben Sie den InterNetwork Wert. Um eine IPv6-Adresse zu verwenden, übergeben Sie den InterNetworkV6 Wert. Das Übergeben eines anderen Werts führt dazu, dass die -Methode einen ArgumentExceptionauslöst.

Wenn dieser Konstruktor verwendet wird, wird der UdpClient instance mit der durch den Parameter angegebenen Adressfamilie festgelegt, die family nicht durch einen Verbindungsmethodenaufruf mit einer anderen Adressfamilie geändert oder überschrieben werden kann.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode eine ausführliche Beschreibung des Fehlers.

UdpClient(String, Int32)

Quelle:

UDPClient.cs

Initialisiert eine neue Instanz der UdpClient-Klasse und richtet einen Standardremotehost ein.

public:
 UdpClient(System::String ^ hostname, int port);

public UdpClient (string hostname, int port);

new System.Net.Sockets.UdpClient : string * int -> System.Net.Sockets.UdpClient

Public Sub New (hostname As String, port As Integer)

Parameter

hostname

String

Der Name des Remote-DNS-Hosts, zu dem die Verbindung hergestellt werden soll.

port

Int32

Die Nummer des Remoteanschlusses, mit dem die Verbindung hergestellt werden soll.

Ausnahmen

ArgumentNullException

hostname ist null.

ArgumentOutOfRangeException

port liegt nicht zwischen MinPort und MaxPort.

SocketException

Beim Zugreifen auf den Socket ist ein Fehler aufgetreten.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine instance der UdpClient -Klasse mithilfe eines Hostnamens und einer Portnummer erstellt wird.

//Creates an instance of the UdpClient class with a remote host name and a port number.
try
{
   UdpClient^ udpClient = gcnew UdpClient( "www.contoso.com",11000 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}

//Creates an instance of the UdpClient class with a remote host name and a port number.
try{
     UdpClient udpClient = new UdpClient("www.contoso.com",11000);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}

'Creates an instance of the UdpClient class with a remote host name and a port number.
Try
   Dim udpClient As New UdpClient("www.contoso.com", 11000)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Hinweise

Dieser Konstruktor initialisiert einen neuen UdpClient und richtet mithilfe der hostname Parameter und port einen Remotehost ein. Das Einrichten eines Standard-Remotehosts ist optional. Wenn Sie diesen Konstruktor verwenden, müssen Sie keinen Remotehost in jedem Aufruf der Send -Methode angeben. Die Angabe eines Standard-Remotehosts beschränkt Sie nur auf diesen Host. Sie können den Standard-Remotehost jederzeit ändern, indem Sie die Connect -Methode aufrufen. Wenn Sie einen Remotehost in Ihrem Aufruf der Send -Methode angeben möchten, verwenden Sie diesen Konstruktor nicht.

Hinweis

Wenn Sie einen SocketExceptionerhalten, verwenden Sie SocketException.ErrorCode , um den spezifischen Fehlercode abzurufen. Nachdem Sie diesen Code erhalten haben, finden Sie eine ausführliche Beschreibung des Fehlers in der Dokumentation zu Windows Sockets Version 2-API-Fehlercode .

Weitere Informationen

• Send(Byte[], Int32, IPEndPoint)
• Connect(String, Int32)