Dns.GetHostAddressesAsync 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.NameResolution.dll

오버로드

GetHostAddressesAsync(String, AddressFamily, CancellationToken)	지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.
GetHostAddressesAsync(String, CancellationToken)	지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.
GetHostAddressesAsync(String)	지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.

GetHostAddressesAsync(String, AddressFamily, CancellationToken)

Source:

Dns.cs

지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Net.Sockets.AddressFamily family, System.Threading.CancellationToken cancellationToken = default);

static member GetHostAddressesAsync : string * System.Net.Sockets.AddressFamily * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, family As AddressFamily, Optional cancellationToken As CancellationToken = Nothing) As Task(Of IPAddress())

매개 변수

hostNameOrAddress

String

확인할 호스트 이름 또는 IP 주소입니다.

family

AddressFamily

IP를 검색해야 하는 주소 패밀리입니다. 이면 Unspecified주소 패밀리에 관계없이 모든 IP를 검색합니다.

cancellationToken

CancellationToken

비동기 작업에 신호를 보내는 데 사용될 수 있는 취소 토큰은 취소되어야 합니다.

반환

Task<IPAddress[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열을 반환합니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw GetHostAddresses(String, AddressFamily)된 예외를 참조하세요.

GetHostAddressesAsync(String, CancellationToken)

Source:

Dns.cs

지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress, System::Threading::CancellationToken cancellationToken);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress, System.Threading.CancellationToken cancellationToken);

static member GetHostAddressesAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String, cancellationToken As CancellationToken) As Task(Of IPAddress())

매개 변수

hostNameOrAddress

String

확인할 호스트 이름 또는 IP 주소입니다.

cancellationToken

CancellationToken

비동기 작업에 신호를 보내는 데 사용될 수 있는 취소 토큰은 취소되어야 합니다.

반환

Task<IPAddress[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열을 반환합니다.

예외

OperationCanceledException

취소 토큰이 취소되었습니다. 이 예외는 반환된 작업에 저장됩니다.

설명

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw GetHostAddresses(String)된 예외를 참조하세요.

GetHostAddressesAsync(String)

Source:

Dns.cs

지정된 호스트의 IP(인터넷 프로토콜) 주소를 비동기 작업으로 반환합니다.

public:
 static System::Threading::Tasks::Task<cli::array <System::Net::IPAddress ^> ^> ^ GetHostAddressesAsync(System::String ^ hostNameOrAddress);

public static System.Threading.Tasks.Task<System.Net.IPAddress[]> GetHostAddressesAsync (string hostNameOrAddress);

static member GetHostAddressesAsync : string -> System.Threading.Tasks.Task<System.Net.IPAddress[]>

Public Shared Function GetHostAddressesAsync (hostNameOrAddress As String) As Task(Of IPAddress())

매개 변수

hostNameOrAddress

String

확인할 호스트 이름 또는 IP 주소입니다.

반환

Task<IPAddress[]>

비동기 작업(operation)을 나타내는 작업(task) 개체입니다. 작업 개체의 Result 속성은 hostNameOrAddress 매개 변수로 지정된 호스트의 IP 주소가 포함된 IPAddress 형식의 배열을 반환합니다.

예외

ArgumentNullException

hostNameOrAddress이(가) null인 경우

ArgumentOutOfRangeException

hostNameOrAddress의 길이가 255자를 넘습니다.

SocketException

hostNameOrAddress을 확인할 때 오류가 발생한 경우

ArgumentException

hostNameOrAddress가 잘못된 IP 주소인 경우

설명

이 작업은 차단되지 않습니다. 반환 Task<TResult> 된 개체는 가 hostNameOrAddress 확인된 후 완료됩니다.

이 메서드는 DNS 서버에서 호스트 이름과 연결된 IP 주소를 쿼리합니다. 가 IP 주소인 경우 hostNameOrAddress 이 주소는 DNS 서버를 쿼리하지 않고 반환됩니다.

이 메서드는 메서드의 동기 대응에서 throw할 수 있는 모든 비사용 예외를 반환하는 작업에 저장됩니다. 예외가 반환된 작업에 저장되면 작업이 대기될 때 해당 예외가 throw됩니다. 와 같은 ArgumentException사용 예외는 여전히 동기적으로 throw됩니다. 저장된 예외는 에서 throw GetHostAddresses(String)된 예외를 참조하세요.