HostName Clase

Definición

Espacio de nombres:

Windows.Networking

Proporciona datos para un nombre de host o una dirección 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

Herencia

Object Platform::Object IInspectable HostName

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementaciones

IStringable

Requisitos de Windows

Familia de dispositivos	Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)
Características de aplicaciones	internetClient privateNetworkClientServer

Comentarios

La clase HostName se usa para inicializar y proporcionar datos para un nombre de host que se usa en las aplicaciones de red. Un objeto HostName se puede usar para un nombre de host local o un nombre de host remoto que se usa para establecer una conexión de red.

Muchas clases de otros espacios de nombres relacionados usan el objeto HostName para las aplicaciones de red. Entre ellas, figuran:

• Muchas clases del espacio de nombres Windows.Networking.Sockets usan sockets. Los métodos de las clases DatagramSocket y StreamSocket se pueden usar para establecer conexiones de red y transferir datos a un objeto HostName remoto.
• La clase NetworkInformation del espacio de nombres Windows.Networking.Connectivity . En el ejemplo siguiente se crea un hostName y, a continuación, se intenta conectarse al hostName mediante 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");

Constructores

HostName(String)

Crea un nuevo objeto HostName a partir de una cadena que contiene un nombre de host o una dirección IP.

Propiedades

CanonicalName	Obtiene el nombre canónico del objeto HostName .
DisplayName	Obtiene el nombre para mostrar del objeto HostName .
IPInformation	Obtiene el objeto IPInformation de una dirección IP local asignada a un objeto HostName .
RawName	Obtiene la cadena original utilizada para construir el objeto HostName .
Type	Obtiene el hostNameType del objeto HostName .

Métodos

Compare(String, String)	Compara dos cadenas para determinar si representan el mismo nombre de host.
IsEqual(HostName)	Determina si el objeto HostName especificado tiene un valor equivalente al objeto HostName actual.
ToString()	Devuelve una cadena que representa el objeto HostName .

Consulte también

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