Socket.ConnectAsync Methode

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 static bool ConnectAsync(System::Net::Sockets::SocketType socketType, System::Net::Sockets::ProtocolType protocolType, System::Net::Sockets::SocketAsyncEventArgs ^ e);

public static bool ConnectAsync (System.Net.Sockets.SocketType socketType, System.Net.Sockets.ProtocolType protocolType, System.Net.Sockets.SocketAsyncEventArgs e);

static member ConnectAsync : System.Net.Sockets.SocketType * System.Net.Sockets.ProtocolType * System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Shared Function ConnectAsync (socketType As SocketType, protocolType As ProtocolType, e As SocketAsyncEventArgs) As Boolean

Parameter

Gibt zurück

true, wenn der E/A-Vorgang aussteht. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.

false, wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.

Ausnahmen

Hinweise

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, startet die M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs)-Methode eine asynchrone Anforderung für eine Verbindung mit dem Remotehost. Wenn Sie ein verbindungsloses Protokoll verwenden, wird ein Standard-Remotehost eingerichtet, ConnectAsync der durch die socketType Parameter und protocolType angegeben wird.

Um über den Abschluss benachrichtigt zu werden, müssen Sie eine Rückrufmethode erstellen, die den EventHandler<SocketAsyncEventArgs-Delegaten> implementiert, und den Rückruf an das SocketAsyncEventArgs.Completed Ereignis anfügen.

Der Aufrufer muss die SocketAsyncEventArgs.RemoteEndPoint -Eigenschaft auf den des Remotehosts festlegen, mit dem IPEndPoint eine Verbindung hergestellt werden soll.

Der Aufrufer kann die SocketAsyncEventArgs.UserToken -Eigenschaft auf ein beliebiges Benutzerzustandsobjekt festlegen, bevor die ConnectAsync -Methode aufgerufen wird, sodass die Informationen in der Rückrufmethode abgerufen werden können. Wenn der Rückruf mehr Informationen als ein einzelnes Objekt benötigt, kann eine kleine Klasse erstellt werden, die die anderen erforderlichen Zustandsinformationen als Member enthält.

Wenn Sie ein verbindungsloses Protokoll wie UDP verwenden, müssen Sie vor dem Senden und Empfangen von Daten nicht aufrufen ConnectAsync . Sie können und ReceiveFromAsync verwendenSendToAsync, um mit einem Remotehost zu kommunizieren. Wenn Sie aufrufen ConnectAsync, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Wenn Sie den Standard-Remotehost ändern möchten, rufen Sie die ConnectAsync -Methode erneut mit dem gewünschten Endpunkt auf.

Wenn Sie den Standard-Remotehost auf eine Broadcastadresse festlegen möchten, müssen Sie zuerst aufrufen SetSocketOption und Broadcast auf truefestlegen. Wenn dies nicht der Fall ist, löst die ConnectAsync -Methode einen aus SocketException.

Die folgenden Eigenschaften und Ereignisse für das System.Net.Sockets.SocketAsyncEventArgs Objekt sind erforderlich:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Optional kann ein Puffer bereitgestellt werden, der atomar an den Socket gesendet wird, nachdem die ConnectAsync Methode erfolgreich war. In diesem Fall muss die SocketAsyncEventArgs.Buffer -Eigenschaft auf den Puffer festgelegt werden, der die zu sendenden Daten enthält, und die SocketAsyncEventArgs.Count -Eigenschaft muss auf die Anzahl der Daten festgelegt werden, die vom Puffer gesendet werden sollen. Sobald eine Verbindung hergestellt wurde, wird dieser Datenpuffer gesendet.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden und vor dem Aufrufen ConnectAsyncnicht aufrufenBind, weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale Netzwerkadresse und Portnummer zu.

Wenn Sie ein verbindungsloses Protokoll verwenden, weist der Dienstanbieter erst dann eine IP-Adresse und Portnummer des lokalen Netzwerks zu, wenn Sie die SendAsync Methoden oder ReceiveAsync aufrufen.

Die ConnectAsync -Methode löst aus NotSupportedException , wenn die Adressfamilie von Socket und nicht SocketAsyncEventArgs.RemoteEndPoint die gleiche Adressfamilie ist.

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress[] addresses, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress[] * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (addresses As IPAddress(), port As Integer, cancellationToken As CancellationToken) As ValueTask

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress[], Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::String ^ host, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (string host, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : string * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (host As String, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(String, Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::IPAddress ^ address, int port, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.IPAddress address, int port, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.IPAddress * int * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (address As IPAddress, port As Integer, cancellationToken As CancellationToken) As ValueTask

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress, Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::String ^ host, int port);

public System.Threading.Tasks.Task ConnectAsync (string host, int port);

member this.ConnectAsync : string * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (host As String, port As Integer) As Task

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(String, Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress[] addresses, int port);

member this.ConnectAsync : System.Net.IPAddress[] * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (addresses As IPAddress(), port As Integer) As Task

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress[], Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::IPAddress ^ address, int port);

public System.Threading.Tasks.Task ConnectAsync (System.Net.IPAddress address, int port);

member this.ConnectAsync : System.Net.IPAddress * int -> System.Threading.Tasks.Task

Public Function ConnectAsync (address As IPAddress, port As Integer) As Task

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(IPAddress, Int32).

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::ValueTask ConnectAsync(System::Net::EndPoint ^ remoteEP, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.ValueTask ConnectAsync (System.Net.EndPoint remoteEP, System.Threading.CancellationToken cancellationToken);

member this.ConnectAsync : System.Net.EndPoint * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask

Public Function ConnectAsync (remoteEP As EndPoint, cancellationToken As CancellationToken) As ValueTask

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(EndPoint).

Quelle:

Socket.cs

Quelle:

Socket.cs

Quelle:

Socket.cs

public:
 bool ConnectAsync(System::Net::Sockets::SocketAsyncEventArgs ^ e);

public bool ConnectAsync (System.Net.Sockets.SocketAsyncEventArgs e);

member this.ConnectAsync : System.Net.Sockets.SocketAsyncEventArgs -> bool

Public Function ConnectAsync (e As SocketAsyncEventArgs) As Boolean

Parameter

Gibt zurück

true, wenn der E/A-Vorgang aussteht. Das Completed-Ereignis für den e-Parameter wird nach dem Abschluss des Vorgangs ausgelöst.

false, wenn der E/A-Vorgang synchron abgeschlossen wurde. In diesem Fall wird das Completed-Ereignis für den e-Parameter nicht ausgelöst, und das als Parameter übergebene e-Objekt kann direkt nach der Rückgabe des Methodenaufrufs untersucht werden, um die Ergebnisse des Vorgangs abzurufen.

Ausnahmen

Hinweise

Wenn Sie ein verbindungsorientiertes Protokoll verwenden, startet die ConnectAsync Methode eine asynchrone Anforderung für eine Verbindung mit dem Remotehost. Wenn Sie ein verbindungsloses Protokoll verwenden, ConnectAsync wird ein Standard-Remotehost eingerichtet.

Um über den Abschluss benachrichtigt zu werden, müssen Sie eine Rückrufmethode erstellen, die den EventHandler<SocketAsyncEventArgs-Delegaten> implementiert, und den Rückruf an das SocketAsyncEventArgs.Completed Ereignis anfügen.

Der Aufrufer muss die SocketAsyncEventArgs.RemoteEndPoint -Eigenschaft auf den des Remotehosts festlegen, mit dem IPEndPoint eine Verbindung hergestellt werden soll.

Der Aufrufer kann die SocketAsyncEventArgs.UserToken -Eigenschaft auf ein beliebiges Benutzerzustandsobjekt festlegen, bevor die ConnectAsync -Methode aufgerufen wird, sodass die Informationen in der Rückrufmethode abgerufen werden können. Wenn der Rückruf mehr Informationen als ein einzelnes Objekt benötigt, kann eine kleine Klasse erstellt werden, die die anderen erforderlichen Zustandsinformationen als Member enthält.

Wenn Sie ein verbindungsloses Protokoll wie UDP verwenden, müssen Sie vor dem Senden und Empfangen von Daten nicht aufrufen ConnectAsync . Sie können und ReceiveFromAsync verwendenSendToAsync, um mit einem Remotehost zu kommunizieren. Wenn Sie aufrufen ConnectAsync, werden alle Datagramme verworfen, die von einer anderen Adresse als der angegebenen Standardadresse empfangen werden. Wenn Sie den Standard-Remotehost ändern möchten, rufen Sie die ConnectAsync -Methode erneut mit dem gewünschten Endpunkt auf.

Wenn Sie den Standard-Remotehost auf eine Broadcastadresse festlegen möchten, müssen Sie zuerst aufrufen SetSocketOption und Broadcast auf truefestlegen. Wenn dies nicht der Fall ist, löst die ConnectAsync -Methode einen aus SocketException.

Die folgenden Eigenschaften und Ereignisse für das System.Net.Sockets.SocketAsyncEventArgs Objekt sind erforderlich:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Optional kann ein Puffer bereitgestellt werden, der atomar an den Socket gesendet wird, nachdem die ConnectAsync Methode erfolgreich war. In diesem Fall muss die SocketAsyncEventArgs.Buffer -Eigenschaft auf den Puffer festgelegt werden, der die zu sendenden Daten enthält, und die SocketAsyncEventArgs.Count -Eigenschaft muss auf die Anzahl der Daten festgelegt werden, die vom Puffer gesendet werden sollen. Sobald eine Verbindung hergestellt wurde, wird dieser Datenpuffer gesendet.

Wenn Sie ein verbindungsorientiertes Protokoll verwenden und vor dem Aufrufen ConnectAsyncnicht aufrufenBind, weist der zugrunde liegende Dienstanbieter die am besten geeignete lokale Netzwerkadresse und Portnummer zu.

Wenn Sie ein verbindungsloses Protokoll verwenden, weist der Dienstanbieter erst dann eine IP-Adresse und Portnummer des lokalen Netzwerks zu, wenn Sie die SendAsync Methoden oder ReceiveAsync aufrufen.

Die ConnectAsync -Methode löst aus NotSupportedException , wenn die Adressfamilie von Socket und nicht SocketAsyncEventArgs.RemoteEndPoint die gleiche Adressfamilie ist.

Weitere Informationen

• SocketAsyncEventArgs
• Buffer
• Completed
• Count
• RemoteEndPoint
• UserToken

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

Quelle:

Socket.Tasks.cs

public:
 System::Threading::Tasks::Task ^ ConnectAsync(System::Net::EndPoint ^ remoteEP);

public System.Threading.Tasks.Task ConnectAsync (System.Net.EndPoint remoteEP);

member this.ConnectAsync : System.Net.EndPoint -> System.Threading.Tasks.Task

Public Function ConnectAsync (remoteEP As EndPoint) As Task

Parameter

Gibt zurück

Eine asynchrone Aufgabe, die abgeschlossen wird, wenn die Verbindung hergestellt wird.

Ausnahmen

Hinweise

Diese Methode speichert in der Aufgabe, die alle Nichtverwendungsausnahmen zurückgibt, die die synchrone Entsprechung der Methode auslösen kann. Wenn eine Ausnahme in der zurückgegebenen Aufgabe gespeichert wird, wird diese Ausnahme ausgelöst, wenn die Aufgabe erwartet wird. Verwendungsausnahmen wie ArgumentExceptionwerden weiterhin synchron ausgelöst. Informationen zu den gespeicherten Ausnahmen finden Sie unter ausnahmen, die von ausgelöst werden Connect(EndPoint).