Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Costruttore UdpClient (Int32, AddressFamily)

 

Data di pubblicazione: ottobre 2016

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

Spazio dei nomi:   System.Net.Sockets
Assembly:  System (in System.dll)

public UdpClient(
	int port,
	AddressFamily family
)

Parametri

port
Type: System.Int32

La porta su cui rimanere in ascolto per i tentativi di connessione in ingresso.

family
Type: System.Net.Sockets.AddressFamily

Uno del AddressFamily valori che specifica lo schema di indirizzamento del socket.

Exception Condition
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. Per altre informazioni, vedere la sezione Osservazioni.

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

Il family parametro determina se il listener utilizza un indirizzo IP versione 4 (IPv4) o una IP versione 6 (IPv6) indirizzo. Per utilizzare un indirizzo IPv4, passare il InterNetwork valore. Per utilizzare un indirizzo IPv6, passare il InterNetworkV6 valore. Il passaggio di qualsiasi altro valore provocherà il metodo generare un ArgumentException.

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

System_CAPS_noteNota

Se si riceve un SocketException, utilizzare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto il codice, fare riferimento alla documentazione relativa ai codici di errore dell'API Windows Sockets versione 2 disponibile in MSDN per una descrizione dettagliata dell'errore.

Esempio di codice seguente viene illustrato come creare un client UDP per l'utilizzo 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 = 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);

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: