Socket.Connect Méthode

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 void Connect(System::Net::EndPoint ^ remoteEP);

public void Connect (System.Net.EndPoint remoteEP);

member this.Connect : System.Net.EndPoint -> unit

Public Sub Connect (remoteEP As EndPoint)

Paramètres

Exceptions

Exemples

L’exemple de code suivant se connecte à un point de terminaison distant, puis vérifie la connexion.

client->Connect( anEndPoint );
if (  !client->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}
   
// This is how you can determine whether a socket is still connected.
bool blockingState = client->Blocking;
try
{
   array<Byte>^tmp = gcnew array<Byte>(1);
   client->Blocking = false;
   client->Send( tmp, 0, static_cast<SocketFlags>(0) );
   Console::WriteLine( L"Connected!" );
}
catch ( SocketException^ e ) 
{
   // 10035 == WSAEWOULDBLOCK
   if ( e->NativeErrorCode.Equals( 10035 ) )
   {
      Console::WriteLine( "Connected from an exception!" );
   }
   else
   {
      Console::WriteLine( "Disconnected: {0}!", e->NativeErrorCode );
   }
}
finally
{
   client->Blocking = blockingState;
}

Console::WriteLine( "Connected: {0}", client->Connected );

// .Connect throws an exception if unsuccessful
client.Connect(anEndPoint);

// This is how you can determine whether a socket is still connected.
bool blockingState = client.Blocking;
try
{
    byte [] tmp = new byte[1];

    client.Blocking = false;
    client.Send(tmp, 0, 0);
    Console.WriteLine("Connected!");
}
catch (SocketException e)
{
    // 10035 == WSAEWOULDBLOCK
    if (e.NativeErrorCode.Equals(10035))
    {
        Console.WriteLine("Still Connected, but the Send would block");
    }
    else
    {
        Console.WriteLine("Disconnected: error code {0}!", e.NativeErrorCode);
    }
}
finally
{
    client.Blocking = blockingState;
}

Console.WriteLine("Connected: {0}", client.Connected);

    ' .Connect throws an exception if unsuccessful
    client.Connect(anEndPoint)
    
    ' This is how you can determine whether a socket is still connected.
    Dim blockingState As Boolean = client.Blocking
    Try
        Dim tmp(0) As Byte
        
        client.Blocking = False
        client.Send(tmp, 0, 0)
        Console.WriteLine("Connected!")
    Catch e As SocketException
        ' 10035 == WSAEWOULDBLOCK
        If e.NativeErrorCode.Equals(10035) Then
            Console.WriteLine("Still Connected, but the Send would block")
        Else
            Console.WriteLine("Disconnected: error code {0}!", e.NativeErrorCode)
        End If
    Finally
        client.Blocking = blockingState
    End Try
    
    Console.WriteLine("Connected: {0}", client.Connected)

End Sub

Remarques

Si vous utilisez un protocole orienté connexion tel que TCP, la Connect méthode établit de manière synchrone une connexion réseau entre LocalEndPoint et le point de terminaison distant spécifié. Si vous utilisez un protocole sans connexion, Connect établit un hôte distant par défaut. Après avoir appelé Connect, vous pouvez envoyer des données à l’appareil distant avec la Send méthode ou recevoir des données de l’appareil distant avec la Receive méthode .

Si vous utilisez un protocole sans connexion tel qu’UDP, vous n’avez pas besoin d’appeler Connect avant d’envoyer et de recevoir des données. Vous pouvez utiliser SendTo et ReceiveFrom pour communiquer de manière synchrone avec un hôte distant. Si vous appelez Connect, tous les datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée seront ignorés. Si vous souhaitez définir votre hôte distant par défaut sur une adresse de diffusion, vous devez d’abord appeler la SetSocketOption méthode et définir l’option de socket sur SocketOptionName.Broadcast, ou Connect lèvera un SocketException. Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

La Connect méthode sera bloquée, sauf si vous définissez spécifiquement la Blocking propriété sur false avant d’appeler Connect. Si vous utilisez un protocole orienté connexion comme TCP et que vous désactivez le blocage, Connect lève un SocketException car il a besoin de temps pour créer la connexion. Les protocoles sans connexion ne lèvent pas d’exception, car ils établissent simplement un hôte distant par défaut. Vous pouvez utiliser SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur. Si l’erreur a retourné WSAEWOULDBLOCK, la connexion de l’hôte distant a été lancée par un élément orienté Socketconnexion, mais elle ne s’est pas encore terminée correctement. Utilisez la Poll méthode pour déterminer quand la Socket connexion est terminée.

Voir aussi

• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Receive(Byte[], Int32, SocketFlags)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• LocalEndPoint
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• Blocking
• Poll(Int32, SelectMode)

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 void Connect(System::Net::IPAddress ^ address, int port);

public void Connect (System.Net.IPAddress address, int port);

member this.Connect : System.Net.IPAddress * int -> unit

Public Sub Connect (address As IPAddress, port As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant se connecte à un point de terminaison distant, puis vérifie la connexion.

// Synchronous connect using IPAddress to resolve the 
// host name.
static void Connect1( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs[ 0 ], port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using IPAddress to resolve the
// host name.
public static void Connect1(string host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);

    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(IPs[0], port);
    Console.WriteLine("Connection established");
}

Remarques

Si vous utilisez un protocole orienté connexion tel que TCP, la Connect méthode établit de manière synchrone une connexion réseau entre LocalEndPoint et le point de terminaison distant spécifié. Si vous utilisez un protocole sans connexion, Connect établit un hôte distant par défaut. Après avoir appelé Connect , vous pouvez envoyer des données à l’appareil distant avec la Send méthode ou recevoir des données de l’appareil distant avec la Receive méthode .

Si vous utilisez un protocole sans connexion tel qu’UDP, vous n’avez pas besoin d’appeler Connect avant d’envoyer et de recevoir des données. Vous pouvez utiliser SendTo et ReceiveFrom pour communiquer de manière synchrone avec un hôte distant. Si vous appelez Connect des datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée, seront ignorés. Si vous souhaitez définir votre hôte distant par défaut sur une adresse de diffusion, vous devez d’abord appeler la SetSocketOption méthode et définir l’option de socket sur SocketOptionName.Broadcast, ou Connect lèvera un SocketException. Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Connect la méthode bloquera, sauf si vous définissez spécifiquement la Blocking propriété sur false avant d’appeler Connect. Si vous utilisez un protocole orienté connexion comme TCP et que vous désactivez le blocage, Connect lève un SocketException car il a besoin de temps pour créer la connexion. Les protocoles sans connexion ne lèvent pas d’exception, car ils établissent simplement un hôte distant par défaut. Vous pouvez utiliser SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur. Si l’erreur a retourné WSAEWOULDBLOCK, la connexion de l’hôte distant a été lancée par un élément orienté Socketconnexion, mais elle ne s’est pas encore terminée correctement. Utilisez la Poll méthode pour déterminer quand la Socket connexion est terminée.

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public void Connect (System.Net.IPAddress[] addresses, int port);

member this.Connect : System.Net.IPAddress[] * int -> unit

Public Sub Connect (addresses As IPAddress(), port As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant se connecte à un point de terminaison distant, puis vérifie la connexion.

// Synchronous connect using Dns.ResolveToAddresses to 
// resolve the host name.
static void Connect2( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs, port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using Dns.GetHostAddresses to
// resolve the host name.
public static void Connect2(string host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);
    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(IPs, port);
    Console.WriteLine("Connection established");
}

Remarques

Cette méthode est généralement utilisée immédiatement après un appel à GetHostAddresses, ce qui peut retourner plusieurs adresses IP pour un hôte unique. Si vous utilisez un protocole orienté connexion tel que TCP, la Connect méthode établit de manière synchrone une connexion réseau entre LocalEndPoint et le point de terminaison distant spécifié. Si vous utilisez un protocole sans connexion, Connect établit un hôte distant par défaut. Après avoir appelé Connect , vous pouvez envoyer des données à l’appareil distant avec la Send méthode ou recevoir des données de l’appareil distant avec la Receive méthode .

Si vous utilisez un protocole sans connexion tel qu’UDP, vous n’avez pas besoin d’appeler Connect avant d’envoyer et de recevoir des données. Vous pouvez utiliser SendTo et ReceiveFrom pour communiquer de manière synchrone avec un hôte distant. Si vous appelez Connect des datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée, seront ignorés. Si vous souhaitez définir votre hôte distant par défaut sur une adresse de diffusion, vous devez d’abord appeler la SetSocketOption méthode et définir l’option de socket sur SocketOptionName.Broadcast, ou Connect lèvera un SocketException. Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

Connect la méthode bloquera, sauf si vous définissez spécifiquement la Blocking propriété sur false avant d’appeler Connect. Si vous utilisez un protocole orienté connexion comme TCP et que vous désactivez le blocage, Connect lève un SocketException car il a besoin de temps pour créer la connexion. Les protocoles sans connexion ne lèvent pas d’exception, car ils établissent simplement un hôte distant par défaut. Vous pouvez utiliser SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur. Si l’erreur a retourné WSAEWOULDBLOCK, la connexion de l’hôte distant a été lancée par un élément orienté Socketconnexion, mais elle ne s’est pas encore terminée correctement. Utilisez la Poll méthode pour déterminer quand la Socket connexion est terminée.

Source:

Socket.cs

Source:

Socket.cs

Source:

Socket.cs

public:
 void Connect(System::String ^ host, int port);

public void Connect (string host, int port);

member this.Connect : string * int -> unit

Public Sub Connect (host As String, port As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant se connecte à un point de terminaison distant, puis vérifie la connexion.

// Synchronous connect using host name (resolved by the 
// Connect call.)
static void Connect3( String^ host, int port )
{
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( host, port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using host name (resolved by the
// Connect call.)
public static void Connect3(string host, int port)
{
    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);

    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(host, port);
    Console.WriteLine("Connection established");
}

Remarques

Si vous utilisez un protocole orienté connexion tel que TCP, la Connect méthode établit de manière synchrone une connexion réseau entre LocalEndPoint et l’hôte distant spécifié. Si vous utilisez un protocole sans connexion, Connect établit un hôte distant par défaut. Après avoir appelé Connect , vous pouvez envoyer des données à l’appareil distant avec la Send méthode ou recevoir des données de l’appareil distant avec la Receive méthode .

Si vous utilisez un protocole sans connexion tel qu’UDP, vous n’avez pas besoin d’appeler Connect avant d’envoyer et de recevoir des données. Vous pouvez utiliser SendTo et ReceiveFrom pour communiquer de manière synchrone avec un hôte distant. Si vous appelez Connect des datagrammes qui arrivent d’une adresse autre que la valeur par défaut spécifiée, seront ignorés. Si vous souhaitez définir votre hôte distant par défaut sur une adresse de diffusion, vous devez d’abord appeler la SetSocketOption méthode et définir l’option de socket sur SocketOptionName.Broadcast, ou Connect lèvera un SocketException. Si vous recevez un SocketException, utilisez la SocketException.ErrorCode propriété pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur.

La Connect méthode sera bloquée, sauf si vous définissez spécifiquement la Blocking propriété sur false avant d’appeler Connect. Si vous utilisez un protocole orienté connexion comme TCP et que vous désactivez le blocage, Connect lève un SocketException car il a besoin de temps pour créer la connexion. Les protocoles sans connexion ne lèvent pas d’exception, car ils établissent simplement un hôte distant par défaut. Vous pouvez utiliser SocketException.ErrorCode pour obtenir le code d’erreur spécifique. Une fois ce code obtenu, reportez-vous à la documentation du code d’erreur de l’API Windows Sockets version 2 pour obtenir une description détaillée de l’erreur. Si l’erreur a retourné WSAEWOULDBLOCK, la connexion de l’hôte distant a été lancée par un élément orienté Socketconnexion, mais elle ne s’est pas encore terminée correctement. Utilisez la Poll méthode pour déterminer quand la Socket connexion est terminée.

Si IPv6 est activé et que la Connect(String, Int32) méthode est appelée pour se connecter à un hôte qui se résout en adresses IPv6 et IPv4, la connexion à l’adresse IPv6 est tentée avant l’adresse IPv4. Cela peut avoir pour effet de retarder le délai d’établissement de la connexion si l’hôte n’écoute pas l’adresse IPv6.