Socket.Connect Yöntem

Başvuru

Tanım

Ad Alanı:: System.Net.Sockets

Bütünleştirilmiş Kod:: System.Net.Sockets.dll

Bütünleştirilmiş Kod:: System.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Uzak bir konakla bağlantı kurar.

Aşırı Yüklemeler

Connect(EndPoint)	Uzak bir konakla bağlantı kurar.
Connect(IPAddress, Int32)	Uzak bir konakla bağlantı kurar. Ana bilgisayar bir IP adresi ve bağlantı noktası numarası ile belirtilir.
Connect(IPAddress[], Int32)	Uzak bir konakla bağlantı kurar. Ana bilgisayar bir IP adresleri dizisi ve bağlantı noktası numarası ile belirtilir.
Connect(String, Int32)	Uzak bir konakla bağlantı kurar. Konak, bir ana bilgisayar adı ve bağlantı noktası numarası ile belirtilir.

Connect(EndPoint)

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Uzak bir konakla bağlantı kurar.

public:
 void Connect(System::Net::EndPoint ^ remoteEP);

public void Connect (System.Net.EndPoint remoteEP);

member this.Connect : System.Net.EndPoint -> unit

Public Sub Connect (remoteEP As EndPoint)

Parametreler

remoteEP: EndPoint

EndPoint Uzak cihazı temsil eden bir.

Özel durumlar

ArgumentNullException

remoteEP, null değeridir.

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

SecurityException

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

InvalidOperationException

Socket çağrısıyla Listen(Int32)dinleme durumuna geçirilmiştir.

Örnekler

Aşağıdaki kod örneği uzak bir uç noktaya bağlanır ve ardından bağlantıyı doğrular.

client->Connect( anEndPoint );
if (  !client->Connected )
{
   Console::WriteLine( "Winsock error: {0}", Convert::ToString(
      System::Runtime::InteropServices::Marshal::GetLastWin32Error() ) );
}
   
// This is how you can determine whether a socket is still connected.
bool blockingState = client->Blocking;
try
{
   array<Byte>^tmp = gcnew array<Byte>(1);
   client->Blocking = false;
   client->Send( tmp, 0, static_cast<SocketFlags>(0) );
   Console::WriteLine( L"Connected!" );
}
catch ( SocketException^ e ) 
{
   // 10035 == WSAEWOULDBLOCK
   if ( e->NativeErrorCode.Equals( 10035 ) )
   {
      Console::WriteLine( "Connected from an exception!" );
   }
   else
   {
      Console::WriteLine( "Disconnected: {0}!", e->NativeErrorCode );
   }
}
finally
{
   client->Blocking = blockingState;
}

Console::WriteLine( "Connected: {0}", client->Connected );

// .Connect throws an exception if unsuccessful
client.Connect(anEndPoint);

// This is how you can determine whether a socket is still connected.
bool blockingState = client.Blocking;
try
{
    byte [] tmp = new byte[1];

    client.Blocking = false;
    client.Send(tmp, 0, 0);
    Console.WriteLine("Connected!");
}
catch (SocketException e)
{
    // 10035 == WSAEWOULDBLOCK
    if (e.NativeErrorCode.Equals(10035))
    {
        Console.WriteLine("Still Connected, but the Send would block");
    }
    else
    {
        Console.WriteLine("Disconnected: error code {0}!", e.NativeErrorCode);
    }
}
finally
{
    client.Blocking = blockingState;
}

Console.WriteLine("Connected: {0}", client.Connected);

    ' .Connect throws an exception if unsuccessful
    client.Connect(anEndPoint)
    
    ' This is how you can determine whether a socket is still connected.
    Dim blockingState As Boolean = client.Blocking
    Try
        Dim tmp(0) As Byte
        
        client.Blocking = False
        client.Send(tmp, 0, 0)
        Console.WriteLine("Connected!")
    Catch e As SocketException
        ' 10035 == WSAEWOULDBLOCK
        If e.NativeErrorCode.Equals(10035) Then
            Console.WriteLine("Still Connected, but the Send would block")
        Else
            Console.WriteLine("Disconnected: error code {0}!", e.NativeErrorCode)
        End If
    Finally
        client.Blocking = blockingState
    End Try
    
    Console.WriteLine("Connected: {0}", client.Connected)

End Sub

Açıklamalar

TCP gibi bağlantı odaklı bir protokol kullanıyorsanız, Connect yöntemi ile belirtilen uzak uç nokta arasında LocalEndPoint zaman uyumlu bir ağ bağlantısı kurar. Bağlantısız bir protokol kullanıyorsanız, Connect varsayılan uzak ana bilgisayar oluşturur. çağrısı Connectyaptıktan sonra yöntemiyle Send uzak cihaza veri gönderebilir veya yöntemiyle uzak cihazdan Receive veri alabilirsiniz.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama Connect yapmanız gerekmez. uzak bir konakla zaman uyumlu bir şekilde iletişim kurmak için ve ReceiveFrom kullanabilirsinizSendTo. çağrısı Connectyaparsanı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 yöntemini çağırmanız SetSocketOption ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlamanız gerekir, aksi Connect takdirde bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

Connect özelliğini false çağırmadan Connectönce olarak ayarlamadığınız Blocking sürece yöntemi engellenir. TCP gibi bağlantı odaklı bir protokol kullanıyorsanız ve engellemeyi devre dışı bırakırsanız, Connect bağlantının yapılması için zamana ihtiyacı olduğundan bir SocketException oluşturur. Bağlantısız protokoller bir özel durum oluşturmaz çünkü yalnızca varsayılan uzak ana bilgisayar oluştururlar. Belirli bir hata kodunu almak için komutunu kullanabilirsiniz SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın. Hata WSAEWOULDBLOCK döndürdüyse, uzak konak bağlantısı bağlantı odaklı Socketbir tarafından başlatılmıştır, ancak henüz başarıyla tamamlanmamıştır. bağlantısının Poll ne zaman Socket biteceğini belirlemek için yöntemini kullanın.

Not

Bağlantı odaklı bir protokol kullanıyorsanız ve çağrısı Connectyapmadan önce çağırmadıysanızBind, temel alınan hizmet sağlayıcısı yerel ağ adresini ve bağlantı noktası numarasını atar. Bağlantısız bir protokol kullanıyorsanız, siz gönderme veya alma işlemini tamamlayana 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 yeniden çağırın Connect .

Not

Yuvanın bağlantısı daha önce kesilmişse, bağlantıyı geri yüklemek için bu yöntemi kullanamazsınız. Yeniden bağlanmak için zaman uyumsuz BeginConnect yöntemlerden birini kullanın. 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.

Ayrıca bkz.

Şunlara uygulanır

Connect(IPAddress, Int32)

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Uzak bir konakla bağlantı kurar. Ana bilgisayar bir IP adresi ve bağlantı noktası numarası ile belirtilir.

public:
 void Connect(System::Net::IPAddress ^ address, int port);

public void Connect (System.Net.IPAddress address, int port);

member this.Connect : System.Net.IPAddress * int -> unit

Public Sub Connect (address As IPAddress, port As Integer)

Parametreler

address: IPAddress

Uzak konağın IP adresi.

port: Int32

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

Özel durumlar

ArgumentNullException

address, null değeridir.

ArgumentOutOfRangeException

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

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

NotSupportedException

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

ArgumentException

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

InvalidOperationException

Socket çağrısıyla Listen(Int32)dinleme durumuna geçirilmiştir.

Örnekler

Aşağıdaki kod örneği uzak bir uç noktaya bağlanır ve ardından bağlantıyı doğrular.

// Synchronous connect using IPAddress to resolve the 
// host name.
static void Connect1( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs[ 0 ], port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using IPAddress to resolve the
// host name.
public static void Connect1(string host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);

    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(IPs[0], port);
    Console.WriteLine("Connection established");
}

Açıklamalar

TCP gibi bağlantı odaklı bir protokol kullanıyorsanız, Connect yöntemi ile belirtilen uzak uç nokta arasında LocalEndPoint zaman uyumlu bir ağ bağlantısı kurar. Bağlantısız bir protokol kullanıyorsanız, Connect varsayılan uzak ana bilgisayar oluşturur. Çağrısı Connect yaptıktan sonra yöntemiyle Send uzak cihaza veri gönderebilir veya yöntemiyle uzak cihazdan Receive veri alabilirsiniz.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama Connect yapmanız gerekmez. uzak bir konakla zaman uyumlu bir şekilde iletişim kurmak için ve ReceiveFrom kullanabilirsinizSendTo. Belirtilen varsayılan dışında bir adresten gelen veri birimlerini çağırırsanız Connect atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce yöntemini çağırmanız SetSocketOption ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlamanız gerekir, aksi Connect takdirde bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

Connectyönteminin özelliğini çağırmadan Connectönce olarak ayarlamadığınız Blockingfalse sürece yöntemini engeller. TCP gibi bağlantı odaklı bir protokol kullanıyorsanız ve engellemeyi devre dışı bırakırsanız, Connect bağlantının yapılması için zamana ihtiyacı olduğundan bir SocketException oluşturur. Bağlantısız protokoller bir özel durum oluşturmaz çünkü yalnızca varsayılan uzak ana bilgisayar oluştururlar. Belirli bir hata kodunu almak için komutunu kullanabilirsiniz SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın. Hata WSAEWOULDBLOCK döndürdüyse, uzak konak bağlantısı bağlantı odaklı Socketbir tarafından başlatılmıştır, ancak henüz başarıyla tamamlanmamıştır. bağlantısının Poll ne zaman Socket biteceğini belirlemek için yöntemini kullanın.

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.

Şunlara uygulanır

Connect(IPAddress[], Int32)

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Uzak bir konakla bağlantı kurar. Ana bilgisayar bir IP adresleri dizisi ve bağlantı noktası numarası ile belirtilir.

public:
 void Connect(cli::array <System::Net::IPAddress ^> ^ addresses, int port);

public void Connect (System.Net.IPAddress[] addresses, int port);

member this.Connect : System.Net.IPAddress[] * int -> unit

Public Sub Connect (addresses As IPAddress(), port As Integer)

Parametreler

addresses: IPAddress[]

Uzak konağın IP adresleri.

port: Int32

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

Özel durumlar

ArgumentNullException

addresses, null değeridir.

ArgumentOutOfRangeException

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

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

NotSupportedException

Yuva ya InterNetworkV6 da ailelerde InterNetwork değil.

ArgumentException

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

InvalidOperationException

Socket çağrısıyla Listen(Int32)dinleme durumuna geçirilmiştir.

Örnekler

Aşağıdaki kod örneği uzak bir uç noktaya bağlanır ve ardından bağlantıyı doğrular.

// Synchronous connect using Dns.ResolveToAddresses to 
// resolve the host name.
static void Connect2( String^ host, int port )
{
   array<IPAddress^>^IPs = Dns::GetHostAddresses( host );
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( IPs, port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using Dns.GetHostAddresses to
// resolve the host name.
public static void Connect2(string host, int port)
{
    IPAddress[] IPs = Dns.GetHostAddresses(host);

    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);
    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(IPs, port);
    Console.WriteLine("Connection established");
}

Açıklamalar

Bu yöntem genellikle çağrısının hemen ardından kullanılır ve tek bir GetHostAddresseskonak için birden çok IP adresi döndürebilir. TCP gibi bağlantı odaklı bir protokol kullanıyorsanız, Connect yöntemi ile belirtilen uzak uç nokta arasında LocalEndPoint zaman uyumlu bir ağ bağlantısı kurar. Bağlantısız bir protokol kullanıyorsanız, Connect varsayılan uzak ana bilgisayar oluşturur. Çağrısı Connect yaptıktan sonra yöntemiyle Send uzak cihaza veri gönderebilir veya yöntemiyle uzak cihazdan Receive veri alabilirsiniz.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri gönderip almadan önce arama Connect yapmanız gerekmez. uzak bir konakla zaman uyumlu bir şekilde iletişim kurmak için ve ReceiveFrom kullanabilirsinizSendTo. Belirtilen varsayılan dışında bir adresten gelen veri birimlerini çağırırsanız Connect atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce yöntemini çağırmanız SetSocketOption ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlamanız gerekir, aksi Connect takdirde bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

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.

Şunlara uygulanır

Connect(String, Int32)

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Kaynak:: Socket.cs

Uzak bir konakla bağlantı kurar. Konak, bir ana bilgisayar adı ve bağlantı noktası numarası ile belirtilir.

public:
 void Connect(System::String ^ host, int port);

public void Connect (string host, int port);

member this.Connect : string * int -> unit

Public Sub Connect (host As String, port As Integer)

Parametreler

host: String

Uzak konağın adı.

port: Int32

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

Özel durumlar

ArgumentNullException

host, null değeridir.

ArgumentOutOfRangeException

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

SocketException

Yuvaya erişmeye çalışılırken bir hata oluştu.

ObjectDisposedException

Kapatılmış Socket .

NotSupportedException

Yuva ya InterNetworkV6 da ailelerde InterNetwork değil.

InvalidOperationException

Socket çağrısıyla Listen(Int32)dinleme durumuna geçirilmiştir.

Örnekler

Aşağıdaki kod örneği uzak bir uç noktaya bağlanır ve ardından bağlantıyı doğrular.

// Synchronous connect using host name (resolved by the 
// Connect call.)
static void Connect3( String^ host, int port )
{
   Socket^ s = gcnew Socket( AddressFamily::InterNetwork,SocketType::Stream,ProtocolType::Tcp );
   Console::WriteLine( "Establishing Connection to {0}", host );
   s->Connect( host, port );
   Console::WriteLine( "Connection established" );
}

// Synchronous connect using host name (resolved by the
// Connect call.)
public static void Connect3(string host, int port)
{
    Socket s = new Socket(AddressFamily.InterNetwork,
        SocketType.Stream,
        ProtocolType.Tcp);

    Console.WriteLine("Establishing Connection to {0}",
        host);
    s.Connect(host, port);
    Console.WriteLine("Connection established");
}

Açıklamalar

TCP gibi bağlantı odaklı bir protokol kullanıyorsanız, Connect yöntemi ile belirtilen uzak konak arasında LocalEndPoint zaman uyumlu bir ağ bağlantısı kurar. Bağlantısız bir protokol kullanıyorsanız, Connect varsayılan uzak ana bilgisayar oluşturur. Çağrısı Connect yaptıktan sonra yöntemiyle Send uzak cihaza veri gönderebilir veya yöntemiyle uzak cihazdan Receive veri alabilirsiniz.

UDP gibi bağlantısız bir protokol kullanıyorsanız, veri göndermeden ve almadan önce arama Connect yapmanız gerekmez. uzak bir konakla zaman uyumlu bir şekilde iletişim kurmak için ve ReceiveFrom kullanabilirsinizSendTo. Belirtilen varsayılan dışında bir adresten gelen veri birimlerini çağırırsanız Connect atılır. Varsayılan uzak ana bilgisayarınızı bir yayın adresine ayarlamak istiyorsanız, önce yöntemini çağırmanız SetSocketOption ve yuva seçeneğini olarak SocketOptionName.Broadcastayarlamanız gerekir, aksi Connect takdirde bir SocketExceptionoluşturur. bir alırsanız, belirli bir SocketExceptionhata kodunu almak için özelliğini kullanın SocketException.ErrorCode . Bu kodu aldıktan sonra, hatanın ayrıntılı açıklaması için Windows Yuvaları sürüm 2 API hata kodu belgelerine bakın.

IPv6 etkinleştirilirse ve Connect(String, Int32) yöntemi hem IPv6 hem de IPv4 adreslerine çözümlenen bir konağa bağlanmak için çağrılırsa, önce IPv4 adresinden önce IPv6 adresiyle bağlantı denenecektir. Bu, ana bilgisayar IPv6 adresinde dinlemiyorsa bağlantı kurma süresini geciktirme etkisine sahip olabilir.

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.

Şunlara uygulanır

Aracılığıyla paylaş

Socket.Connect Yöntem

Tanım

Aşırı Yüklemeler

Connect(EndPoint)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Ayrıca bkz.

Şunlara uygulanır

Connect(IPAddress, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Connect(IPAddress[], Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Connect(String, Int32)

Parametreler

Özel durumlar

Örnekler

Açıklamalar

Şunlara uygulanır

Ek kaynaklar