TcpClient.BeginConnect Methode

Definition

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection.

Überlädt

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch eine IPAddress und eine Anschlussnummer (Int32) angegeben.The remote host is specified by an IPAddress and a port number (Int32).

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch ein IPAddress-Array und eine Portnummer (Int32) angegeben.The remote host is specified by an IPAddress array and a port number (Int32).

BeginConnect(String, Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch einen Hostnamen (String) und eine Anschlussnummer (Int32) angegeben.The remote host is specified by a host name (String) and a port number (Int32).

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch eine IPAddress und eine Anschlussnummer (Int32) angegeben.The remote host is specified by an IPAddress and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(System::Net::IPAddress ^ address, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress address, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (address As IPAddress, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parameter

address
IPAddress

Die IPAddress des Remotehosts.The IPAddress of the remote host.

port
Int32

Die Portnummer des Remotehosts.The port number of the remote host.

requestCallback
AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält.A user-defined object that contains information about the connect operation. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.This object is passed to the requestCallback delegate when the operation is complete.

Gibt zurück

Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.An IAsyncResult object that references the asynchronous connection.

Ausnahmen

Der address-Parameter ist null.The address parameter is null.

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Der Socket wurde geschlossen.The Socket has been closed.

Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.A caller higher in the call stack does not have permission for the requested operation.

Die Portnummer ist ungültig.The port number is not valid.

Beispiele

Das folgende Codebeispiel erstellt eine TcpClient und stellt eine Verbindung mit einem Remote Host her.The following code example creates a TcpClient and connects to a remote host.

   static void DoBeginConnect1( String^ host, int port )
   {
      // Connect asynchronously to the specifed host.
      TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
//      IPAddress^ remoteHost = gcnew IPAddress( host );
      array<IPAddress^>^ remoteHost = Dns::GetHostAddresses( host );
      connectDone->Reset();
      Console::WriteLine( "Establishing Connection to {0}", host );
      t->BeginConnect( remoteHost, port, gcnew AsyncCallback( &ConnectCallback ), t );

      // Wait here until the callback processes the connection.
      connectDone->WaitOne();
      Console::WriteLine( "Connection established" );
   }
        public static void DoBeginConnect1(string host, int port)
        {
            // Connect asynchronously to the specifed host.
            TcpClient t = new TcpClient(AddressFamily.InterNetwork);
//            IPAddress remoteHost = new IPAddress(host);
            IPAddress[] remoteHost = Dns.GetHostAddresses(host);

            connectDone.Reset();

            Console.WriteLine("Establishing Connection to {0}", 
                remoteHost[0]);
            t.BeginConnect(remoteHost[0], port, 
                new AsyncCallback(ConnectCallback), t);

            // Wait here until the callback processes the connection.
            connectDone.WaitOne();

            Console.WriteLine("Connection established");
        }

Hinweise

Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden.The asynchronous BeginConnect operation must be completed by calling the EndConnect method. In der Regel wird die-Methode vom asyncCallback -Delegaten aufgerufen.Typically, the method is invoked by the asyncCallback delegate.

Diese Methode wird nicht blockiert, bis der Vorgang abgeschlossen ist.This method does not block until the operation completes. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Connect Sie eine der-Methoden Überladungen.To block until the operation completes, use one of the Connect method overloads.

Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

BeginConnect(IPAddress[], Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch ein IPAddress-Array und eine Portnummer (Int32) angegeben.The remote host is specified by an IPAddress array and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(cli::array <System::Net::IPAddress ^> ^ addresses, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.IPAddress[] addresses, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : System.Net.IPAddress[] * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (addresses As IPAddress(), port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parameter

addresses
IPAddress[]

Mindestens eine IPAddress, die die Remotehosts bezeichnet.At least one IPAddress that designates the remote hosts.

port
Int32

Die Portnummer des Remotehosts.The port number of the remote hosts.

requestCallback
AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält.A user-defined object that contains information about the connect operation. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.This object is passed to the requestCallback delegate when the operation is complete.

Gibt zurück

Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.An IAsyncResult object that references the asynchronous connection.

Ausnahmen

Der addresses-Parameter ist null.The addresses parameter is null.

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Der Socket wurde geschlossen.The Socket has been closed.

Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.A caller higher in the call stack does not have permission for the requested operation.

Die Portnummer ist ungültig.The port number is not valid.

Beispiele

Das folgende Codebeispiel erstellt eine TcpClient und stellt eine Verbindung mit einem Remote Host her.The following code example creates a TcpClient and connects to a remote host.

// Connect asynchronously to the specifed host.
static void DoBeginConnect2( String^ host, int port )
{
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   array<IPAddress^>^remoteHost = Dns::GetHostAddresses( host );
   connectDone->Reset();
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->BeginConnect( remoteHost, port, gcnew AsyncCallback(  &ConnectCallback ), t );

   // Wait here until the callback processes the connection.
   connectDone->WaitOne();
   Console::WriteLine( "Connection established" );
}
// Connect asynchronously to the specifed host.
public static void DoBeginConnect2(string host, int port)
{
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);
    IPAddress[] remoteHost = Dns.GetHostAddresses(host);

    connectDone.Reset();

    Console.WriteLine("Establishing Connection to {0}", host);
    t.BeginConnect(remoteHost, port, 
        new AsyncCallback(ConnectCallback), t);

    // Wait here until the callback processes the connection.
    connectDone.WaitOne();

    Console.WriteLine("Connection established");
}

Hinweise

Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden.The asynchronous BeginConnect operation must be completed by calling the EndConnect method. In der Regel wird die-Methode vom asyncCallback -Delegaten aufgerufen.Typically, the method is invoked by the asyncCallback delegate.

Diese Methode wird nicht blockiert, bis der Vorgang abgeschlossen ist.This method does not block until the operation completes. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Connect Sie eine der-Methoden Überladungen.To block until the operation completes, use one of the Connect method overloads.

Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

Diese Methode wird in der Regel unmittelbar nach einem Rückruf der BeginGetHostAddresses -Methode verwendet, die mehrere IP-Adressen für einen einzelnen Host zurückgeben kann.This method is typically used immediately after a call to the BeginGetHostAddresses method, which can return multiple IP addresses for a single host.

BeginConnect(String, Int32, AsyncCallback, Object)

Beginnt eine asynchrone Anforderung einer Remotehostverbindung.Begins an asynchronous request for a remote host connection. Der Remotehost wird durch einen Hostnamen (String) und eine Anschlussnummer (Int32) angegeben.The remote host is specified by a host name (String) and a port number (Int32).

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (string host, int port, AsyncCallback requestCallback, object state);
member this.BeginConnect : string * int * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (host As String, port As Integer, requestCallback As AsyncCallback, state As Object) As IAsyncResult

Parameter

host
String

Der Name des Remotehosts.The name of the remote host.

port
Int32

Die Portnummer des Remotehosts.The port number of the remote host.

requestCallback
AsyncCallback

Ein AsyncCallback-Delegat, der auf die Methode verweist, die bei Abschluss des Vorgangs aufgerufen werden soll.An AsyncCallback delegate that references the method to invoke when the operation is complete.

state
Object

Ein benutzerdefiniertes Objekt, das Informationen über den Verbindungsvorgang enthält.A user-defined object that contains information about the connect operation. Dieses Objekt wird bei Abschluss des Vorgangs an den requestCallback-Delegaten übergeben.This object is passed to the requestCallback delegate when the operation is complete.

Gibt zurück

Ein IAsyncResult-Objekt, das auf die asynchrone Verbindung verweist.An IAsyncResult object that references the asynchronous connection.

Ausnahmen

Der host-Parameter ist null.The host parameter is null.

Fehler beim Versuch, auf den Socket zuzugreifen.An error occurred when attempting to access the socket.

Der Socket wurde geschlossen.The Socket has been closed.

Ein höher in der Aufrufliste befindlicher Aufrufer verfügt nicht über die Berechtigung für den angeforderten Vorgang.A caller higher in the call stack does not have permission for the requested operation.

Die Portnummer ist ungültig.The port number is not valid.

Beispiele

Das folgende Codebeispiel erstellt eine TcpClient und stellt eine Verbindung mit einem Remote Host her.The following code example creates a TcpClient and connects to a remote host.

// Connect asynchronously to the specifed host.
static void DoBeginConnect3( String^ host, int port )
{
   TcpClient^ t = gcnew TcpClient( AddressFamily::InterNetwork );
   connectDone->Reset();
   Console::WriteLine( "Establishing Connection to {0}", host );
   t->BeginConnect( host, port, gcnew AsyncCallback(  &ConnectCallback ), t );
   
   // Wait here until the callback processes the connection.
   connectDone->WaitOne();
   Console::WriteLine( "Connection established" );
}
// Connect asynchronously to the specifed host.
public static void DoBeginConnect3(string host, int port)
{
    TcpClient t = new TcpClient(AddressFamily.InterNetwork);

    connectDone.Reset();

    Console.WriteLine("Establishing Connection to {0}", 
        host);
    t.BeginConnect(host, port, 
        new AsyncCallback(ConnectCallback), t);

    // Wait here until the callback processes the connection.
    connectDone.WaitOne();

    Console.WriteLine("Connection established");
}

Hinweise

Der asynchrone BeginConnect Vorgang muss durch Aufrufen der EndConnect -Methode abgeschlossen werden.The asynchronous BeginConnect operation must be completed by calling the EndConnect method. In der Regel wird die-Methode vom asyncCallback -Delegaten aufgerufen.Typically, the method is invoked by the asyncCallback delegate.

Diese Methode wird nicht blockiert, bis der Vorgang abgeschlossen ist.This method does not block until the operation completes. Um zu blockieren, bis der Vorgang abgeschlossen ist, verwenden Connect Sie eine der-Methoden Überladungen.To block until the operation completes, use one of the Connect method overloads.

Ausführliche Informationen zur Verwendung des asynchronen Programmiermodells finden Sie unter Asynchrones Aufrufen synchroner Methoden.For detailed information about using the asynchronous programming model, see Calling Synchronous Methods Asynchronously.

Gilt für: