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)	2 つの文字列を比較して、同じホスト名を表しているかどうかを判断します。
IsEqual(HostName)	指定した HostName オブジェクトに、現在の HostName オブジェクトと同等の値があるかどうかを判断します。
ToString()	HostName オブジェクトを表す文字列を返します。

こちらもご覧ください

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