HostName Klasse

Definition

Namespace:

Windows.Networking

Stellt Daten für einen Hostnamen oder eine IP-Adresse bereit.

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

Vererbung

Object Platform::Object IInspectable HostName

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IStringable

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	internetClient privateNetworkClientServer

Hinweise

Die HostName-Klasse wird zum Initialisieren und Bereitstellen von Daten für einen Hostnamen verwendet, der in Netzwerk-Apps verwendet wird. Ein HostName-Objekt kann für einen lokalen Hostnamen oder einen Remotehostnamen verwendet werden, der zum Herstellen einer Netzwerkverbindung verwendet wird.

Das HostName-Objekt wird von vielen Klassen in anderen verwandten Namespaces für Netzwerk-Apps verwendet. Dabei handelt es sich z. B. um:

• Viele Klassen im Windows.Networking.Sockets-Namespace verwenden Sockets. Methoden für die DatagramSocket - und StreamSocket-Klassen können verwendet werden, um Netzwerkverbindungen herzustellen und Daten an ein RemotehostName-Objekt zu übertragen.
• Die NetworkInformation-Klasse im Windows.Networking.Connectivity-Namespace . Im folgenden Beispiel wird ein HostName erstellt und dann versucht, mithilfe eines StreamSocket eine Verbindung mit HostName herzustellen.

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");

Konstruktoren

HostName(String)

Erstellt ein neues HostName-Objekt aus einer Zeichenfolge, die einen Hostnamen oder eine IP-Adresse enthält.

Eigenschaften

CanonicalName	Ruft den kanonischen Namen für das HostName-Objekt ab.
DisplayName	Ruft den Anzeigenamen für das HostName-Objekt ab.
IPInformation	Ruft das IPInformation-Objekt für eine lokale IP-Adresse ab, die einem HostName-Objekt zugewiesen ist.
RawName	Ruft die ursprüngliche Zeichenfolge ab, die zum Erstellen des HostName-Objekts verwendet wird.
Type	Ruft den HostNameType des HostName-Objekts ab.

Methoden

Compare(String, String)	Vergleicht zwei Zeichenfolgen, um zu ermitteln, ob sie denselben Hostnamen darstellen.
IsEqual(HostName)	Bestimmt, ob das angegebene HostName-Objekt über einen gleichwertigen Wert zum aktuellen HostName-Objekt verfügt.
ToString()	Gibt eine Zeichenfolge zurück, die das HostName-Objekt darstellt.

Weitere Informationen

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