Windows.Networking Namespace
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece acesso a nomes de host e pontos de extremidade usados por aplicativos de rede.
Classes
| Nome | Description |
|---|---|
| EndpointPair |
Representa um emparelhamento de identificadores de host/serviço local e remoto (nome do host ou IP mais nome de serviço ou porta) usados para iniciar ou descrever uma conexão de rede. |
| HostName |
Representa um nome de host ou endereço IP (domínio, IPv4, IPv6 ou Bluetooth) usado por Windows APIs de rede. |
Enumerações
| Nome | Description |
|---|---|
| DomainNameType |
O tipo de domínio do objeto HostName quando o HostNameType é um nome de domínio. |
| HostNameSortOptions |
Opções de como uma lista de objetos EndpointPair é classificada. |
| HostNameType |
O tipo de um objeto HostName . |
Comentários
Observação
Compatibilidade da estrutura do aplicativo: O Windows. As APIs de rede estão disponíveis para aplicativos SDK do Aplicativo Windows (WinUI 3) e aplicativos da área de trabalho Win32, não apenas aplicativos UWP. Os aplicativos da área de trabalho podem usar objetos HostName e EndpointPair por meio de C#/WinRT ou C++/WinRT. Para aplicativos de área de trabalho empacotados, os recursos de rede são declarados no manifesto do aplicativo da mesma maneira que para aplicativos UWP. Os aplicativos de área de trabalho não empacotados têm acesso à rede irrestrito por padrão. Para obter detalhes, consulte ApIs de chamada Windows Runtime em aplicativos da área de trabalho.
O Windows. O namespace de rede fornece classes usadas para inicializar e fornecer dados para um nome de host ou endereço IP e para um par de pontos de extremidade de rede usados em aplicativos de rede. Os objetos HostName e EndpointPair são usados por muitas classes em outros namespaces relacionados. Elas incluem o seguinte:
- Classes no Windows. Namespace Networking.Sockets usado para aplicativos de rede usando soquetes e WebSockets.
- A classe NetworkInformation no Windows. Namespace Networking.Connectivity.
Em Windows Server 2012, o Windows.Networking.dll que implementa as classes no Windows. O namespace de rede falhará ao carregar, a menos que o recurso do Media Foundation esteja habilitado. Como resultado, os aplicativos que usam classes no Windows. O namespace de rede falhará se o recurso do Media Foundation estiver desabilitado (o padrão em Windows Server 2012).
O recurso do Media Foundation pode ser habilitado em Windows Server 2012 usando Gerenciador do Servidor ou inserindo o comando a seguir em uma janela CMD ou em um script.
dism /online /enable-feature /featurename:ServerMediaFoundation O usuário será solicitado a reinicializar depois que o recurso do Media Foundation estiver habilitado no Windows Server 2012. Depois que o computador é reinicializado, as classes no Windows. O namespace de rede funcionará conforme o esperado.
Usando o isolamento de rede
O recurso de isolamento de rede no Windows permite que um desenvolvedor controle totalmente o acesso à rede de um aplicativo empacotado (incluindo aplicativos de área de trabalho UWP e SDK do Aplicativo Windows empacotados (WinUI 3). Nem todos os aplicativos podem exigir acesso à rede. No entanto, para os aplicativos que fazem isso, Windows fornece diferentes níveis de acesso à rede que podem ser habilitados selecionando os recursos apropriados.
O isolamento de rede permite que um desenvolvedor defina para cada aplicativo o escopo do acesso à rede necessário. Um aplicativo sem o escopo apropriado definido é impedido de acessar o tipo de rede especificado e o tipo específico de solicitação de rede (solicitações iniciadas pelo cliente de saída ou solicitações não solicitadas de entrada e solicitações iniciadas pelo cliente de saída). A capacidade de definir e impor o isolamento de rede garante que, se um aplicativo for comprometido, ele só poderá acessar redes em que o aplicativo recebeu acesso explicitamente. Isso reduz significativamente o escopo do impacto em outros aplicativos e em Windows.
O isolamento de rede afeta quaisquer métodos e propriedades no Windows. Networking.Sockets, Windows. Networking.BackgroundTransfer, Windows. Web.AtomPub e Windows. Namespaces Web.Syndication que tentam acessar a rede. Windows impõe ativamente o isolamento de rede. Uma chamada para um método ou qualquer acesso a uma propriedade nesses namespaces que resulta em acesso à rede poderá falhar devido ao isolamento de rede se a funcionalidade de rede apropriada não tiver sido habilitada.
Os recursos de rede de um aplicativo são configurados no manifesto do aplicativo quando o aplicativo é criado. Os recursos de rede geralmente são adicionados usando Microsoft Visual Studio 2012 ao desenvolver o aplicativo. Os recursos de rede também podem ser definidos manualmente no arquivo de manifesto do aplicativo usando um editor de texto.
Para obter informações mais detalhadas sobre o isolamento de rede, consulte como configurar recursos de isolamento de rede.