다음을 통해 공유


TcpClient.BeginConnect 메서드

정의

원격 호스트 연결에 대한 비동기 요청을 시작합니다.

오버로드

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 IPAddress와 포트 번호(Int32)로 지정됩니다.

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

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 IPAddress 배열과 포트 번호(Int32)로 지정됩니다.

BeginConnect(String, Int32, AsyncCallback, Object)

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 호스트 이름(String)과 포트 번호(Int32)로 지정됩니다.

BeginConnect(IPAddress, Int32, AsyncCallback, Object)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 IPAddress와 포트 번호(Int32)로 지정됩니다.

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

매개 변수

address
IPAddress

원격 호스트의 IPAddress입니다.

port
Int32

원격 호스트의 포트 번호입니다.

requestCallback
AsyncCallback

작업이 완료되었을 때 호출할 메서드를 참조하는 AsyncCallback 대리자입니다.

state
Object

연결 작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 이 개체는 작업이 완료되면 requestCallback 대리자에게 전달됩니다.

반환

비동기 연결을 참조하는 IAsyncResult 개체입니다.

예외

address 매개 변수가 null인 경우

소켓에 액세스하는 동안 오류가 발생했습니다.

Socket이 닫혔습니다.

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우

포트 번호가 잘못된 경우

설명

메서드를 호출 EndConnect 하여 비동 BeginConnect 기 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료될 때까지 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 Connect 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

참고

IPv6 주소를 사용하는 동안 메시지 This protocol version is not supported 와 함께 NotSupportedException을 수신하는 경우 를 전달 InterNetworkV6하여 생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

적용 대상

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

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 IPAddress 배열과 포트 번호(Int32)로 지정됩니다.

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

매개 변수

addresses
IPAddress[]

원격 호스트를 지정하는 하나 이상의 IPAddress입니다.

port
Int32

원격 호스트의 포트 번호입니다.

requestCallback
AsyncCallback

작업이 완료되었을 때 호출할 메서드를 참조하는 AsyncCallback 대리자입니다.

state
Object

연결 작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 이 개체는 작업이 완료되면 requestCallback 대리자에게 전달됩니다.

반환

비동기 연결을 참조하는 IAsyncResult 개체입니다.

예외

addresses 매개 변수가 null인 경우

소켓에 액세스하는 동안 오류가 발생했습니다.

Socket이 닫혔습니다.

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우

포트 번호가 잘못된 경우

설명

메서드를 호출 EndConnect 하여 비동 BeginConnect 기 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료될 때까지 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 Connect 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

이 메서드는 일반적으로 단일 호스트에 대해 여러 IP 주소를 반환할 BeginGetHostAddresses 수 있는 메서드를 호출한 직후에 사용됩니다.

참고

IPv6 주소를 사용하는 동안 메시지 This protocol version is not supported 와 함께 NotSupportedException을 수신하는 경우 를 전달 InterNetworkV6하여 생성자에서 IPv6을 사용하도록 설정했는지 확인합니다.

적용 대상

BeginConnect(String, Int32, AsyncCallback, Object)

Source:
TCPClient.cs
Source:
TCPClient.cs
Source:
TCPClient.cs

원격 호스트 연결에 대한 비동기 요청을 시작합니다. 원격 호스트는 호스트 이름(String)과 포트 번호(Int32)로 지정됩니다.

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

매개 변수

host
String

원격 호스트의 이름입니다.

port
Int32

원격 호스트의 포트 번호입니다.

requestCallback
AsyncCallback

작업이 완료되었을 때 호출할 메서드를 참조하는 AsyncCallback 대리자입니다.

state
Object

연결 작업에 대한 정보가 들어 있는 사용자 정의 개체입니다. 이 개체는 작업이 완료되면 requestCallback 대리자에게 전달됩니다.

반환

비동기 연결을 참조하는 IAsyncResult 개체입니다.

예외

host 매개 변수가 null인 경우

소켓에 액세스하는 동안 오류가 발생했습니다.

Socket이 닫혔습니다.

호출 스택의 상위 호출자에게 요청된 작업을 수행할 권한이 없는 경우

포트 번호가 잘못된 경우

설명

메서드를 호출 EndConnect 하여 비동 BeginConnect 기 작업을 완료해야 합니다. 일반적으로 메서드는 대리자에서 호출됩니다 asyncCallback .

이 메서드는 작업이 완료될 때까지 차단되지 않습니다. 작업이 완료될 때까지 차단하려면 메서드 오버로드 중 Connect 하나를 사용합니다.

비동기 프로그래밍 모델 사용에 대한 자세한 내용은 동기 메서드 비동기 호출을 참조하세요.

적용 대상