HostName Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece dados para um nome de host ou um endereço 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- Herança
- Atributos
- Implementações
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 . |