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