HostName Classe

Définition

Espace de noms:

Windows.Networking

Fournit des données pour un nom d’hôte ou une adresse 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

Héritage

Object Platform::Object IInspectable HostName

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IStringable

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)
Fonctionnalités de l’application	internetClient privateNetworkClientServer

Remarques

La classe HostName est utilisée pour initialiser et fournir des données pour un nom d’hôte utilisé dans les applications réseau. Un objet HostName peut être utilisé pour un nom d’hôte local ou un nom d’hôte distant utilisé pour établir une connexion réseau.

L’objet HostName est utilisé par de nombreuses classes dans d’autres espaces de noms associés pour les applications réseau. Ces options en question sont les suivantes :

• De nombreuses classes dans l’espace de noms Windows.Networking.Sockets utilisant des sockets. Les méthodes des classes DatagramSocket et StreamSocket peuvent être utilisées pour établir des connexions réseau et transférer des données vers un objet HostName distant.
• Classe NetworkInformation dans l’espace de noms Windows.Networking.Connectivity . L’exemple suivant crée un hostName, puis tente de se connecter à HostName à l’aide d’un 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");

Constructeurs

HostName(String)

Crée un objet HostName à partir d’une chaîne qui contient un nom d’hôte ou une adresse IP.

Propriétés

CanonicalName	Obtient le nom canonique de l’objet HostName .
DisplayName	Obtient le nom complet de l’objet HostName .
IPInformation	Obtient l’objet IPInformation pour une adresse IP locale affectée à un objet HostName .
RawName	Obtient la chaîne d’origine utilisée pour construire l’objet HostName .
Type	Obtient le HostNameType de l’objet HostName .

Méthodes

Compare(String, String)	Compare deux chaînes pour déterminer si elles représentent le même nom d’hôte.
IsEqual(HostName)	Détermine si l’objet HostName spécifié a une valeur équivalente à l’objet HostName actuel.
ToString()	Renvoie une chaîne qui représente l’objet HostName .

Voir aussi

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