TcpClient 생성자
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
TcpClient 클래스의 새 인스턴스를 초기화합니다.
오버로드
| Name | Description |
|---|---|
| TcpClient() |
TcpClient 클래스의 새 인스턴스를 초기화합니다. |
| TcpClient(IPEndPoint) |
클래스의 새 인스턴스를 TcpClient 초기화하고 지정된 로컬 엔드포인트에 바인딩합니다. |
| TcpClient(AddressFamily) |
지정된 패밀리를 사용하여 클래스의 TcpClient 새 인스턴스를 초기화합니다. |
| TcpClient(String, Int32) |
클래스의 새 인스턴스를 TcpClient 초기화하고 지정된 호스트의 지정된 포트에 연결합니다. |
TcpClient()
TcpClient 클래스의 새 인스턴스를 초기화합니다.
public:
TcpClient();
public TcpClient();
Public Sub New ()
예제
다음 코드 예제에서는 매개 변수가 없는 생성자를 사용하여 새 TcpClient생성자를 만드는 방법을 보여 줍니다.
//Creates a TCPClient using the default constructor.
TcpClient tcpClientC = new TcpClient ();
'Creates a TCPClient using the default constructor.
Dim tcpClientC As New TcpClient
설명
이 생성자는 새 TcpClient 생성자를 만들고 기본 서비스 공급자가 가장 적절한 로컬 IP 주소 및 포트 번호를 할당할 수 있도록 합니다. 데이터를 보내고 받기 전에 먼저 메서드를 호출 Connect 해야 합니다.
메모
.NET Framework에서 이 생성자는 IPv4 주소 형식에서만 작동합니다.
메모
이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.
추가 정보
적용 대상
TcpClient(IPEndPoint)
클래스의 새 인스턴스를 TcpClient 초기화하고 지정된 로컬 엔드포인트에 바인딩합니다.
public:
TcpClient(System::Net::IPEndPoint ^ localEP);
public TcpClient(System.Net.IPEndPoint localEP);
new System.Net.Sockets.TcpClient : System.Net.IPEndPoint -> System.Net.Sockets.TcpClient
Public Sub New (localEP As IPEndPoint)
매개 변수
- localEP
- IPEndPoint
IPEndPoint TCPSocket를 바인딩하는 항목입니다.
예외
매개 변수는 localEP .입니다 null.
예제
다음 코드 예제에서는 로컬 엔드포인트를 사용하여 클래스의 TcpClient 인스턴스를 만드는 방법을 보여 줍니다.
//Creates a TCPClient using a local end point.
IPAddress ipAddress = Dns.GetHostEntry (Dns.GetHostName ()).AddressList[0];
IPEndPoint ipLocalEndPoint = new IPEndPoint(ipAddress, 0);
TcpClient tcpClientA = new TcpClient (ipLocalEndPoint);
'Creates a TCPClient using a local endpoint.
Dim ipAddress As IPAddress = Dns.GetHostEntry(Dns.GetHostName()).AddressList(0)
Dim ipLocalEndPoint As New IPEndPoint(ipAddress, 0)
Dim tcpClientA As New TcpClient(ipLocalEndPoint)
설명
이 생성자는 새 TcpClient 생성자를 만들고 매개 변수로 IPEndPoint 지정된 값에 localEP 바인딩합니다. 이 생성자를 호출하기 전에 데이터를 보내고 받으려는 IP 주소와 포트 번호를 사용하여 만들어야 IPEndPoint 합니다. 연결하고 통신하기 전에 로컬 IP 주소 및 포트 번호를 지정할 필요가 없습니다. 다른 생성자를 사용하여 만드는 TcpClient 경우 기본 서비스 공급자는 가장 적절한 로컬 IP 주소 및 포트 번호를 할당합니다.
데이터를 보내고 받기 전에 메서드를 호출 Connect 해야 합니다.
메모
이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.
추가 정보
적용 대상
TcpClient(AddressFamily)
지정된 패밀리를 사용하여 클래스의 TcpClient 새 인스턴스를 초기화합니다.
public:
TcpClient(System::Net::Sockets::AddressFamily family);
public TcpClient(System.Net.Sockets.AddressFamily family);
new System.Net.Sockets.TcpClient : System.Net.Sockets.AddressFamily -> System.Net.Sockets.TcpClient
Public Sub New (family As AddressFamily)
매개 변수
- family
- AddressFamily
AddressFamily IP 프로토콜의
예외
family 매개 변수가 AddressFamily.InterNetwork와 같지 않습니다.
-또는-
family 매개 변수가 AddressFamily.InterNetworkV6과 같지 않습니다.
예제
다음 코드 예제에서는 클래스의 인스턴스를 만드는 방법을 보여 줍니다 TcpClient .
TcpClient tcpClientD = new TcpClient (AddressFamily.InterNetwork);
Dim tcpClientD As New TcpClient(AddressFamily.InterNetwork)
설명
메모
이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.
적용 대상
TcpClient(String, Int32)
클래스의 새 인스턴스를 TcpClient 초기화하고 지정된 호스트의 지정된 포트에 연결합니다.
public:
TcpClient(System::String ^ hostname, int port);
public TcpClient(string hostname, int port);
new System.Net.Sockets.TcpClient : string * int -> System.Net.Sockets.TcpClient
Public Sub New (hostname As String, port As Integer)
매개 변수
- hostname
- String
연결하려는 원격 호스트의 DNS 이름입니다.
- port
- Int32
연결하려는 원격 호스트의 포트 번호입니다.
예외
매개 변수는 hostname .입니다 null.
소켓에 액세스할 때 오류가 발생했습니다.
예제
다음 코드 예제에서는 호스트 이름 및 포트 번호를 사용 하 여 클래스의 TcpClient 인스턴스를 만드는 방법을 보여 줍니다.
//Creates a TCPClient using host name and port.
TcpClient tcpClientB = new TcpClient ("www.contoso.com", 11000);
'Creates a TCPClient using hostname and port.
Dim tcpClientB As New TcpClient("www.contoso.com", 11000)
설명
이 생성자는 새 TcpClient 생성자를 만들고 제공된 호스트 이름 및 포트 번호에 대한 동기 연결을 시도합니다. 기본 서비스 공급자는 가장 적절한 로컬 IP 주소 및 포트 번호를 할당합니다.
TcpClient 는 연결되거나 실패할 때까지 차단됩니다. 이 생성자를 사용하면 DNS 호스트 이름을 초기화하고 확인하며 편리한 한 단계로 연결할 수 있습니다.
IPv6을 사용하도록 설정하고 IPv6 및 TcpClient(String, Int32) IPv4 주소 둘 다로 확인되는 호스트에 연결하기 위해 메서드를 호출하는 경우 IPv4 주소 전에 먼저 IPv6 주소에 대한 연결이 시도됩니다. 호스트가 IPv6 주소에서 수신 대기하지 않는 경우 연결 설정 시간이 지연되는 효과가 있을 수 있습니다.
메모
수신되는 SocketException경우 특정 오류 코드를 가져오는 데 사용합니다 SocketException.ErrorCode . 이 코드를 가져온 후에는 Windows 소켓 버전 2 API 오류 코드 설명서에서 오류에 대한 자세한 설명을 참조할 수 있습니다.
메모
이 멤버는 애플리케이션에서 네트워크 추적을 사용하도록 설정할 때 추적 정보를 출력합니다. 자세한 내용은 .NET Framework의Network 추적 참조하세요.