Windows.Networking.Sockets 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 classes de soquetes e WebSockets a serem usadas para comunicações de rede e classes para notificações de rede em tempo real recebidas em segundo plano para aplicativos UWP.
Classes
| ControlChannelTrigger |
Permite que notificações em tempo real sejam recebidas em segundo plano para objetos que estabelecem uma conexão TCP e desejam ser notificados sobre o tráfego de entrada. Chame **BackgroundExecutionManager.RequestAccessAsync** antes de usar ControlChannelTrigger. Observação Não há suporte para essa classe em Windows Phone. |
| DatagramSocket |
Dá suporte à comunicação de rede usando um soquete de datagrama UDP. Para obter um exemplo de código, consulte Soquetes. |
| DatagramSocketControl |
Fornece dados de controle de soquete em um objeto DatagramSocket . |
| DatagramSocketInformation |
Fornece informações de soquete em um objeto DatagramSocket . |
| DatagramSocketMessageReceivedEventArgs |
Fornece dados para um evento MessageReceived em um DatagramSocket. |
| MessageWebSocket |
Dá suporte à comunicação de rede que permite ler e gravar mensagens inteiras usando um WebSocket. |
| MessageWebSocketControl |
Fornece dados de controle de soquete em um MessageWebSocket. |
| MessageWebSocketInformation |
Fornece informações de soquete em um MessageWebSocket. |
| MessageWebSocketMessageReceivedEventArgs |
Fornece dados para um evento recebido por mensagem em um MessageWebSocket. |
| ServerMessageWebSocket |
Dá suporte à comunicação de rede que permite ler e gravar mensagens inteiras usando um objeto WebSocket pertencente a um servidor Web. Você não pode se registrar para uma conexão WebSocket arbitrária; Em vez disso, uma instância de ServerMessageWebSocket é criada pelo código do sistema, como o WDP ( Portal de Dispositivos do Windows ). |
| ServerMessageWebSocketControl |
Fornece dados de controle de soquete em um ServerMessageWebSocket. |
| ServerMessageWebSocketInformation |
Fornece informações de soquete em um ServerMessageWebSocket. |
| ServerStreamWebSocket |
Dá suporte à comunicação de rede que permite a leitura e gravação de fluxos usando um objeto WebSocket pertencente a um servidor Web. Você não pode se registrar para uma conexão WebSocket arbitrária; Em vez disso, uma instância de ServerStreamWebSocket é criada pelo código do sistema, como o WDP ( Portal de Dispositivos do Windows ). |
| ServerStreamWebSocketInformation |
Fornece informações de soquete em um objeto ServerStreamWebSocket . |
| SocketActivityContext |
O contexto associado a um soquete durante a transferência da propriedade do soquete entre um aplicativo e o serviço de intermediação de soquete. |
| SocketActivityInformation |
Fornece informações sobre o soquete transferido do Socket Broker. |
| SocketActivityTriggerDetails |
Um objeto instanciado pela infraestrutura do agente em segundo plano e usado por um aplicativo para recuperar detalhes quando ocorre um SocketActivityTrigger . |
| SocketError |
Fornece status de erro de soquete para operações em um DatagramSocket, StreamSocket ou StreamSocketListener. |
| StreamSocket |
Dá suporte à comunicação de rede usando um soquete de fluxo por TCP ou Bluetooth RFCOMM em aplicativos UWP. |
| StreamSocketControl |
Fornece dados de controle de soquete em um objeto StreamSocket . |
| StreamSocketInformation |
Fornece informações de soquete em um objeto StreamSocket . |
| StreamSocketListener |
Dá suporte à escuta para uma conexão de rede de entrada usando um soquete de fluxo TCP ou Bluetooth RFCOMM. |
| StreamSocketListenerConnectionReceivedEventArgs |
Fornece dados para um evento ConnectionReceived em um objeto StreamSocketListener . |
| StreamSocketListenerControl |
Fornece dados de controle de soquete em um objeto StreamSocketListener . |
| StreamSocketListenerInformation |
Fornece informações de soquete em um objeto StreamSocketListener . |
| StreamWebSocket |
Dá suporte à comunicação de rede que permite a leitura e gravação de fluxos usando um WebSocket. |
| StreamWebSocketControl |
Fornece dados de controle de soquete em um objeto StreamWebSocket . |
| StreamWebSocketInformation |
Fornece informações de soquete em um objeto StreamWebSocket . |
| WebSocketClosedEventArgs |
Fornece dados para um evento fechado em um objeto MessageWebSocket, StreamWebSocket ou IWebSocket . |
| WebSocketError |
Fornece status de erro de soquete em um objeto MessageWebSocket ou StreamWebSocket. |
| WebSocketKeepAlive |
Fornece a capacidade de enviar um protocolo WebSocket keep alive em um WebSocket conectado. |
| WebSocketServerCustomValidationRequestedEventArgs |
Fornece dados para um evento ServerCustomValidationRequested em um WebSocket. Esse evento ocorre quando uma nova conexão segura com um WebSocket está sendo feita e dá ao seu código a oportunidade de executar a validação personalizada dos certificados do servidor antes que a conexão seja estabelecida. |
Estruturas
| BandwidthStatistics |
Representa informações de largura de banda para transferência de dados de rede usando um objeto StreamSocket, StreamWebSocket ou MessageWebSocket . |
| RoundTripTimeStatistics |
Representa informações de tempo de viagem de ida e volta para um objeto StreamSocket . |
Interfaces
| IControlChannelTriggerEventDetails |
Um objeto instanciado pela infraestrutura do agente de segundo plano que é usada para diferenciar gatilhos de canal de controle. Observação Não há suporte para essa interface no Windows Phone. |
| IControlChannelTriggerResetEventDetails |
Um objeto instanciado pela infraestrutura do agente em segundo plano para um evento ControlChannelReset para indicar que um ControlChannelTrigger foi redefinido. Observação Não há suporte para essa interface no Windows Phone. |
| IWebSocket |
Fornece acesso à comunicação de rede que permite ler e gravar usando um WebSocket. |
| IWebSocketControl |
Fornece dados de controle de soquete em um objeto IWebSocket . |
| IWebSocketControl2 |
Fornece dados de controle de soquete em um objeto IWebSocket . Essa interface estende a interface IWebSocketControl com uma propriedade adicional. |
| IWebSocketInformation |
Fornece informações de soquete em um objeto IWebSocket . |
| IWebSocketInformation2 |
Fornece informações de soquete em um objeto IWebSocket . Essa interface estende IWebSocketInformation com propriedades adicionais. |
Enumerações
| ControlChannelTriggerResetReason |
O motivo pelo qual um ControlChannelTrigger foi redefinido. Observação Não há suporte para essa enumeração em Windows Phone. |
| ControlChannelTriggerResourceType |
O tipo de recurso usado por um gatilho de canal de controle. Observação Não há suporte para essa enumeração em Windows Phone. |
| ControlChannelTriggerStatus |
Especifica se o sistema foi capaz de concluir a configuração de um objeto ControlChannelTrigger para uso por elementos de classe no Windows.Networking.Sockets e namespaces relacionados. Observação Não há suporte para essa enumeração em Windows Phone. |
| MessageWebSocketReceiveMode |
Descreve o tipo de mensagem que o cliente aceitará. |
| SocketActivityConnectedStandbyAction |
Indica se um aplicativo que usa o serviço de intermediação de soquete pode receber pacotes quando o sistema for para o stand by conectado. |
| SocketActivityKind |
Descreve o tipo de objeto de soquete que está sendo transferido de ou para o agente de soquete. |
| SocketActivityTriggerReason |
O motivo pelo qual ocorreu um SocketActivityTrigger . |
| SocketErrorStatus |
Especifica status valores para uma operação de soquete. |
| SocketMessageType |
Especifica o tipo de uma mensagem para um objeto MessageWebSocket . |
| SocketProtectionLevel |
Especifica o nível de criptografia a ser usado em um objeto StreamSocket . |
| SocketQualityOfService |
Especifica a qualidade do serviço para um objeto DatagramSocket ou StreamSocket . |
| SocketSslErrorSeverity |
A categoria de erro que ocorre em uma conexão SSL. |
Comentários
O namespace Windows.Networking.Sockets fornece classes e interfaces para rede que usam soquetes e WebSockets. Aqui estão as classes primárias.
- DatagramSocket. Um soquete de datagrama UDP a ser usado para comunicação de rede.
- StreamSocket. Um soquete de fluxo a ser usado para comunicação de rede de entrada ou saída por TCP ou por conexões Bluetooth que usam RFCOMM.
- StreamSocketListener. Um ouvinte de soquete de fluxo para escutar conexões de rede TCP de entrada ou conexões Bluetooth de entrada que usam RFCOMM.
- MessageWebSocket. Um WebSocket baseado em mensagem para ler e gravar mensagens inteiras para comunicação de rede. Consulte WebSockets.
- StreamWebSocket. Um WebSocket baseado em fluxo para ler e gravar fluxos para comunicações de rede. Consulte WebSockets.
Essas classes primárias também têm várias classes de controle e informações relacionadas no namespace Windows.Networking.Sockets.
Tratamento de exceções
Você deve escrever código para lidar com exceções ao chamar métodos assíncronos no namespace Windows.Networking.Sockets. Exceções podem resultar de erros de validação de parâmetro, falhas de resolução de nomes e erros de rede. Exceções de erros de rede (perda de conectividade, falhas de conexão e falhas de servidor, por exemplo) podem ocorrer a qualquer momento. Esses erros geram exceções. Se não for tratada pelo aplicativo, uma exceção poderá fazer com que todo o aplicativo seja encerrado pelo runtime.
O namespace Windows.Networking.Sockets tem métodos auxiliares e enumerações práticas para resolver erros durante o uso de soquetes e WebSockets. Eles são úteis para resolver exceções de rede específicas de uma outra forma em seu aplicativo. Um aplicativo também pode usar o HRESULT da exceção em erros de validação de parâmetro para saber mais informações sobre o erro que causou a exceção.
Para obter mais informações sobre possíveis exceções e como lidar com exceções, consulte Tratamento de exceções em aplicativos de rede.
Usando StreamSocket com proximidade, Wi-Fi Direct e Bluetooth
Seu aplicativo pode usar um StreamSocket para conexões de rede entre dispositivos que estão ao alcance próximo. As classes no namespace Windows.Networking.Proximity dão suporte a conexões de rede com um StreamSocket para dispositivos próximos que usam Bluetooth ou Wi-Fi Direct. O PeerFinder e as classes relacionadas no namespace Windows.Networking.Proximity permitem que seu aplicativo descubra outra instância do aplicativo em um dispositivo próximo. O método PeerFinder.FindAllPeersAsync procura computadores pares que executam o mesmo aplicativo dentro do intervalo sem fio. O método PeerFinder.ConnectAsync retorna um StreamSocket conectado que seu aplicativo pode usar para transferir dados de rede com o aplicativo par próximo. Para obter mais informações, consulte Suporte a proximidade e toques, Windows.Networking.Proximity, PeerFinder e o exemplo de proximidade.
Seu aplicativo também pode usar um StreamSocket para conexões de rede entre dispositivos que usam Wi-Fi Direct com classes no namespace Windows.Devices.WiFiDirect . A classe WiFiDirectDevice pode ser usada para localizar outros dispositivos que tenham um dispositivo compatível com Wi-Fi Direct (WFD). O método WiFiDirectDevice.GetDeviceSelector obtém o identificador do dispositivo para um dispositivo WFD próximo. Depois de fazer referência a um dispositivo WFD próximo, você pode chamar o método WiFiDirectDevice.GetConnectionEndpointPairs para obter um objeto EndpointPair . O método ConnectAsync(EndpointPair) ou ConnectAsync(EndpointPair, SocketProtectionLevel) na classe StreamSocket pode ser usado para estabelecer uma conexão de soquete. Para obter mais informações, consulte Windows.Devices.WiFiDirect e WiFiDirectDevice.
O Bluetooth usa IDs do Serviço Bluetooth como pontos de extremidade para conexões StreamSocket , não nomes de host ou endereços IP. Para usar um StreamSocket com Bluetooth, a funcionalidade do dispositivo bluetooth.rfcomm deve ser definida no manifesto do aplicativo. Para obter mais informações, consulte o namespace Windows.Devices.Bluetooth.Rfcomm , Como especificar recursos de dispositivo para Bluetooth e o exemplo de Bluetooth Rfcomm Chat.
Usando DatagramSocket com Wi-Fi Direct
Seu aplicativo pode usar um DatagramSocket para transferências de dados de rede entre dispositivos que usam Wi-Fi Direct usando classes no namespace Windows.Devices.WiFiDirect . A classe WiFiDirectDevice pode ser usada para localizar outros dispositivos que tenham um dispositivo compatível com Wi-Fi Direct (WFD). O método WiFiDirectDevice.GetDeviceSelector obtém o identificador do dispositivo para um dispositivo WFD próximo. Depois de fazer referência a um dispositivo WFD próximo, você pode chamar o método WiFiDirectDevice.GetConnectionEndpointPairs para obter um objeto EndpointPair . Métodos na classe DatagramSocket podem ser usados para enviar e receber dados para o objeto EndpointPair . Para obter mais informações, consulte Windows.Devices.WiFiDirect e WiFiDirectDevice.
Usando gatilhos de rede
O namespace Windows.Networking.Sockets oferece dois tipos de gatilhos que seu aplicativo pode usar para rede em segundo plano: ControlChannelTrigger e SocketActivityTrigger.
Gatilhos de canal de controle
O ControlChannelTrigger permite que seu aplicativo receba pacotes de dados de rede e keepalives de rede quando o aplicativo estiver em segundo plano. Isso permite que seu aplicativo forneça status em tempo real e notificações de rede para StreamSocket no namespace Windows.Networking.Sockets e outras classes de rede em namespaces relacionados.
Os gatilhos de rede são usados por aplicativos de rede de longa execução (por exemplo, um aplicativo de email) para minimizar o uso de recursos de rede e sistema. Os gatilhos de rede permitem que um aplicativo seja solto em um modo de baixa potência por períodos de tempo, mantendo as conexões de rede intactas, mas em um estado de baixa potência. Você pode definir um intervalo keepalive para informar o sistema quando o aplicativo deve ser ativado. Você também pode definir um gatilho para ser notificado quando um pacote é recebido para o aplicativo. Esses recursos de notificação podem ajudar a estender a duração da bateria ao usar aplicativos de rede de longa execução em dispositivos móveis.
Para obter mais informações, consulte a classe ControlChannelTrigger e Como definir opções de conectividade em segundo plano.
Gatilhos de atividade de soquete
O SocketActivityTrigger permite que seu aplicativo receba pacotes de dados de rede quando ele não estiver ativo (mesmo que esteja suspenso ou encerrado) e mesmo quando ele não estiver carregado na memória no momento. Ele é fornecido especialmente para aplicativos que fornecem serviços de rede, em que o aplicativo se registraria como um provedor de serviços por meio do DNS-SD e, em seguida, se tornaria inativo. Um SocketActivityTrigger notificaria o aplicativo quando um cliente se conectasse ao serviço, para que o serviço pudesse ativar e fornecer serviços solicitados. SocketActivityTrigger também pode ser usado em outras circunstâncias. Use-o sempre que quiser ser capaz de ativar seu aplicativo em resposta ao tráfego de rede recebido.
Se o aplicativo usar gatilhos de atividade de soquete, você deverá especificar a funcionalidade pushNotifications no manifesto do aplicativo.
Escolhendo um gatilho de rede
Existem alguns cenários onde qualquer tipo de gatilho seria adequado. Ao escolher o tipo de gatilho para usar em seu aplicativo, considere o seguinte aviso.
- Se estiver usando IXMLHTTPRequest2, System.Net.Http.HttpClient ou System.Net.Http.HttpClientHandler, você deverá usar ControlChannelTrigger.
- Se você estiver usando StreamSockets habilitado para push, prefira SocketActivityTrigger. Ele permite que o sistema libere a memória e reduza os requisitos de energia quando a conexão não está sendo usada ativamente.
- Se você quiser minimizar o volume de memória do aplicativo quando ele não estiver atendendo ativamente solicitações de rede, prefira SocketActivityTrigger.
- Se você deseja que seu aplicativo seja capaz de receber dados enquanto o sistema estiver no modo de espera conectado, use SocketActivityTrigger.
Usando soquetes e WebSockets no Windows Server 2012
No Windows Server 2012 e no Windows Server 2012 R2, o Windows.Networking.dll que implementa a maioria das classes no namespace Windows.Networking.Sockets não será carregado, a menos que o recurso do Media Foundation esteja habilitado. Como resultado, os aplicativos que usam soquetes ou classes WebSockets no namespace Windows.Networking.Sockets falharão se o recurso do Media Foundation estiver desabilitado. O Windows Server 2012 ou Windows Server 2012 R2 é instalado com o recurso do Media Foundation desabilitado.
O recurso do Media Foundation pode ser habilitado no Windows Server 2012 ou no Windows Server 2012 R2 usando Gerenciador do Servidor ou inserindo o seguinte texto em um prompt de comando ou em um script:
dism /online /enable-feature /featurename:ServerMediaFoundation Depois que o recurso do Media Foundation estiver habilitado, o usuário será solicitado a reiniciar. Depois que o computador for reiniciado, as classes para soquetes e WebSockets no namespace Windows.Networking.Sockets funcionarão conforme o esperado.
Usando soquetes e WebSockets com isolamento de rede
O isolamento de rede no Windows 8 permite controlar totalmente o perfil de segurança de um aplicativo UWP.
O isolamento de rede permite definir o acesso à rede necessário para cada aplicativo escolhendo os recursos apropriados. Um aplicativo sem o conjunto de recursos apropriado é impedido de usar tipos de rede específicos (Internet ou Rede Inicial/Trabalho) e solicitações de rede específicas (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 impor o isolamento de rede garante que, mesmo que um aplicativo seja comprometido, o aplicativo só pode usar recursos (tipos de rede e solicitações de rede, por exemplo) que o aplicativo foi concedido como funcionalidades. Isso reduz significativamente o possível impacto em outros aplicativos e no sistema operacional.
O Windows 8 impõe ativamente o isolamento de rede. Uma chamada para um método ou qualquer acesso a uma propriedade no namespace Windows.Networking.Sockets (ou namespaces relacionados que exigem acesso à rede) poderá falhar se a funcionalidade de rede apropriada não tiver sido habilitada.
Os recursos de rede para um aplicativo são configurados no manifesto do aplicativo quando o aplicativo é compilado. Os recursos de rede geralmente são adicionados usando o Visual Studio quando você desenvolve seu aplicativo. Eles 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.
Confira também
- PeerFinder
- WiFiDirectDevice
- Windows.Devices.Bluetooth.Rfcomm
- Windows.Devices.WiFiDirect
- Windows.Networking
- Windows.Networking.Connectivity
- Windows.Networking.Proximity
- Adicionando suporte para rede
- Conectando-se com soquetes
- WebSockets
- Tratamento de exceções em aplicativos de rede
- Como configurar recursos de isolamento de rede
- Como definir opções de conectividade em segundo plano
- Como especificar funcionalidades do dispositivo para Bluetooth
- Suporte à proximidade e toque
- Solução de problemas e depuração de conexões de rede
- SetSocketMediaStreamingMode
- Exemplo de Bluetooth Rfcomm Chat
- Exemplo de DatagramSocket
- Exemplo de ControlChannelTrigger StreamWebSocket
- Exemplo de soquete TCP controlChannelTrigger
- Exemplo de proximidade
- Exemplo do StreamSocket
- Exemplo de DatagramSocket
- Amostra de WebSocket
- Exemplo do StreamSocket
- exemplo de Wi-Fi Direct
- exemplo de serviços de Wi-Fi Direct (Windows 10)
- Exemplo de soquete de fluxo do gatilho de atividade de soquete de soquete de atividade de soquete