Socket.ConnectAsync Yöntem

Kaynak:

Socket.cs

Kaynak:

Socket.cs

Kaynak:

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

Parametreler

Döndürülenler

true G/Ç işlemi bekliyorsa. Completed parametresindeki e olay, işlem tamamlandıktan sonra tetiklenir.

false G/Ç işlemi zaman uyumlu olarak tamamlandıysa. Bu durumda, Completed parametredeki e olay tetiklenmez ve e parametre olarak geçirilen nesne, işlemin sonucunu almak için yöntem çağrısı döndürüldükten hemen sonra incelenebilir.

Özel durumlar

Açıklamalar

Bağlantı odaklı bir protokol kullanıyorsanız, M:System.Net.Sockets.Socket.ConnectAsync(System.Net.Sockets.SocketType,System.Net.Sockets.ProtocolType,System.Net.Sockets.SocketAsyncEventArgs) yöntemi uzak ana bilgisayara bağlantı için zaman uyumsuz bir istek başlatır. Bağlantısız bir protokol kullanıyorsanız, ConnectAsync ve protocolType parametreleri tarafından socketType belirtilen varsayılan bir uzak konak oluşturur.

Tamamlanma bildirimi almak için EventHandler<SocketAsyncEventArgs> temsilcisini uygulayan bir geri çağırma yöntemi oluşturmanız ve geri çağırmayı SocketAsyncEventArgs.Completed olaya eklemeniz gerekir.

Çağıranın SocketAsyncEventArgs.RemoteEndPoint , özelliğini IPEndPoint bağlanacak uzak konağın değerine ayarlaması gerekir.

Çağıran, yöntemi çağırmadan ConnectAsync önce istenen herhangi bir kullanıcı durumu nesnesine özelliğini ayarlayabilirSocketAsyncEventArgs.UserToken, böylece bilgiler geri çağırma yönteminde alınabilir. Geri çağırma tek bir nesneden daha fazla bilgiye ihtiyaç duyuyorsa, diğer gerekli durum bilgilerini üye olarak tutmak için küçük bir sınıf oluşturulabilir.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama ConnectAsync yapmanız gerekmez. uzak bir konakla iletişim kurmak için ve ReceiveFromAsync kullanabilirsinizSendToAsync. çağrısı ConnectAsyncyaparsanız, belirtilen varsayılan dışında bir adresten gelen tüm veri birimleri atılır. Varsayılan uzak konağı değiştirmek istiyorsanız istenen uç noktayla yöntemini yeniden çağırın ConnectAsync .

Varsayılan uzak ana bilgisayarı bir yayın adresine ayarlamak istiyorsanız, önce öğesini aramanız SetSocketOption ve Yayın'ı olarak trueayarlamanız gerekir. Bu yapılmazsa, ConnectAsync yöntemi bir SocketExceptionoluşturur.

Nesnede System.Net.Sockets.SocketAsyncEventArgs aşağıdaki özellikler ve olaylar gereklidir:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

İsteğe bağlı olarak, yöntem başarılı olduktan sonra ConnectAsync yuvaya atomik olarak gönderilecek bir arabellek sağlanabilir. Bu durumda, özelliğin SocketAsyncEventArgs.Buffer gönderilecek verileri içeren arabelleğe ayarlanması ve özelliğin SocketAsyncEventArgs.Count arabellekten gönderilecek veri bayt sayısına ayarlanması gerekir. Bağlantı kurulduktan sonra bu veri arabelleği gönderilir.

Bağlantı odaklı bir protokol kullanıyorsanız ve çağrısı ConnectAsyncyapmadan önce aramazsanızBind, temel alınan hizmet sağlayıcısı en uygun yerel ağ adresini ve bağlantı noktası numarasını atar.

Bağlantısız bir protokol kullanıyorsanız, veya ReceiveAsync yöntemlerini çağırana SendAsync kadar hizmet sağlayıcısı yerel bir ağ IP adresi ve bağlantı noktası numarası atamaz.

ve adres ConnectAsync ailesi aynı adres ailesi Socket değilse yöntemi oluştururNotSupportedException.SocketAsyncEventArgs.RemoteEndPoint

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(IPAddress[], Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(String, Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(IPAddress, Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(String, Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(IPAddress[], Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(IPAddress, Int32)özel durumlara bakın.

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(EndPoint)özel durumlara bakın.

Kaynak:

Socket.cs

Kaynak:

Socket.cs

Kaynak:

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

Parametreler

Döndürülenler

true G/Ç işlemi bekliyorsa. Completed parametresindeki e olay, işlem tamamlandıktan sonra tetiklenir.

false G/Ç işlemi zaman uyumlu olarak tamamlandıysa. Bu durumda parametredeki Completede olay tetiklenmez ve e yöntem çağrısı işlemin sonucunu almak için döndürdükten hemen sonra parametre olarak geçirilen nesne incelenebilir.

Özel durumlar

Açıklamalar

Bağlantı odaklı bir protokol kullanıyorsanız, ConnectAsync yöntemi uzak konakla bağlantı için zaman uyumsuz bir istek başlatır. Bağlantısız bir protokol kullanıyorsanız, ConnectAsync varsayılan uzak ana bilgisayar oluşturur.

Tamamlanma bildirimi almak için EventHandler<SocketAsyncEventArgs> temsilcisini uygulayan bir geri çağırma yöntemi oluşturmanız ve geri çağırmayı SocketAsyncEventArgs.Completed olaya eklemeniz gerekir.

Çağıranın SocketAsyncEventArgs.RemoteEndPoint , bağlanacak uzak konağın özelliğini IPEndPoint ayarlaması gerekir.

Çağıran, yöntemi çağırmadan ConnectAsync önce istenen herhangi bir kullanıcı durumu nesnesine özelliğini ayarlayabilirSocketAsyncEventArgs.UserToken, böylece bilgiler geri çağırma yönteminde alınabilir. Geri çağırma için tek bir nesneden daha fazla bilgi gerekiyorsa, diğer gerekli durum bilgilerini üye olarak tutmak için küçük bir sınıf oluşturulabilir.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama ConnectAsync yapmanız gerekmez. uzak bir konakla iletişim kurmak için ve ReceiveFromAsync kullanabilirsinizSendToAsync. çağrısı ConnectAsyncyaparsanız, belirtilen varsayılan dışında bir adresten gelen tüm veri birimleri atılır. Varsayılan uzak konağı değiştirmek istiyorsanız, istenen uç noktayla yöntemini yeniden çağırın ConnectAsync .

Varsayılan uzak konağı bir yayın adresi olarak ayarlamak istiyorsanız, önce çağrısı SetSocketOption yapıp Yayın'ı olarak trueayarlamanız gerekir. Bu yapılmazsa yöntemi ConnectAsync bir SocketExceptionoluşturur.

Nesnede System.Net.Sockets.SocketAsyncEventArgs aşağıdaki özellikler ve olaylar gereklidir:

• SocketAsyncEventArgs.Completed

• SocketAsyncEventArgs.RemoteEndPoint

İsteğe bağlı olarak, yöntem başarılı olduktan sonra ConnectAsync yuvaya atomik olarak gönderilecek bir arabellek sağlanabilir. Bu durumda, özelliğin SocketAsyncEventArgs.Buffer gönderilecek verileri içeren arabelleğe ayarlanması ve özelliğin SocketAsyncEventArgs.Count arabellekten gönderilecek veri bayt sayısına ayarlanması gerekir. Bağlantı kurulduktan sonra bu veri arabelleği gönderilir.

Bağlantı odaklı bir protokol kullanıyorsanız ve çağırmadan ConnectAsyncönce arama Bind yapmazsanız, temel alınan hizmet sağlayıcısı en uygun yerel ağ adresini ve bağlantı noktası numarasını atar.

Bağlantısız bir protokol kullanıyorsanız, veya yöntemlerini çağırana SendAsyncReceiveAsync kadar hizmet sağlayıcısı yerel bir ağ IP adresi ve bağlantı noktası numarası atamaz.

yöntemi, ConnectAsync ve SocketAsyncEventArgs.RemoteEndPoint adres ailesi aynı adres ailesi Socket değilse oluştururNotSupportedException.

Ayrıca bkz.

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

Kaynak:

Socket.Tasks.cs

Kaynak:

Socket.Tasks.cs

Kaynak:

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

Parametreler

Döndürülenler

Bağlantı kurulduğunda tamamlanan zaman uyumsuz bir görev.

Özel durumlar

Açıklamalar

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Connect(EndPoint)özel durumlara bakın.