UdpClient Constructors

public:
 UdpClient();

public UdpClient();

Public Sub New ()

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u de parameterloze constructor gebruikt om een exemplaar van de UdpClient klasse te maken.

//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()

Opmerkingen

Met deze constructor wordt een nieuwe UdpClient gemaakt en kan de onderliggende serviceprovider het meest geschikte lokale IPv4-adres en poortnummer toewijzen. Als deze constructor wordt gebruikt, wordt het UdpClient exemplaar ingesteld met een adresfamilie van IPv4 die niet kan worden gewijzigd of overschreven door een verbindingsmethodeaanroep met een IPv6-doel.

Deze constructor is niet geschikt voor het samenvoegen van een multicastgroep omdat deze geen socketbinding uitvoert. Het werkt ook alleen met IPv4-adrestypen.

public:
 UdpClient(int port);

public UdpClient(int port);

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

Public Sub New (port As Integer)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een lokaal poortnummer gebruikt om een exemplaar van de UdpClient klasse te maken.

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

Opmerkingen

Met deze constructor wordt een onderliggende Socket waarde gemaakt en gekoppeld aan het poortnummer van waaruit u wilt communiceren. Gebruik deze constructor als u alleen geïnteresseerd bent in het instellen van het lokale poortnummer. De onderliggende serviceprovider wijst het lokale IP-adres toe. Als u 0 doorgeeft aan de constructor, wijst de onderliggende serviceprovider een poortnummer toe. Als deze constructor wordt gebruikt, wordt het UdpClient exemplaar ingesteld met een adresfamilie van IPv4 die niet kan worden gewijzigd of overschreven door een verbindingsmethodeaanroep met een IPv6-doel.

Deze constructor werkt alleen met IPv4-adrestypen.

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een exemplaar van de UdpClient klasse maakt met behulp van een lokaal eindpunt.

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

Opmerkingen

Deze constructor maakt een nieuwe UdpClient en verbindt deze met de IPEndPoint opgegeven door de localEP parameter. Voordat u deze constructor aanroept, moet u een IPEndPoint ip-adres en poortnummer maken van waaruit u gegevens wilt verzenden en ontvangen. U hoeft geen lokaal IP-adres en poortnummer op te geven voor het verzenden en ontvangen van gegevens. Als u dit niet doet, wijst de onderliggende serviceprovider het meest geschikte lokale IP-adres en poortnummer toe.

Als deze constructor wordt gebruikt, wordt het UdpClient exemplaar ingesteld met de adresfamilie die is opgegeven door de localEP parameter die niet kan worden gewijzigd of overschreven door een verbindingsmethode-aanroep met een andere adresfamilie.

Zie ook

• IPEndPoint

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)

Parameters

Uitzonderingen

Opmerkingen

De family parameter bepaalt of de listener gebruikmaakt van een IP-versie 4-adres (IPv4) of een IP-versie 6-adres (IPv6). Als u een IPv4-adres wilt gebruiken, geeft u de InterNetwork waarde door. Als u een IPv6-adres wilt gebruiken, geeft u de InterNetworkV6 waarde door. Het doorgeven van een andere waarde zorgt ervoor dat de methode een ArgumentException.

Als deze constructor wordt gebruikt, wordt het UdpClient exemplaar ingesteld met de adresfamilie die is opgegeven door de family parameter die niet kan worden gewijzigd of overschreven door een verbindingsmethode-aanroep met een andere adresfamilie.

Het UdpClient.UdpClient(AddressFamily) is niet geschikt voor het samenvoegen van een multicast-groep omdat er geen socketbinding wordt uitgevoerd.

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een UDP-client maakt voor gebruik in een multicast-groep.

// 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)

Opmerkingen

Met deze constructor wordt een onderliggende Socket waarde gemaakt en gekoppeld aan het poortnummer van waaruit u wilt communiceren.

De family parameter bepaalt of de listener gebruikmaakt van een IP-versie 4-adres (IPv4) of een IP-versie 6-adres (IPv6). Als u een IPv4-adres wilt gebruiken, geeft u de InterNetwork waarde door. Als u een IPv6-adres wilt gebruiken, geeft u de InterNetworkV6 waarde door. Het doorgeven van een andere waarde zorgt ervoor dat de methode een ArgumentException.

Als deze constructor wordt gebruikt, wordt het UdpClient exemplaar ingesteld met de adresfamilie die is opgegeven door de family parameter die niet kan worden gewijzigd of overschreven door een verbindingsmethode-aanroep met een andere adresfamilie.

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)

Parameters

Uitzonderingen

Voorbeelden

In het volgende voorbeeld ziet u hoe u een exemplaar van de UdpClient klasse maakt met behulp van een hostnaam en poortnummer.

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

Opmerkingen

Met deze constructor wordt een nieuwe UdpClient geïnitialiseerd en wordt een externe host gemaakt met behulp van de hostname en port parameters. Het instellen van een standaard externe host is optioneel. Als u deze constructor gebruikt, hoeft u geen externe host op te geven in elke aanroep naar de Send methode. Als u een standaard externe host opgeeft, beperkt u zich alleen tot die host. U kunt de standaard externe host op elk gewenst moment wijzigen door de Connect methode aan te roepen. Als u een externe host wilt opgeven in uw aanroep naar de Send methode, gebruikt u deze constructor niet.

Zie ook

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