UdpClient Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Sockets

Zestaw:

System.Net.Sockets.dll

Inicjuje nowe wystąpienie klasy UdpClient.

Przeciążenia

UdpClient()	Inicjuje nowe wystąpienie klasy UdpClient.
UdpClient(Int32)	Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z podanym numerem portu lokalnego.
UdpClient(IPEndPoint)	Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z określonym lokalnym punktem końcowym.
UdpClient(AddressFamily)	Inicjuje nowe wystąpienie klasy UdpClient.
UdpClient(Int32, AddressFamily)	Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z podanym numerem portu lokalnego.
UdpClient(String, Int32)	Inicjuje UdpClient nowe wystąpienie klasy i ustanawia domyślny host zdalny.

UdpClient()

Źródło:

UDPClient.cs

Inicjuje nowe wystąpienie klasy UdpClient.

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Wyjątki

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć wystąpienie klasy przy użyciu konstruktora bez parametrów UdpClient .

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

Uwagi

Ten konstruktor tworzy nowy UdpClient i umożliwia bazowemu dostawcy usług przypisanie najbardziej odpowiedniego lokalnego adresu IPv4 i numeru portu. Jeśli ten konstruktor jest używany, wystąpienie jest ustawione z rodziną adresów IPv4, UdpClient której nie można zmienić ani zastąpić przez wywołanie metody connect z docelowym adresem IPv6.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Ten konstruktor nie jest odpowiedni do dołączania do grupy multiemisji, ponieważ nie wykonuje powiązania gniazda. Ponadto działa tylko z typami adresów IPv4.

UdpClient(Int32)

Źródło:

UDPClient.cs

Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z podanym numerem portu lokalnego.

public:
 UdpClient(int port);

public UdpClient (int port);

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

Public Sub New (port As Integer)

Parametry

port

Int32

Numer portu lokalnego, z którego zamierzasz się komunikować.

Wyjątki

ArgumentOutOfRangeException

Parametr port jest większy niż MaxPort lub mniejszy niż MinPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano użycie lokalnego numeru portu do utworzenia UdpClient wystąpienia klasy.

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

Uwagi

Ten konstruktor tworzy element bazowy Socket i wiąże go z numerem portu, z którego zamierzasz się komunikować. Użyj tego konstruktora, jeśli interesuje Cię tylko ustawienie numeru portu lokalnego. Podstawowy dostawca usług przypisze lokalny adres IP. Jeśli przekażesz wartość 0 do konstruktora, podstawowy dostawca usług przypisze numer portu. Jeśli ten konstruktor jest używany, wystąpienie jest ustawione z rodziną adresów IPv4, UdpClient której nie można zmienić ani zastąpić przez wywołanie metody connect z docelowym adresem IPv6.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Ten konstruktor działa tylko z typami adresów IPv4.

UdpClient(IPEndPoint)

Źródło:

UDPClient.cs

Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z określonym lokalnym punktem końcowym.

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)

Parametry

localEP

IPEndPoint

Element IPEndPoint reprezentujący lokalny punkt końcowy, z którym jest powiązane połączenie UDP.

Wyjątki

ArgumentNullException

localEP to null.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć wystąpienie UdpClient klasy przy użyciu lokalnego punktu końcowego.

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

Uwagi

Ten konstruktor tworzy nowy UdpClient i wiąże go z IPEndPoint określonym przez localEP parametr . Przed wywołaniem tego konstruktora należy utworzyć IPEndPoint przy użyciu adresu IP i numeru portu, z którego zamierzasz wysyłać i odbierać dane. Nie trzeba określać lokalnego adresu IP i numeru portu do wysyłania i odbierania danych. Jeśli tego nie zrobisz, podstawowy dostawca usług przypisze najbardziej odpowiedni lokalny adres IP i numer portu.

Jeśli ten konstruktor jest używany, wystąpienie jest ustawiane z rodziną adresów określoną przez localEP parametr, UdpClient którego nie można zmienić ani zastąpić przez wywołanie metody connect z inną rodziną adresów.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

• IPEndPoint

UdpClient(AddressFamily)

Źródło:

UDPClient.cs

Inicjuje nowe wystąpienie klasy UdpClient.

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)

Parametry

family

AddressFamily

AddressFamily Jedna z wartości określających schemat adresowania gniazda.

Wyjątki

ArgumentException

family nie InterNetwork jest lub InterNetworkV6.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Uwagi

Parametr family określa, czy odbiornik używa adresu IP w wersji 4 (IPv4), czy adresu IP w wersji 6 (IPv6). Aby użyć adresu IPv4, przekaż InterNetwork wartość . Aby użyć adresu IPv6, przekaż InterNetworkV6 wartość . Przekazanie dowolnej innej wartości spowoduje, że metoda zgłosi wyjątek ArgumentException.

Jeśli ten konstruktor jest używany, wystąpienie jest ustawiane z rodziną adresów określoną przez family parametr, UdpClient którego nie można zmienić ani zastąpić przez wywołanie metody connect z inną rodziną adresów.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Element UdpClient.UdpClient(AddressFamily) nie jest odpowiedni do dołączania do grupy multiemisji, ponieważ nie wykonuje powiązania gniazda.

UdpClient(Int32, AddressFamily)

Źródło:

UDPClient.cs

Inicjuje UdpClient nowe wystąpienie klasy i wiąże je z podanym numerem portu lokalnego.

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)

Parametry

port

Int32

Port, na którym ma być nasłuchiwanie prób połączenia przychodzącego.

family

AddressFamily

AddressFamily Jedna z wartości określających schemat adresowania gniazda.

Wyjątki

ArgumentException

family nie InterNetwork jest lub InterNetworkV6.

ArgumentOutOfRangeException

port wartość jest większa niż MaxPort lub mniejsza niż MinPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

Poniższy przykład kodu przedstawia sposób tworzenia klienta UDP do użycia w grupie multiemisji.

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

Uwagi

Ten konstruktor tworzy element bazowy Socket i wiąże go z numerem portu, z którego zamierzasz się komunikować.

Parametr family określa, czy odbiornik używa adresu IP w wersji 4 (IPv4), czy adresu IP w wersji 6 (IPv6). Aby użyć adresu IPv4, przekaż InterNetwork wartość . Aby użyć adresu IPv6, przekaż InterNetworkV6 wartość . Przekazanie dowolnej innej wartości spowoduje, że metoda zgłosi wyjątek ArgumentException.

Jeśli ten konstruktor jest używany, wystąpienie jest ustawiane z rodziną adresów określoną przez family parametr, UdpClient którego nie można zmienić ani zastąpić przez wywołanie metody connect z inną rodziną adresów.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu zapoznaj się z dokumentacją kodu błędu interfejsu API Windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

UdpClient(String, Int32)

Źródło:

UDPClient.cs

Inicjuje UdpClient nowe wystąpienie klasy i ustanawia domyślny host zdalny.

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)

Parametry

hostname

String

Nazwa zdalnego hosta DNS, z którym zamierzasz nawiązać połączenie.

port

Int32

Numer portu zdalnego, z którym zamierzasz nawiązać połączenie.

Wyjątki

ArgumentNullException

hostname to null.

ArgumentOutOfRangeException

port nie jest między MinPort i MaxPort.

SocketException

Wystąpił błąd podczas uzyskiwania dostępu do gniazda.

Przykłady

W poniższym przykładzie pokazano, jak utworzyć wystąpienie UdpClient klasy przy użyciu nazwy hosta i numeru portu.

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

Uwagi

Ten konstruktor inicjuje nowy UdpClient i ustanawia hosta zdalnego przy użyciu parametrów hostname i port . Ustanowienie domyślnego hosta zdalnego jest opcjonalne. Jeśli używasz tego konstruktora, nie musisz określać hosta zdalnego w każdym wywołaniu Send metody . Określenie domyślnego hosta zdalnego ogranicza użytkownika tylko do tego hosta. Domyślny host zdalny można zmienić w dowolnym momencie, wywołując metodę Connect . Jeśli chcesz określić hosta zdalnego w wywołaniu Send metody , nie używaj tego konstruktora.

Uwaga

Jeśli zostanie wyświetlony kod błędu SocketException, użyj polecenia SocketException.ErrorCode , aby uzyskać określony kod błędu. Po uzyskaniu tego kodu możesz zapoznać się z dokumentacją kodu błędu interfejsu API windows Sockets w wersji 2 , aby uzyskać szczegółowy opis błędu.

Zobacz też

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