UdpClient Costruttori

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

UDPClient.cs

public:
 UdpClient();

public UdpClient ();

Public Sub New ()

Eccezioni

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.

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.

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

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)

Parametri

Eccezioni

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.

Questo costruttore funziona solo con i tipi di indirizzo IPv4.

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

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)

Parametri

Eccezioni

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.

Vedi anche

• IPEndPoint

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

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)

Parametri

Eccezioni

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.

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

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

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)

Parametri

Eccezioni

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.

Origine:

UDPClient.cs

Origine:

UDPClient.cs

Origine:

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)

Parametri

Eccezioni

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.

Vedi anche

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