DatagramSocketMessageReceivedEventArgs Classe
Definição
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 dados para um evento MessageReceived em um DatagramSocket.
public ref class DatagramSocketMessageReceivedEventArgs sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.GCPressure]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class DatagramSocketMessageReceivedEventArgs final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.GCPressure]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class DatagramSocketMessageReceivedEventArgsPublic NotInheritable Class DatagramSocketMessageReceivedEventArgs- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
| Funcionalidades do aplicativo |
ID_CAP_NETWORKING [Windows Phone]
|
Comentários
O DatagramSocketMessageReceivedEventArgs é usado para receber dados em um objeto DatagramSocket .
O método DatagramSocket.BindServiceNameAsync ou DatagramSocket.BindEndpointAsync é usado para associar um DatagramSocket a um nome de serviço local ou porta UDP se uma instância datagramSocket quiser escutar e receber dados. Esses métodos não serão necessários se o DatagramSocket for usado apenas para enviar dados.
Um evento DatagramSocket.MessageReceived ocorre em um DatagramSocket que foi associado a um nome de serviço local ou porta UDP quando uma mensagem é recebida. Uma instância datagramSocketMessageReceivedEventArgs é criada quando o evento DatagramSocket.MessageReceived ocorre.
Há dois métodos principais para ler dados quando uma mensagem é recebida:
- O método GetDataStream retorna um objeto Streams.IInputStream que representa um fluxo sequencial de bytes na mensagem recebida. Em seguida, o aplicativo deve analisar o fluxo recebido de bytes.
- O método GetDataReader retorna um objeto Streams.DataReader para ler dados de entrada. O objeto Streams.DataReader tem métodos separados para ler os dados em uma variedade de formatos, incluindo bytes, inteiros assinados e sem sinal, valores boolianos, números de ponto flutuante único e duplo, cadeias de caracteres, valores de intervalo de data e hora, GUIDs e buffers. Esses métodos podem ser usados diretamente para analisar a mensagem recebida.
Propriedades
| LocalAddress |
Obtém o endereço IP local associado a um DatagramSocket quando uma mensagem foi recebida. |
| RemoteAddress |
Obtém o endereço IP do remetente remoto do datagram no DatagramSocket quando uma mensagem é recebida. |
| RemotePort |
Obtém o número da porta UDP do remetente remoto do datagrama recebido no DatagramSocket. |
Métodos
| GetDataReader() |
Obtém um objeto DataReader para ler os dados de entrada recebidos do destino de rede remota em um objeto DatagramSocket . |
| GetDataStream() |
Obtém um objeto IInputStream que representa um fluxo sequencial de bytes a serem lidos como uma mensagem do destino de rede remota em um objeto DatagramSocket . |