HostName Klasse

Referenz

Definition

Namespace:: Windows.Networking

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

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 : 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.

Gilt für: