HostName Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет данные для имени узла или IP-адреса.
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
- Наследование
- Атрибуты
- Реализации
Требования к Windows
Семейство устройств |
Windows 10 (появилось в 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (появилось в v1.0)
|
Возможности приложения |
internetClient
privateNetworkClientServer
|
Комментарии
Класс HostName используется для инициализации и предоставления данных для имени узла, используемого в сетевых приложениях. Объект HostName можно использовать для локального имени узла или удаленного имени узла, используемого для установления сетевого подключения.
Объект HostName используется многими классами в других связанных пространствах имен для сетевых приложений. следующие основные параметры.
- Многие классы в пространстве имен Windows.Networking.Sockets используют сокеты. Методы классов DatagramSocket и StreamSocket можно использовать для установки сетевых подключений и передачи данных в удаленный объект HostName.
- Класс NetworkInformation в пространстве имен Windows.Networking.Connectivity . В следующем примере создается имя узла, а затем пытается подключиться к hostName с помощью 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");
Конструкторы
HostName(String) |
Создает новый объект HostName из строки, содержащей имя узла или IP-адрес. |
Свойства
CanonicalName |
Возвращает каноническое имя объекта HostName . |
DisplayName |
Возвращает отображаемое имя для объекта HostName . |
IPInformation |
Возвращает объект IPInformation для локального IP-адреса, назначенного объекту HostName . |
RawName |
Возвращает исходную строку, используемую для создания объекта HostName . |
Type |
Возвращает тип hostNameType объекта HostName . |
Методы
Compare(String, String) |
Сравнивает две строки, чтобы определить, представляют ли они одно и то же имя узла. |
IsEqual(HostName) |
Определяет, имеет ли указанный объект HostName значение, эквивалентное текущему объекту HostName . |
ToString() |
Возвращает строку, представляющую объект HostName . |