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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
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)

Source:
UDPClient.cs
Source:
UDPClient.cs
Source:
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