Freigeben über


HostName Klasse

Definition

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
Implementiert

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:

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:

Weitere Informationen