Socket.BeginConnect Yöntem

Tanım

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır.

Aşırı Yüklemeler

BeginConnect(EndPoint, AsyncCallback, Object)

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır.

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak bir IPAddress ve bağlantı noktası numarası ile belirtilir.

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

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak bir IPAddress dizi ve bağlantı noktası numarası ile belirtilir.

BeginConnect(String, Int32, AsyncCallback, Object)

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak, bir ana bilgisayar adı ve bağlantı noktası numarası ile belirtilir.

BeginConnect(EndPoint, AsyncCallback, Object)

Kaynak:
Socket.cs
Kaynak:
Socket.cs
Kaynak:
Socket.cs

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır.

public:
 IAsyncResult ^ BeginConnect(System::Net::EndPoint ^ remoteEP, AsyncCallback ^ callback, System::Object ^ state);
public IAsyncResult BeginConnect (System.Net.EndPoint remoteEP, AsyncCallback? callback, object? state);
public IAsyncResult BeginConnect (System.Net.EndPoint remoteEP, AsyncCallback callback, object state);
member this.BeginConnect : System.Net.EndPoint * AsyncCallback * obj -> IAsyncResult
Public Function BeginConnect (remoteEP As EndPoint, callback As AsyncCallback, state As Object) As IAsyncResult

Parametreler

remoteEP
EndPoint

EndPoint Uzak konağı temsil eden bir.

callback
AsyncCallback

Temsilci AsyncCallback .

state
Object

Bu istek için durum bilgilerini içeren bir nesne.

Döndürülenler

IAsyncResult Zaman uyumsuz bağlantıya başvuran bir.

Özel durumlar

remoteEP, null değeridir.

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

Çağrı yığınında daha yüksek bir çağıranın istenen işlem için izni yok.

Socket çağrısıyla Listen(Int32)dinleme durumuna alındı veya zaman uyumsuz bir işlem zaten devam ediyor.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

Bağlantı odaklı protokoller, gelen bağlantı girişimlerini kabul etmeye başlamak için yöntemini kullanabilir BeginAccept . Sonuçta elde edilen kabul etme işlemi, zaman uyumlu olarak tamamlansa bile döndürülen IAsyncResult ile temsil edilir. yöntemini çağırmadan BeginAccept önce gelen bağlantı isteklerini dinlemek ve kuyruğa almak için yöntemini çağırmanız Listen gerekir.

Kabul etme işleminin tamamlanması hakkında bildirim almak için öğesini uygulayan AsyncCallbackBeginAccept bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginAcceptsatır içinde yürütülebileceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginAccept özelliğini IAsyncResult kullanın.

İşlemin BeginAccept yöntemi çağrılarak EndAccept tamamlanması gerekir. Yöntem genellikle sağlanan AsyncCallback temsilci tarafından çağrılır. EndAccept işlem tamamlanana kadar çağıran iş parçacığını engeller.

yöntemine yapılan bekleyen çağrıyı BeginAccept iptal etmek için öğesini Socketkapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginAccept sağlanan geri çağırma çağrılır. Yöntemine yapılan EndAccept sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

Uzak konağın RemoteEndPoint ağ adresini ve bağlantı noktası numarasını tanımlamak için döndürülen Socket özelliğini kullanabilirsiniz.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

Şunlara uygulanır

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Kaynak:
Socket.cs
Kaynak:
Socket.cs
Kaynak:
Socket.cs

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak bir IPAddress ve bağlantı noktası numarası ile belirtilir.

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);
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

Parametreler

address
IPAddress

IPAddress Uzak konağın.

port
Int32

Uzak konağın bağlantı noktası numarası.

requestCallback
AsyncCallback

AsyncCallback Bağlantı işlemi tamamlandığında çağrılacak yönteme başvuran bir temsilci.

state
Object

Bağlantı işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye requestCallback geçirilir.

Döndürülenler

IAsyncResult Zaman uyumsuz bağlantıya başvuran bir.

Özel durumlar

address, null değeridir.

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

Socket yuva ailesinde değil.

Bağlantı noktası numarası geçerli değil.

uzunluğu address sıfırdır.

Socket çağrısıyla Listen(Int32)dinleme durumuna alındı veya zaman uyumsuz bir işlem zaten devam ediyor.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

Bağlantı odaklı bir protokol kullanıyorsanız, BeginConnect yöntemi parametresi tarafından remoteEP belirtilen uç noktaya bağlantı için zaman uyumsuz bir istek başlatır. Bağlantısız bir protokol kullanıyorsanız, BeginConnect varsayılan uzak ana bilgisayar oluşturur.

Bağlama işleminin AsyncCallbackBeginConnect tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginConnectsatır içinde yürütülebileceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginConnect özelliğini IAsyncResult kullanın.

İşlemin BeginConnect yöntemi çağrılarak EndConnect tamamlanması gerekir. Yöntem genellikle sağlanan AsyncCallback temsilci tarafından çağrılır. EndConnect işlem tamamlanana kadar çağıran iş parçacığını engeller.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama BeginConnect yapmanız gerekmez. uzak bir konakla iletişim kurmak için ve BeginReceiveFrom kullanabilirsinizBeginSendTo. çağrısı BeginConnectyaparsanız, belirtilen varsayılan dışında bir adresten gelen tüm veri birimleri atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce öğesini aramalı SetSocketOption ve Yayın trueolarak ayarlamalısınız. Yapamazsanız, BeginConnect bir SocketExceptionoluşturur.

Bağlantı odaklı bir protokol kullanıyorsanız ve çağırmadan BeginConnectö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öntemini çağırana BeginSendReceiveFrom kadar hizmet sağlayıcısı yerel bir ağ adresi ve bağlantı noktası numarası atamaz. Varsayılan uzak konağı değiştirmek istiyorsanız, istenen uç noktayla yöntemini yeniden çağırın BeginConnect .

yöntemine yapılan bekleyen çağrıyı BeginConnect iptal etmek için öğesini Socketkapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginConnect sağlanan geri çağırma çağrılır. Yöntemine yapılan EndConnect sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Bu yuvanın bağlantısı daha önce kesilmişse, BeginConnect işlem tamamlanana kadar çıkılmayan bir iş parçacığında çağrılmalıdır. Bu, temel alınan sağlayıcının bir sınırlamasıdır.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

Şunlara uygulanır

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

Kaynak:
Socket.cs
Kaynak:
Socket.cs
Kaynak:
Socket.cs

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak bir IPAddress dizi ve bağlantı noktası numarası ile belirtilir.

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);
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

Parametreler

addresses
IPAddress[]

En az bir IPAddress, uzak konağı belirtir.

port
Int32

Uzak konağın bağlantı noktası numarası.

requestCallback
AsyncCallback

AsyncCallback Bağlantı işlemi tamamlandığında çağrılacak yönteme başvuran bir temsilci.

state
Object

Bağlantı işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye requestCallback geçirilir.

Döndürülenler

IAsyncResult Zaman uyumsuz bağlantılara başvuran bir.

Özel durumlar

addresses, null değeridir.

Yalnızca .NET Framework ve .NET 5 ve öncesi: Yuvaya erişmeye çalışılırken bir hata oluştu.

Bu yöntem, veya InterNetworkV6kullanan InterNetwork yuvalar için geçerlidir.

Bağlantı noktası numarası geçerli değil.

uzunluğu address sıfırdır.

Socket çağrısıyla Listen(Int32)dinleme durumuna alındı veya zaman uyumsuz bir işlem zaten devam ediyor.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

Bağlantı odaklı bir protokol kullanıyorsanız, BeginConnect yöntemi parametresi tarafından remoteEP belirtilen uç noktaya bağlantı için zaman uyumsuz bir istek başlatır. Bağlantısız bir protokol kullanıyorsanız, BeginConnect varsayılan uzak ana bilgisayar oluşturur.

Bağlama işleminin AsyncCallbackBeginConnect tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginConnectsatır içinde yürütülebileceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginConnect özelliğini IAsyncResult kullanın.

İşlemin BeginConnect yöntemi çağrılarak EndConnect tamamlanması gerekir. Yöntem genellikle sağlanan AsyncCallback temsilci tarafından çağrılır. EndConnect işlem tamamlanana kadar çağıran iş parçacığını engeller.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama BeginConnect yapmanız gerekmez. uzak bir konakla iletişim kurmak için ve BeginReceiveFrom kullanabilirsinizBeginSendTo. çağrısı BeginConnectyaparsanız, belirtilen varsayılan dışında bir adresten gelen tüm veri birimleri atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce öğesini aramalı SetSocketOption ve Yayın trueolarak ayarlamalısınız. Yapamazsanız, BeginConnect bir SocketExceptionoluşturur.

Bağlantı odaklı bir protokol kullanıyorsanız ve çağırmadan BeginConnectö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öntemini çağırana BeginSendReceiveFrom kadar hizmet sağlayıcısı yerel bir ağ adresi ve bağlantı noktası numarası atamaz. Varsayılan uzak konağı değiştirmek istiyorsanız, istenen uç noktayla yöntemini yeniden çağırın BeginConnect .

yöntemine yapılan bekleyen çağrıyı BeginConnect iptal etmek için öğesini Socketkapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginConnect sağlanan geri çağırma çağrılır. Yöntemine yapılan EndConnect sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Bu yuvanın bağlantısı daha önce kesilmişse, BeginConnect işlem tamamlanana kadar çıkılmayan bir iş parçacığında çağrılmalıdır. Bu, temel alınan sağlayıcının bir sınırlamasıdır.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

Şunlara uygulanır

BeginConnect(String, Int32, AsyncCallback, Object)

Kaynak:
Socket.cs
Kaynak:
Socket.cs
Kaynak:
Socket.cs

Uzak konak bağlantısı için zaman uyumsuz bir istek başlatır. Konak, bir ana bilgisayar adı ve bağlantı noktası numarası ile belirtilir.

public:
 IAsyncResult ^ BeginConnect(System::String ^ host, int port, AsyncCallback ^ requestCallback, System::Object ^ state);
public IAsyncResult BeginConnect (string host, int port, AsyncCallback? requestCallback, 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

Parametreler

host
String

Uzak konağın adı.

port
Int32

Uzak konağın bağlantı noktası numarası.

requestCallback
AsyncCallback

AsyncCallback Bağlantı işlemi tamamlandığında çağrılacak yönteme başvuran bir temsilci.

state
Object

Bağlantı işlemi hakkında bilgi içeren kullanıcı tanımlı bir nesne. İşlem tamamlandığında bu nesne temsilciye requestCallback geçirilir.

Döndürülenler

IAsyncResult Zaman uyumsuz bağlantıya başvuran bir.

Özel durumlar

host, null değeridir.

Bu yöntem, veya InterNetworkV6 ailelerindeki InterNetwork yuvalar için geçerlidir.

Bağlantı noktası numarası geçerli değil.

Socket çağrısıyla Listen(Int32)dinleme durumuna alındı veya zaman uyumsuz bir işlem zaten devam ediyor.

Açıklamalar

Önemli

Bu bir uyumluluk API'sidir. Yeni geliştirme için APM (Begin* ve End*) yöntemlerini kullanmanızı önermiyoruz. Bunun yerine tabanlı eşdeğerleri kullanın Task.

Bağlantı odaklı bir protokol kullanıyorsanız, BeginConnect yöntemi parametresi tarafından remoteEP belirtilen uç noktaya bağlantı için zaman uyumsuz bir istek başlatır. Bağlantısız bir protokol kullanıyorsanız, BeginConnect varsayılan uzak ana bilgisayar oluşturur.

Bağlama işleminin AsyncCallbackBeginConnect tamamlanması hakkında bildirim almak için uygulamasına uygulanan bir geri çağırma geçirebilirsiniz. Temel alınan ağ yığını işlemi zaman uyumlu bir şekilde tamamlarsa, çağrısı sırasında geri çağırmanın BeginConnectsatır içinde yürütülebileceğini unutmayın. Bu durumda, döndürülen IAsyncResult üzerindeki özelliği yöntemin CompletedSynchronously zaman uyumlu olarak tamamlandığını belirtmek için olarak ayarlanırtrue. yöntemine AsyncState geçirilen durum nesnesini almak için BeginConnect özelliğini IAsyncResult kullanın.

İşlemin BeginConnect yöntemi çağrılarak EndConnect tamamlanması gerekir. Yöntem genellikle sağlanan AsyncCallback temsilci tarafından çağrılır. EndConnect işlem tamamlanana kadar çağıran iş parçacığını engeller.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama BeginConnect yapmanız gerekmez. uzak bir konakla iletişim kurmak için ve BeginReceiveFrom kullanabilirsinizBeginSendTo. çağrısı BeginConnectyaparsanız, belirtilen varsayılan dışında bir adresten gelen tüm veri birimleri atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce öğesini aramalı SetSocketOption ve Yayın trueolarak ayarlamalısınız. Yapamazsanız, BeginConnect bir SocketExceptionoluşturur.

Bağlantı odaklı bir protokol kullanıyorsanız ve çağırmadan BeginConnectö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öntemini çağırana BeginSendReceiveFrom kadar hizmet sağlayıcısı yerel bir ağ adresi ve bağlantı noktası numarası atamaz. Varsayılan uzak konağı değiştirmek istiyorsanız, istenen uç noktayla yöntemini yeniden çağırın BeginConnect .

yöntemine yapılan bekleyen çağrıyı BeginConnect iptal etmek için öğesini Socketkapatın. Close Zaman uyumsuz bir işlem devam ederken yöntemi çağrıldığında, yöntemine BeginConnect sağlanan geri çağırma çağrılır. Yöntemine yapılan EndConnect sonraki bir çağrı, işlemin iptal edildiğini belirtmek için bir ObjectDisposedException (.NET 7'den önce) veya SocketException bir (.NET 7+'da) oluşturur.

Not

bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode .

Not

Bu yuvanın bağlantısı daha önce kesilmişse, BeginConnect işlem tamamlanana kadar çıkılmayan bir iş parçacığında çağrılmalıdır. Bu, temel alınan sağlayıcının bir sınırlamasıdır.

Not

Uygulamanızda ağ izlemeyi etkinleştirdiğinizde, bu üye izleme bilgilerini çıkarır. Daha fazla bilgi için bkz. .NET Framework'da Ağ İzleme.

Not

Yürütme bağlamı (güvenlik bağlamı, kimliğine bürünülen kullanıcı ve çağırma bağlamı) zaman uyumsuz Socket yöntemler için önbelleğe alınır. Belirli bir bağlamın (belirli bir zaman uyumsuz Socket yöntem, belirli bir örnek ve belirli Socket bir geri çağırma) ilk kullanımından sonra, bu bağlamın sonraki kullanımları bir performans geliştirmesi görecektir.

Ayrıca bkz.

Şunlara uygulanır