HostName Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para un nombre de host o una dirección IP.
public ref class HostName sealed : IStringable/// [Windows.Foundation.Metadata.Activatable(Windows.Networking.IHostNameFactory, 65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HostName final : 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.Activatable(typeof(Windows.Networking.IHostNameFactory), 65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HostName : 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 : IStringablefunction HostName(hostName)Public NotInheritable Class HostName
Implements IStringable- Herencia
- Atributos
- Implementaciones
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 . |