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

Metodo UdpClient.Connect (String, Int32)

 

Data di pubblicazione: ottobre 2016

Stabilisce un host remoto predefinito utilizzando il nome e il numero porta host.

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

public void Connect(
	string hostname,
	int port
)

Parametri

hostname
Type: System.String

Il nome DNS dell'host remoto a cui si desidera inviare i dati.

port
Type: System.Int32

Il numero di porta dell'host remoto a cui si desidera inviare i dati.

Exception Condition
ObjectDisposedException

UdpClient è chiuso.

ArgumentOutOfRangeException

port non è compreso tra MinPort e MaxPort.

SocketException

Si è verificato un errore durante l'accesso al socket. Per altre informazioni, vedere la sezione Osservazioni.

Il Connect metodo stabilisce un host remoto utilizzando i valori specificati nel port e hostname i parametri. Una volta stabilita, non è necessario specificare un host remoto in ogni chiamata al Send metodo.

La creazione di un host remoto predefinito è facoltativo. Specificare un host remoto predefinito è limitato a tale host. Se si desidera inviare datagrammi a un host remoto differente, è necessario apportare un'altra chiamata al Connect metodo o creare un'altra UdpClient senza un host remoto predefinito.

Se è stato stabilito un remoto predefinito host e fornire anche un host remoto nella chiamata al Send metodo Send genererà un SocketException. Se si riceve un SocketException, utilizzare SocketException.ErrorCode per ottenere il codice di errore specifico. Dopo aver ottenuto il codice, è possibile fare riferimento alla documentazione relativa ai codici di errore dell'API Windows Sockets versione 2 disponibile in MSDN per una descrizione dettagliata dell'errore.

Se si chiama il Connect (metodo), tutti i datagrammi provenienti da un indirizzo diverso da quello predefinito specificato verrà ignorato. Non è possibile impostare l'host remoto predefinito a un indirizzo di broadcast utilizzando questo metodo, a meno che non si eredita da UdpClient, utilizzare il metodo client per ottenere il sottostante Socket, e impostare l'opzione socket SocketOptionName.Broadcast.

È tuttavia possibile trasmettere i dati per il valore predefinito indirizzo di broadcast, 255.255.255.255, se si specifica IPAddress.Broadcast nella chiamata al Send metodo. Se l'applicazione richiede un maggiore controllo sull'indirizzo di broadcast, è inoltre possibile ripristinare l'utilizzo di Socket (classe).

System_CAPS_noteNota

Poiché il protocollo UDP è orientato alla connessione, il Connect metodo si blocca. Non chiamare il Connect metodo se si prevede di ricevere datagrammi multicast.

Nell'esempio seguente il nome host e numero di porta per connettersi a un host remoto.

 //Uses a host name and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
try{
    udpClient.Connect("www.contoso.com", 11002);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }

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