Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe UdpClient

 

Data di pubblicazione: ottobre 2016

Fornisce servizi di rete UDP (User Datagram Protocol).

Spazio dei nomi:   System.Net.Sockets
Assembly:  System (in System.dll)

System.Object
  System.Net.Sockets.UdpClient

public class UdpClient : IDisposable

NomeDescrizione
System_CAPS_pubmethodUdpClient()

Inizializza una nuova istanza della classe UdpClient.

System_CAPS_pubmethodUdpClient(AddressFamily)

Inizializza una nuova istanza della classe UdpClient.

System_CAPS_pubmethodUdpClient(Int32)

Inizializza una nuova istanza di UdpClient classe e lo associa al numero di porta locale fornito.

System_CAPS_pubmethodUdpClient(Int32, AddressFamily)

Inizializza una nuova istanza di UdpClient classe e lo associa al numero di porta locale fornito.

System_CAPS_pubmethodUdpClient(IPEndPoint)

Inizializza una nuova istanza della classe UdpClient e la associa all'endpoint locale specificato.

System_CAPS_pubmethodUdpClient(String, Int32)

Inizializza una nuova istanza di UdpClient classe e stabilisce un host remoto predefinito.

NomeDescrizione
System_CAPS_protpropertyActive

Ottiene o imposta un valore che indica se è stato stabilito un host remoto predefinito.

System_CAPS_pubpropertyAvailable

Ottiene la quantità di dati ricevuti dalla rete che è disponibile per la lettura.

System_CAPS_pubpropertyClient

Ottiene o imposta la rete sottostante Socket.

System_CAPS_pubpropertyDontFragment

Ottiene o imposta un Boolean valore che specifica se il UdpClient consente la frammentazione dei datagrammi IP (Internet Protocol).

System_CAPS_pubpropertyEnableBroadcast

Ottiene o imposta un Boolean valore che specifica se il UdpClient può inviare o ricevere pacchetti broadcast.

System_CAPS_pubpropertyExclusiveAddressUse

Ottiene o imposta un valore Boolean che specifica se la classe UdpClient consente a un unico client di usare una porta.

System_CAPS_pubpropertyMulticastLoopback

Ottiene o imposta un Boolean valore che specifica se i pacchetti multicast in uscita vengono recapitati all'applicazione mittente.

System_CAPS_pubpropertyTtl

Ottiene o imposta un valore che specifica il valore Time to Live (TTL) dei pacchetti IP (Internet Protocol) inviati dal UdpClient.

NomeDescrizione
System_CAPS_pubmethodAllowNatTraversal(Boolean)

Abilita o disabilita l'attraversamento NAT Network Address Translation (NAT) in un UdpClient istanza.

System_CAPS_pubmethodBeginReceive(AsyncCallback, Object)

Riceve un datagramma da un host remoto in modo asincrono.

System_CAPS_pubmethodBeginSend(Byte[], Int32, AsyncCallback, Object)

Invia un datagramma a un host remoto in modo asincrono. La destinazione è stata specificata in precedenza da una chiamata a Connect.

System_CAPS_pubmethodBeginSend(Byte[], Int32, IPEndPoint, AsyncCallback, Object)

Invia un datagramma a una destinazione in modo asincrono. La destinazione è specificata da un EndPoint.

System_CAPS_pubmethodBeginSend(Byte[], Int32, String, Int32, AsyncCallback, Object)

Invia un datagramma a una destinazione in modo asincrono. La destinazione è specificata dal nome dell'host e numero di porta.

System_CAPS_pubmethodClose()

Chiude la connessione UDP.

System_CAPS_pubmethodConnect(IPAddress, Int32)

Stabilisce un host remoto predefinito utilizzando il numero di porta e indirizzo IP specificato.

System_CAPS_pubmethodConnect(IPEndPoint)

Stabilisce un host remoto utilizzando l'endpoint di rete specificata.

System_CAPS_pubmethodConnect(String, Int32)

Stabilisce un host remoto predefinito utilizzando il nome e il numero porta host.

System_CAPS_pubmethodDispose()

Rilascia le risorse gestite e non gestite usate dall'oggetto UdpClient.

System_CAPS_protmethodDispose(Boolean)

Rilascia le risorse non gestite usate da UdpClient e, facoltativamente, le risorse gestite.

System_CAPS_pubmethodDropMulticastGroup(IPAddress)

Lascia un gruppo multicast.

System_CAPS_pubmethodDropMulticastGroup(IPAddress, Int32)

Lascia un gruppo multicast.

System_CAPS_pubmethodEndReceive(IAsyncResult, IPEndPoint)

Termina una ricezione asincrona in attesa.

System_CAPS_pubmethodEndSend(IAsyncResult)

Termina un invio asincrono in sospeso.

System_CAPS_pubmethodEquals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object.)

System_CAPS_protmethodFinalize()

Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulizia prima che l'oggetto stesso venga reclamato dalla procedura di Garbage Collection. (Ereditato da Object.)

System_CAPS_pubmethodGetHashCode()

Funge da funzione hash predefinita.(Ereditato da Object.)

System_CAPS_pubmethodGetType()

Ottiene l'oggetto Type dell'istanza corrente.(Ereditato da Object.)

System_CAPS_pubmethodJoinMulticastGroup(Int32, IPAddress)

Aggiunge un UdpClient a un gruppo multicast.

System_CAPS_pubmethodJoinMulticastGroup(IPAddress)

Aggiunge un UdpClient a un gruppo multicast.

System_CAPS_pubmethodJoinMulticastGroup(IPAddress, Int32)

Aggiunge un UdpClient a un gruppo multicast con il tempo specificato to Live (TTL).

System_CAPS_pubmethodJoinMulticastGroup(IPAddress, IPAddress)

Aggiunge un UdpClient a un gruppo multicast.

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.(Ereditato da Object.)

System_CAPS_pubmethodReceive(IPEndPoint)

Restituisce un datagramma UDP che è stato inviato da un host remoto.

System_CAPS_pubmethodReceiveAsync()

Restituisce un datagramma UDP in modo asincrono che è stato inviato da un host remoto.

System_CAPS_pubmethodSend(Byte[], Int32)

Invia un datagramma UDP a un host remoto.

System_CAPS_pubmethodSend(Byte[], Int32, IPEndPoint)

Invia un datagramma UDP all'host all'endpoint remoto specificato.

System_CAPS_pubmethodSend(Byte[], Int32, String, Int32)

Invia un datagramma UDP a una porta specificata in un host remoto specificato.

System_CAPS_pubmethodSendAsync(Byte[], Int32)

Invia un datagramma UDP in modo asincrono a un host remoto.

System_CAPS_pubmethodSendAsync(Byte[], Int32, IPEndPoint)

Invia un datagramma UDP in modo asincrono a un host remoto.

System_CAPS_pubmethodSendAsync(Byte[], Int32, String, Int32)

Invia un datagramma UDP in modo asincrono a un host remoto.

System_CAPS_pubmethodToString()

Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object.)

The T:System.Net.Sockets.UdpClient class provides simple methods for sending and receiving connectionless UDP datagrams in blocking synchronous mode. Because UDP is a connectionless transport protocol, you do not need to establish a remote host connection prior to sending and receiving data. You do, however, have the option of establishing a default remote host in one of the following two ways:

  • Create an instance of the T:System.Net.Sockets.UdpClient class using the remote host name and port number as parameters.

  • Create an instance of the T:System.Net.Sockets.UdpClient class and then call the M:System.Net.Sockets.UdpClient.Connect(System.String,System.Int32) method.

You can use any of the send methods provided in the T:System.Net.Sockets.UdpClient to send data to a remote device. Use the M:System.Net.Sockets.UdpClient.Receive(System.Net.IPEndPoint@) method to receive data from remote hosts.

System_CAPS_noteNota

Do not call M:System.Net.Sockets.UdpClient.Send(System.Byte[],System.Int32,System.Net.IPEndPoint) using a host name or T:System.Net.IPEndPoint if you have already specified a default remote host. If you do, T:System.Net.Sockets.UdpClient will throw an exception.

UdpClient methods also allow you to send and receive multicast datagrams. Use the JoinMulticastGroup method to subscribe a UdpClient to a multicast group. Use the DropMulticastGroup method to unsubscribe a UdpClient from a multicast group.

The following example establishes a T:System.Net.Sockets.UdpClient connection using the host name www.contoso.com on port 11000. A small string message is sent to two separate remote host machines. The M:System.Net.Sockets.UdpClient.Receive(System.Net.IPEndPoint@) method blocks execution until a message is received. Using the T:System.Net.IPEndPoint passed to M:System.Net.Sockets.UdpClient.Receive(System.Net.IPEndPoint@), the identity of the responding host is revealed.

// This constructor arbitrarily assigns the local port number.
UdpClient udpClient = new UdpClient(11000);
    try{
         udpClient.Connect("www.contoso.com", 11000);

         // Sends a message to the host to which you have connected.
         Byte[] sendBytes = Encoding.ASCII.GetBytes("Is anybody there?");

         udpClient.Send(sendBytes, sendBytes.Length);

         // Sends a message to a different host using optional hostname and port parameters.
         UdpClient udpClientB = new UdpClient();
         udpClientB.Send(sendBytes, sendBytes.Length, "AlternateHostMachineName", 11000);

         //IPEndPoint object will allow us to read datagrams sent from any source.
         IPEndPoint RemoteIpEndPoint = new IPEndPoint(IPAddress.Any, 0);

         // Blocks until a message returns on this socket from a remote host.
         Byte[] receiveBytes = udpClient.Receive(ref RemoteIpEndPoint); 
         string returnData = Encoding.ASCII.GetString(receiveBytes);

         // Uses the IPEndPoint object to determine which of these two hosts responded.
         Console.WriteLine("This is the message you received " +
    	                              returnData.ToString());
         Console.WriteLine("This message was sent from " +
                                     RemoteIpEndPoint.Address.ToString() +
                                     " on their port number " +
                                     RemoteIpEndPoint.Port.ToString());

          udpClient.Close();
          udpClientB.Close();

          }  
       catch (Exception e ) {
                  Console.WriteLine(e.ToString());
        }

SocketPermission

To establish an outgoing connection or accept an incoming request.

.NET Framework
Disponibile da 1.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: