UdpClient Konstruktoren

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

Quelle:

UDPClient.cs

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Ausnahmen

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.

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.

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 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.

Dieser Konstruktor funktioniert nur mit IPv4-Adresstypen.

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 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.

Weitere Informationen

• IPEndPoint

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-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.

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

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 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.

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 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.

Weitere Informationen

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