HostName Classe

Definição

Namespace:

Windows.Networking

Fornece dados para um nome de host ou um endereço 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

Herança

Object Platform::Object IInspectable HostName

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementações

IStringable

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)
Funcionalidades do aplicativo	internetClient privateNetworkClientServer

Comentários

A classe HostName é usada para inicializar e fornecer dados para um nome de host usado em aplicativos de rede. Um objeto HostName pode ser usado para um nome de host local ou um nome de host remoto usado para estabelecer uma conexão de rede.

O objeto HostName é usado por muitas classes em outros namespaces relacionados para aplicativos de rede. Entre elas estão as seguintes:

• Muitas classes no namespace Windows.Networking.Sockets usando soquetes. Os métodos nas classes DatagramSocket e StreamSocket podem ser usados para estabelecer conexões de rede e transferir dados para um objeto HostName remoto.
• A classe NetworkInformation no namespace Windows.Networking.Connectivity . O exemplo a seguir cria um HostName e tenta se conectar ao HostName usando um 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");

Construtores

HostName(String)

Cria um novo objeto HostName de uma cadeia de caracteres que contém um nome de host ou um endereço IP.

Propriedades

CanonicalName	Obtém o nome canônico do objeto HostName .
DisplayName	Obtém o nome de exibição do objeto HostName .
IPInformation	Obtém o objeto IPInformation para um endereço IP local atribuído a um objeto HostName .
RawName	Obtém a cadeia de caracteres original usada para construir o objeto HostName .
Type	Obtém o HostNameType do objeto HostName .

Métodos

Compare(String, String)	Compara duas cadeias de caracteres para determinar se elas representam o mesmo nome do host.
IsEqual(HostName)	Determina se o objeto HostName especificado tem um valor equivalente ao objeto HostName atual.
ToString()	Retorna uma cadeia de caracteres que representa o objeto HostName .

Confira também

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