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.
• Класс NetworkInformation в пространстве имен Windows.Networking.Connectivity . В следующем примере создается имя узла, а затем пытается подключиться к hostName с помощью StreamSocket.

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)

Создает новый объект HostName из строки, содержащей имя узла или IP-адрес.

Свойства

CanonicalName	Возвращает каноническое имя объекта HostName .
DisplayName	Возвращает отображаемое имя для объекта HostName .
IPInformation	Возвращает объект IPInformation для локального IP-адреса, назначенного объекту HostName .
RawName	Возвращает исходную строку, используемую для создания объекта HostName .
Type	Возвращает тип hostNameType объекта HostName .

Методы

Compare(String, String)	Сравнивает две строки, чтобы определить, представляют ли они одно и то же имя узла.
IsEqual(HostName)	Определяет, имеет ли указанный объект HostName значение, эквивалентное текущему объекту HostName .
ToString()	Возвращает строку, представляющую объект HostName .

См. также раздел

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