Condividi tramite


UdpClient.Connect Metodo

Definizione

Stabilisce un host remoto predefinito.

Overload

Connect(IPEndPoint)

Stabilisce un host remoto predefinito utilizzando l'endpoint di rete specificato.

Connect(IPAddress, Int32)

Stabilisce un host remoto predefinito utilizzando l'indirizzo IP e il numero di porta specificati.

Connect(String, Int32)

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

Connect(IPEndPoint)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
Origine:
UDPClient.cs

Stabilisce un host remoto predefinito utilizzando l'endpoint di rete specificato.

public:
 void Connect(System::Net::IPEndPoint ^ endPoint);
public void Connect (System.Net.IPEndPoint endPoint);
member this.Connect : System.Net.IPEndPoint -> unit
Public Sub Connect (endPoint As IPEndPoint)

Parametri

endPoint
IPEndPoint

Classe IPEndPoint che specifica l'endpoint di rete a cui si intende inviare dati.

Eccezioni

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

endPoint è null.

Esempio

Nell'esempio seguente viene usato un IPEndPoint oggetto per stabilire un host remoto predefinito.

//Uses a remote endpoint to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
IPEndPoint^ ipEndPoint = gcnew IPEndPoint( ipAddress,11004 );
try
{
   udpClient->Connect( ipEndPoint );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
//Uses a remote endpoint to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddress, 11004);
try{
 udpClient.Connect(ipEndPoint);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
       }
'Uses a remote endpoint to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Dim ipEndPoint As New IPEndPoint(ipAddress, 11004)
Try
   udpClient.Connect(ipEndPoint)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Commenti

Il Connect metodo stabilisce un host remoto predefinito usando il valore specificato nel endPoint parametro. Dopo aver stabilito, non è necessario specificare un host remoto in ogni chiamata al Send metodo.

La definizione di un host remoto predefinito è facoltativa. Specificando un host remoto predefinito, l'host è limitato solo a tale host. Se si desidera inviare datagrammi a un host remoto diverso, è necessario eseguire un'altra chiamata al Connect metodo o creare un'altra UdpClient senza un host remoto predefinito. Se è stato stabilito un host remoto predefinito e si fornisce anche un host remoto nella chiamata al Send metodo, Send genererà un SocketExceptionoggetto . 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 del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Se si chiama il Connect metodo, gli eventuali datagrammi che arrivano da un indirizzo diverso dal valore predefinito specificato verranno ignorati. Non è possibile impostare l'host remoto predefinito su un indirizzo di trasmissione usando questo metodo, a meno che non si eredita da UdpClient, usare il metodo Client per ottenere l'oggetto sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast.

È tuttavia possibile trasmettere i dati all'indirizzo di trasmissione predefinito, 255.255.255.255, se si specifica IPAddress.Broadcast nella chiamata al Send metodo. Se l'applicazione richiede un maggiore controllo sugli indirizzi di trasmissione, è anche possibile ripristinare l'uso della Socket classe.

Nota

Poiché il protocollo UDP è senza connessione, il Connect metodo non blocca. Non chiamare il Connect metodo se si intende ricevere datagrammi multicast.

Vedi anche

Si applica a

Connect(IPAddress, Int32)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
Origine:
UDPClient.cs

Stabilisce un host remoto predefinito utilizzando l'indirizzo IP e il numero di porta specificati.

public:
 void Connect(System::Net::IPAddress ^ addr, int port);
public void Connect (System.Net.IPAddress addr, int port);
member this.Connect : System.Net.IPAddress * int -> unit
Public Sub Connect (addr As IPAddress, port As Integer)

Parametri

addr
IPAddress

Classe IPAddress dell'host remoto a cui si desidera inviare dati.

port
Int32

Numero di porta a cui si intende inviare dati.

Eccezioni

addr è null.

Il parametro port non è compreso tra MinPort e MaxPort.

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

Esempio

Nell'esempio seguente viene usato un indirizzo IP e un numero di porta per connettersi con un host remoto.

//Uses the IP address and port number to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
IPAddress^ ipAddress = Dns::Resolve( "www.contoso.com" )->AddressList[ 0 ];
try
{
   udpClient->Connect( ipAddress, 11003 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
//Uses the IP address and port number to establish a socket connection.
UdpClient udpClient = new UdpClient();
IPAddress ipAddress = Dns.Resolve("www.contoso.com").AddressList[0];
try{
    udpClient.Connect(ipAddress, 11003);
}
catch (Exception e ) {
           Console.WriteLine(e.ToString());
}
'Uses the IP address and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Dim ipAddress As IPAddress = Dns.Resolve("www.contoso.com").AddressList(0)
Try
   udpClient.Connect(ipAddress, 11003)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Commenti

Il Connect metodo stabilisce un host remoto predefinito usando i valori specificati nei addr parametri e port . Dopo aver stabilito, non è necessario specificare un host remoto in ogni chiamata al Send metodo.

La definizione di un host remoto predefinito è facoltativa. Specificando un host remoto predefinito, l'host è limitato solo a tale host. Se si desidera inviare datagrammi a un host remoto diverso, è necessario eseguire un'altra chiamata al Connect metodo o creare un'altra UdpClient senza un host remoto predefinito. Se è stato stabilito un host remoto predefinito e si fornisce anche un host remoto nella chiamata al Send metodo, Send genererà un SocketExceptionoggetto . 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 del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Se si chiama il Connect metodo, gli eventuali datagrammi che arrivano da un indirizzo diverso dal valore predefinito specificato verranno ignorati. Non è possibile impostare l'host remoto predefinito su un indirizzo di trasmissione usando questo metodo, a meno che non si eredita da UdpClient, usare il metodo client per ottenere l'oggetto sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast.

È tuttavia possibile trasmettere i dati all'indirizzo di trasmissione predefinito, 255.255.255.255, se si specifica IPAddress.Broadcast nella chiamata al Send metodo. Se l'applicazione richiede un maggiore controllo sugli indirizzi di trasmissione, è anche possibile ripristinare l'uso della Socket classe.

Nota

Poiché il protocollo UDP è senza connessione, il Connect metodo non blocca. Non chiamare il Connect metodo se si intende ricevere datagrammi multicast.

Vedi anche

Si applica a

Connect(String, Int32)

Origine:
UDPClient.cs
Origine:
UDPClient.cs
Origine:
UDPClient.cs

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

public:
 void Connect(System::String ^ hostname, int port);
public void Connect (string hostname, int port);
member this.Connect : string * int -> unit
Public Sub Connect (hostname As String, port As Integer)

Parametri

hostname
String

Nome DNS dell'host remoto a cui si desidera inviare dati.

port
Int32

Numero di porta sull'host remoto a cui si desidera inviare dati.

Eccezioni

Il parametro port non è compreso tra MinPort e MaxPort.

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

Esempio

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

//Uses a host name and port number to establish a socket connection.
UdpClient^ udpClient = gcnew UdpClient;
try
{
   udpClient->Connect( "www.contoso.com", 11002 );
}
catch ( Exception^ e ) 
{
   Console::WriteLine( e->ToString() );
}
 //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());
       }
'Uses a host name and port number to establish a socket connection.
Dim udpClient As New UdpClient()
Try
   udpClient.Connect("www.contoso.com", 11002)
Catch e As Exception
   Console.WriteLine(e.ToString())
End Try

Commenti

Il Connect metodo stabilisce un host remoto predefinito usando i valori specificati nei port parametri e hostname . Dopo aver stabilito, non è necessario specificare un host remoto in ogni chiamata al Send metodo.

La definizione di un host remoto predefinito è facoltativa. Specificando un host remoto predefinito, l'host è limitato solo a tale host. Se si desidera inviare datagrammi a un host remoto diverso, è necessario eseguire un'altra chiamata al Connect metodo o creare un'altra UdpClient senza un host remoto predefinito.

Se è stato stabilito un host remoto predefinito e si fornisce anche un host remoto nella chiamata al Send metodo, Send genererà un SocketExceptionoggetto . 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 del codice di errore dell'API Windows Sockets versione 2 per una descrizione dettagliata dell'errore.

Se si chiama il Connect metodo, gli eventuali datagrammi che arrivano da un indirizzo diverso dal valore predefinito specificato verranno ignorati. Non è possibile impostare l'host remoto predefinito su un indirizzo di trasmissione usando questo metodo, a meno che non si eredita da UdpClient, usare il metodo client per ottenere l'oggetto sottostante Sockete impostare l'opzione socket su SocketOptionName.Broadcast.

È tuttavia possibile trasmettere i dati all'indirizzo di trasmissione predefinito, 255.255.255.255, se si specifica IPAddress.Broadcast nella chiamata al Send metodo. Se l'applicazione richiede un maggiore controllo sugli indirizzi di trasmissione, è anche possibile ripristinare l'uso della Socket classe.

Nota

Poiché il protocollo UDP è senza connessione, il Connect metodo non blocca. Non chiamare il Connect metodo se si intende ricevere datagrammi multicast.

Vedi anche

Si applica a