HostName Classe

Definizione

Spazio dei nomi:

Windows.Networking

Fornisce i dati per un nome host o un indirizzo 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

Ereditarietà

Object Platform::Object IInspectable HostName

Attributi

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni

IStringable

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	internetClient privateNetworkClientServer

Commenti

La classe HostName viene usata per inizializzare e fornire dati per un nome host usato nelle app di rete. Un oggetto HostName può essere usato per un nome host locale o un nome host remoto usato per stabilire una connessione di rete.

L'oggetto HostName viene usato da molte classi in altri spazi dei nomi correlati per le app di rete. tra cui:

• Molte classi nello spazio dei nomi Windows.Networking.Sockets usando socket. I metodi nelle classi DatagramSocket e StreamSocket possono essere usati per stabilire connessioni di rete e trasferire dati a un oggetto HostName remoto.
• Classe NetworkInformation nello spazio dei nomi Windows.Networking.Connectivity . Nell'esempio seguente viene creato un hostName e quindi si tenta di connettersi a HostName usando 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");

Costruttori

HostName(String)

Crea un nuovo oggetto HostName da una stringa contenente un nome host o un indirizzo IP.

Proprietà

CanonicalName	Ottiene il nome canonico per l'oggetto HostName .
DisplayName	Ottiene il nome visualizzato per l'oggetto HostName .
IPInformation	Ottiene l'oggetto IPInformation per un indirizzo IP locale assegnato a un oggetto HostName .
RawName	Ottiene la stringa originale usata per costruire l'oggetto HostName .
Type	Ottiene hostNameType dell'oggetto HostName .

Metodi

Compare(String, String)	Confronta due stringhe per determinare se rappresentano lo stesso nome host.
IsEqual(HostName)	Determina se l'oggetto HostName specificato ha un valore equivalente all'oggetto HostName corrente.
ToString()	Restituisce una stringa che rappresenta l'oggetto HostName .

Vedi anche

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