HostName 클래스

정의

네임스페이스:

Windows.Networking

호스트 이름 또는 IP 주소에 대한 데이터를 제공합니다.

public ref class HostName sealed : IStringable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.IHostNameFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class HostName final : IStringable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.Networking.IHostNameFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HostName : IStringable

function HostName(hostName)

Public NotInheritable Class HostName
Implements IStringable

상속

Object Platform::Object IInspectable HostName

특성

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IStringable

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
앱 기능	internetClient privateNetworkClientServer

설명

HostName 클래스는 네트워크 앱에서 사용되는 호스트 이름에 대한 데이터를 초기화하고 제공하는 데 사용됩니다. HostName 개체는 네트워크 연결을 설정하는 데 사용되는 로컬 호스트 이름 또는 원격 호스트 이름에 사용할 수 있습니다.

HostName 개체는 네트워크 앱에 대한 다른 관련 네임스페이스의 많은 클래스에서 사용됩니다. 여기에는 다음과 같은 옵션이 포함됩니다.

• 소켓을 사용하는 Windows.Networking.Sockets 네임스페이스의 많은 클래스입니다. DatagramSocket 및 StreamSocket 클래스의 메서드를 사용하여 네트워크 연결을 설정하고 원격 HostName 개체로 데이터를 전송할 수 있습니다.
• Windows.Networking.Connectivity 네임스페이스의 NetworkInformation 클래스입니다. 다음 예제에서는 HostName을 만든 다음 StreamSocket을 사용하여 HostName에 연결을 시도합니다.

using Windows.Networking;
using Windows.Networking.Sockets;

HostName serverHost = new HostName("www.contoso.com");
StreamSocket clientSocket = new Windows.Networking.Sockets.StreamSocket();

// Try to connect to the remote host
await clientSocket.ConnectAsync(serverHost, "http");

#include <winrt/Windows.Networking.Sockets.h>
using namespace winrt;

int main()
{
    winrt::init_apartment();

    Windows::Networking::HostName hostName{ L"www.contoso.com" };
    Windows::Networking::Sockets::StreamSocket streamSocket;
    // Try to connect.
    streamSocket.ConnectAsync(hostName, L"http").get();
}

using namespace Windows::Networking;
using namespace Windows::Networking::Sockets;

HostName^ serverHost= ref new HostName("www.contoso.com");
StreamSocket^ clientSocket = ref new StreamSocket();

// Try to connect to the remote host
clientSocket->ConnectAsync(serverHost, "http");

생성자

HostName(String)

호스트 이름 또는 IP 주소를 포함하는 문자열에서 새 HostName 개체를 만듭니다.

속성

CanonicalName	HostName 개체의 정식 이름을 가져옵니다.
DisplayName	HostName 개체의 표시 이름을 가져옵니다.
IPInformation	HostName 개체에 할당된 로컬 IP 주소에 대한 IPInformation 개체를 가져옵니다.
RawName	HostName 개체를 생성하는 데 사용되는 원래 문자열을 가져옵니다.
Type	HostName 개체의 HostNameType을 가져옵니다.

메서드

Compare(String, String)	두 문자열을 비교하여 동일한 호스트 이름을 나타내는지 확인합니다.
IsEqual(HostName)	지정된 HostName 개체에 현재 HostName 개체와 동일한 값이 있는지 여부를 확인합니다.
ToString()	HostName 개체를 나타내는 문자열을 반환합니다.

추가 정보

• DatagramSocket
• EndpointPair
• IStringable
• NetworkInformation
• StreamSocket
• Windows.Networking
• Windows.Networking.Sockets