Socket.ConnectAsync Metod

Källa:

Socket.cs

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

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

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

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

Parametrar

Returer

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(String, Int32).

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

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

Parametrar

Returer

true om I/O-åtgärden väntar. Händelsen Completed på parametern e utlöses när åtgärden har slutförts.

false om I/O-åtgärden slutfördes synkront. I det här fallet Completed utlöses inte händelsen för parametern e och objektet e som skickas som en parameter kan undersökas omedelbart efter att metodanropet returneras för att hämta resultatet av åtgärden.

Undantag

Kommentarer

Om du använder ett anslutningsorienterat protokoll startar metoden M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) en asynkron begäran om en anslutning till fjärrvärden. Om du använder ett anslutningslöst protokoll ConnectAsync upprättar en standardvärd som anges av parametrarna socketType och protocolType .

För att meddelas om slutförandet måste du skapa en motringningsmetod som implementerar EventHandler<SocketAsyncEventArgs-ombudet> och kopplar återanropet SocketAsyncEventArgs.Completed till händelsen.

Anroparen måste ange SocketAsyncEventArgs.RemoteEndPoint egenskapen till IPEndPoint den fjärrvärd som ska anslutas till.

Anroparen kan ange SocketAsyncEventArgs.UserToken egenskapen till valfritt användartillståndsobjekt som önskas innan metoden anropas ConnectAsync , så att informationen kan hämtas i motringningsmetoden. Om återanropet behöver mer information än ett enskilt objekt kan en liten klass skapas för att lagra den andra nödvändiga tillståndsinformationen som medlemmar.

Om du använder ett anslutningslöst protokoll, till exempel UDP, behöver du inte anropa ConnectAsync innan du skickar och tar emot data. Du kan använda SendToAsync och ReceiveFromAsync för att kommunicera med en fjärrvärd. Om du anropar ConnectAsyncignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Om du vill ändra standardvärden för fjärranslutning anropar ConnectAsync du metoden igen med önskad slutpunkt.

Om du vill ange standardvärden för fjärrvärden till en sändningsadress måste du först anropa SetSocketOption och ställa in Broadcast till true. Om detta inte ConnectAsync görs genererar metoden en SocketException.

Följande egenskaper och händelser för System.Net.Sockets.SocketAsyncEventArgs objektet krävs:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Du kan också ange en buffert som ska skickas atomiskt på socketen ConnectAsync när metoden har slutförts. I det här fallet SocketAsyncEventArgs.Buffer måste egenskapen anges till bufferten som innehåller de data som ska skickas och SocketAsyncEventArgs.Count egenskapen måste anges till antalet byte av data som ska skickas från bufferten. När en anslutning har upprättats skickas den här databufferten.

Om du använder ett anslutningsorienterat protokoll och inte anropar Bind innan du anropar ConnectAsynctilldelar den underliggande tjänstleverantören den lämpligaste lokala nätverksadressen och portnumret.

Om du använder ett anslutningslöst protokoll tilldelar tjänsteleverantören inte en lokal nätverks-IP-adress och portnummer förrän du anropar SendAsync metoderna eller ReceiveAsync .

Metoden ConnectAsync utlöser NotSupportedException om adressfamiljen för Socket och SocketAsyncEventArgs.RemoteEndPoint inte är samma adressfamilj.

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress[], Int32).

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress, Int32).

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(String, Int32).

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress[], Int32).

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(IPAddress, Int32).

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(EndPoint).

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

Socket.cs

Källa:

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

Parametrar

Returer

true om I/O-åtgärden väntar. Händelsen Completed på parametern e utlöses när åtgärden har slutförts.

false om I/O-åtgärden slutfördes synkront. I det här fallet Completed utlöses inte händelsen för parametern e och objektet e som skickas som en parameter kan undersökas omedelbart efter att metodanropet returneras för att hämta resultatet av åtgärden.

Undantag

Kommentarer

Om du använder ett anslutningsorienterat protokoll ConnectAsync startar metoden en asynkron begäran om en anslutning till fjärrvärden. Om du använder ett anslutningslöst protokoll ConnectAsync upprättar du en standardvärd för fjärranslutningen.

För att meddelas om slutförandet måste du skapa en motringningsmetod som implementerar EventHandler<SocketAsyncEventArgs-ombudet> och kopplar återanropet SocketAsyncEventArgs.Completed till händelsen.

Anroparen måste ange SocketAsyncEventArgs.RemoteEndPoint egenskapen till IPEndPoint den fjärrvärd som ska anslutas till.

Anroparen kan ange SocketAsyncEventArgs.UserToken egenskapen till valfritt användartillståndsobjekt som önskas innan metoden anropas ConnectAsync , så att informationen kan hämtas i motringningsmetoden. Om återanropet behöver mer information än ett enskilt objekt kan en liten klass skapas för att lagra den andra nödvändiga tillståndsinformationen som medlemmar.

Om du använder ett anslutningslöst protokoll, till exempel UDP, behöver du inte anropa ConnectAsync innan du skickar och tar emot data. Du kan använda SendToAsync och ReceiveFromAsync för att kommunicera med en fjärrvärd. Om du anropar ConnectAsyncignoreras alla datagram som kommer från en annan adress än den angivna standardinställningen. Om du vill ändra standardvärden för fjärranslutning anropar ConnectAsync du metoden igen med önskad slutpunkt.

Om du vill ange standardvärden för fjärrvärden till en sändningsadress måste du först anropa SetSocketOption och ställa in Broadcast till true. Om detta inte ConnectAsync görs genererar metoden en SocketException.

Följande egenskaper och händelser för System.Net.Sockets.SocketAsyncEventArgs objektet krävs:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

Du kan också ange en buffert som ska skickas atomiskt på socketen ConnectAsync när metoden har slutförts. I det här fallet SocketAsyncEventArgs.Buffer måste egenskapen anges till bufferten som innehåller de data som ska skickas och SocketAsyncEventArgs.Count egenskapen måste anges till antalet byte av data som ska skickas från bufferten. När en anslutning har upprättats skickas den här databufferten.

Om du använder ett anslutningsorienterat protokoll och inte anropar Bind innan du anropar ConnectAsynctilldelar den underliggande tjänstleverantören den lämpligaste lokala nätverksadressen och portnumret.

Om du använder ett anslutningslöst protokoll tilldelar tjänsteleverantören inte en lokal nätverks-IP-adress och portnummer förrän du anropar SendAsync metoderna eller ReceiveAsync .

Metoden ConnectAsync utlöser NotSupportedException om adressfamiljen för Socket och SocketAsyncEventArgs.RemoteEndPoint inte är samma adressfamilj.

Se även

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

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

Socket.Tasks.cs

Källa:

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

Parametrar

Returer

En asynkron uppgift som slutförs när anslutningen upprättas.

Undantag

Kommentarer

Den här metoden lagrar i aktiviteten som returnerar alla undantag som inte används som metodens synkrona motsvarighet kan utlösa. Om ett undantag lagras i den returnerade aktiviteten utlöses undantaget när aktiviteten väntar. Användningsfel, till exempel ArgumentException, genereras fortfarande synkront. De lagrade undantagen finns i undantagen som genereras av Connect(EndPoint).