UdpClient Costruttori

Definizione

Spazio dei nomi:

System.Net.Sockets

Assembly:

System.Net.Sockets.dll

Inizializza una nuova istanza della classe UdpClient.

Overload

UdpClient()	Inizializza una nuova istanza della classe UdpClient.
UdpClient(Int32)	Inizializza una nuova istanza della classe UdpClient e la associa al numero di porta locale fornito.
UdpClient(IPEndPoint)	Inizializza una nuova istanza della classe UdpClient e la associa all'endpoint locale specificato.
UdpClient(AddressFamily)	Inizializza una nuova istanza della classe UdpClient.
UdpClient(Int32, AddressFamily)	Inizializza una nuova istanza della classe UdpClient e la associa al numero di porta locale fornito.
UdpClient(String, Int32)	Inizializza una nuova istanza della classe UdpClient e stabilisce un host remoto predefinito.

UdpClient()

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe UdpClient.

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Eccezioni

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato come usare il costruttore senza parametri per creare un'istanza della UdpClient classe .

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

Commenti

Questo costruttore crea un nuovo UdpClient e consente al provider di servizi sottostante di assegnare l'indirizzo IPv4 locale e il numero di porta più appropriati. Se questo costruttore viene usato, l'istanza UdpClient viene impostata con una famiglia di indirizzi IPv4 che non può essere modificata o sovrascritta da una chiamata al metodo connect con una destinazione IPv6.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Questo costruttore non è adatto per l'unione di un gruppo multicast perché non esegue l'associazione socket. Funziona anche solo con i tipi di indirizzo IPv4.

UdpClient(Int32)

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe UdpClient e la associa al numero di porta locale fornito.

public:
 UdpClient(int port);

public UdpClient (int port);

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

Public Sub New (port As Integer)

Parametri

port

Int32

Numero di porta locale da cui si desidera comunicare.

Eccezioni

ArgumentOutOfRangeException

Il parametro port è maggiore di MaxPort o minore di MinPort.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato l'uso di un numero di porta locale per creare un'istanza della UdpClient classe .

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

Commenti

Questo costruttore crea un oggetto sottostante Socket e lo associa al numero di porta da cui si intende comunicare. Utilizzare questo costruttore se si è interessati solo all'impostazione del numero di porta locale. Il provider di servizi sottostante assegnerà l'indirizzo IP locale. Se si passa 0 al costruttore, il provider di servizi sottostante assegnerà un numero di porta. Se questo costruttore viene usato, l'istanza UdpClient viene impostata con una famiglia di indirizzi IPv4 che non può essere modificata o sovrascritta da una chiamata al metodo connect con una destinazione IPv6.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Questo costruttore funziona solo con i tipi di indirizzo IPv4.

UdpClient(IPEndPoint)

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe UdpClient e la associa all'endpoint locale specificato.

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)

Parametri

localEP

IPEndPoint

IPEndPoint che rappresenta l'endpoint locale a cui associare la connessione UDP.

Eccezioni

ArgumentNullException

localEP è null.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato come creare un'istanza della UdpClient classe usando un endpoint locale.

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

Commenti

Questo costruttore crea un nuovo UdpClient oggetto e lo associa all'oggetto IPEndPoint specificato dal localEP parametro . Prima di chiamare questo costruttore, è necessario creare un IPEndPoint oggetto usando l'indirizzo IP e il numero di porta da cui si intende inviare e ricevere dati. Non è necessario specificare un indirizzo IP locale e un numero di porta per l'invio e la ricezione di dati. In caso contrario, il provider di servizi sottostante assegnerà l'indirizzo IP locale e il numero di porta più appropriati.

Se questo costruttore viene utilizzato, l'istanza UdpClient viene impostata con la famiglia di indirizzi specificata dal localEP parametro che non può essere modificato o sovrascritto da una chiamata al metodo connect con una famiglia di indirizzi diversa.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

• IPEndPoint

UdpClient(AddressFamily)

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe 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)

Parametri

family

AddressFamily

Uno dei valori AddressFamily mediante il quale viene specificato lo schema di indirizzamento del socket.

Eccezioni

ArgumentException

family non è InterNetwork o InterNetworkV6.

SocketException

Si è verificato un errore durante l'accesso al socket.

Commenti

Il family parametro determina se il listener usa un indirizzo IP versione 4 (IPv4) o un indirizzo IP versione 6 (IPv6). Per usare un indirizzo IPv4, passare il InterNetwork valore . Per usare un indirizzo IPv6, passare il InterNetworkV6 valore . Se si passa qualsiasi altro valore, il metodo genera un'eccezione ArgumentException.

Se questo costruttore viene utilizzato, l'istanza UdpClient viene impostata con la famiglia di indirizzi specificata dal family parametro che non può essere modificato o sovrascritto da una chiamata al metodo connect con una famiglia di indirizzi diversa.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Non UdpClient.UdpClient(AddressFamily) è adatto per l'unione di un gruppo multicast perché non esegue l'associazione socket.

UdpClient(Int32, AddressFamily)

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe UdpClient e la associa al numero di porta locale fornito.

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)

Parametri

port

Int32

Porta su cui attendere i tentativi di connessione in ingresso.

family

AddressFamily

Uno dei valori AddressFamily mediante il quale viene specificato lo schema di indirizzamento del socket.

Eccezioni

ArgumentException

family non è InterNetwork o InterNetworkV6.

ArgumentOutOfRangeException

port è maggiore di MaxPort o minore di MinPort.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

L'esempio di codice seguente illustra come creare un client UDP da usare in un gruppo multicast.

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

Commenti

Questo costruttore crea un oggetto sottostante Socket e lo associa al numero di porta da cui si intende comunicare.

Il family parametro determina se il listener usa un indirizzo IP versione 4 (IPv4) o un indirizzo IP versione 6 (IPv6). Per usare un indirizzo IPv4, passare il InterNetwork valore . Per usare un indirizzo IPv6, passare il InterNetworkV6 valore . Se si passa qualsiasi altro valore, il metodo genera un'eccezione ArgumentException.

Se questo costruttore viene utilizzato, l'istanza UdpClient viene impostata con la famiglia di indirizzi specificata dal family parametro che non può essere modificato o sovrascritto da una chiamata al metodo connect con una famiglia di indirizzi diversa.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

UdpClient(String, Int32)

Origine:

UDPClient.cs

Inizializza una nuova istanza della classe UdpClient e stabilisce un host remoto predefinito.

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)

Parametri

hostname

String

Nome dell'host remoto DNS a cui si desidera connettersi.

port

Int32

Numero di porta remota a cui si desidera connettersi.

Eccezioni

ArgumentNullException

hostname è null.

ArgumentOutOfRangeException

Il parametro port non è compreso tra MinPort e MaxPort.

SocketException

Si è verificato un errore durante l'accesso al socket.

Esempio

Nell'esempio seguente viene illustrato come creare un'istanza della UdpClient classe usando un nome host e un numero di porta.

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

Commenti

Questo costruttore inizializza un nuovo UdpClient host e stabilisce un host remoto usando i hostname parametri e port . La definizione di un host remoto predefinito è facoltativa. Se si usa questo costruttore, non è necessario specificare un host remoto in ogni chiamata al Send metodo . La specifica di un host remoto predefinito limita solo l'host. È possibile modificare l'host remoto predefinito in qualsiasi momento chiamando il Connect metodo . Se si vuole specificare un host remoto nella chiamata al Send metodo , non usare questo costruttore.

Nota

Se si riceve un SocketExceptionoggetto , usare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto questo codice, è possibile fare riferimento alla documentazione relativa al codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Vedi anche

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