UdpClient Konstruktoren

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

public:
 UdpClient();

public UdpClient();

Public Sub New ()

Ausnahmen

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe des parameterlosen Konstruktors eine Instanz der UdpClient Klasse erstellen.

//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 die UdpClient Instanz mit einer Adressfamilie von IPv4 festgelegt, die nicht durch einen Verbindungsmethodenaufruf mit einem IPv6-Ziel geändert oder überschrieben werden kann.

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

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

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

Ausnahmen

Beispiele

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

//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 die UdpClient Instanz mit einer Adressfamilie von IPv4 festgelegt, die nicht durch einen Verbindungsmethodenaufruf mit einem IPv6-Ziel geändert oder überschrieben werden kann.

Dieser Konstruktor funktioniert nur mit IPv4-Adresstypen.

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

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

Ausnahmen

Beispiele

Im folgenden Beispiel wird das Erstellen einer Instanz der UdpClient Klasse mithilfe eines lokalen Endpunkts veranschaulicht.

//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 den IPEndPointlocalEP angegebenen Parameter. Bevor Sie diesen Konstruktor aufrufen, müssen Sie eine IPEndPoint Verwendung der IP-Adresse und der 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 die UdpClient Instanz mit der durch den localEP Parameter angegebenen Adressfamilie festgelegt, die nicht durch einen Verbindungsmethodenaufruf mit einer anderen Adressfamilie geändert oder überschrieben werden kann.

Weitere Informationen

• IPEndPoint

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

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

Ausnahmen

Hinweise

Der family Parameter bestimmt, ob der Listener eine IP-Version 4-Adresse (IPv4) oder eine IP-Version 6 (IPv6)-Adresse verwendet. Um eine IPv4-Adresse zu verwenden, übergeben Sie den InterNetwork Wert. Um eine IPv6-Adresse zu verwenden, übergeben Sie den InterNetworkV6 Wert. Durch das Übergeben eines anderen Werts wird die Methode ausgelöst ArgumentException.

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

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

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

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

Ausnahmen

Beispiele

Das folgende Codebeispiel zeigt, wie Sie einen UDP-Client erstellen, der in einer Multicastgruppe verwendet werden soll.

// 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-Version 4-Adresse (IPv4) oder eine IP-Version 6 (IPv6)-Adresse verwendet. Um eine IPv4-Adresse zu verwenden, übergeben Sie den InterNetwork Wert. Um eine IPv6-Adresse zu verwenden, übergeben Sie den InterNetworkV6 Wert. Durch das Übergeben eines anderen Werts wird die Methode ausgelöst ArgumentException.

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

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

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

Ausnahmen

Beispiele

Im folgenden Beispiel wird das Erstellen einer Instanz der UdpClient Klasse mithilfe eines Hostnamens und einer Portnummer veranschaulicht.

//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 einen Remotehost mithilfe der hostname parameter ein port . Das Einrichten eines Standard-Remotehosts ist optional. Wenn Sie diesen Konstruktor verwenden, müssen Sie in jedem Aufruf der Send Methode keinen Remotehost angeben. Wenn Sie einen Standard-Remotehost angeben, werden Sie nur auf diesen Host beschränkt. Sie können den Standard-Remotehost jederzeit ändern, indem Sie die Connect Methode aufrufen. Wenn Sie in Ihrem Aufruf der Send Methode einen Remotehost angeben möchten, verwenden Sie diesen Konstruktor nicht.

Weitere Informationen

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