Socket.SendTo Metodo

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo (byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * int * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Esempio

Nell'esempio di codice seguente viene inviato un datagramma senza connessione all'host remoto specificato. L'offset, le dimensioni e SocketFlags il metodo vengono passati al SendTo metodo .

static void SendTo4()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );

   array<Byte>^ msg = Encoding::ASCII->GetBytes( "This is a test" );
   Console::WriteLine( "Sending data." );
   // This call blocks. 
   s->SendTo( msg, 0, msg->Length, SocketFlags::None, endPoint );
   s->Close();
}

public static void SendTo4()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, 0, msg.Length, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo4() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, 0, msg.Length, SocketFlags.None, endPoint)
    s.Close()

End Sub

Commenti

In questo overload, se si specifica il DontRoute flag come socketflags parametro, i dati inviati non verranno indirizzati.

Se si usa un protocollo senza connessione, non è necessario stabilire un host remoto predefinito con il Connect metodo prima di chiamare SendTo. È necessario eseguire questa operazione solo se si intende chiamare il Send metodo. Se si chiama il Connect metodo prima di chiamare SendTo, il remoteEP parametro eseguirà l'override dell'host remoto predefinito specificato solo per tale operazione di invio. Non è inoltre necessario chiamare il metodo, perché il provider di servizi sottostante assegna l'indirizzo Bind di rete e il numero di porta più appropriato. Se è necessario identificare l'indirizzo di rete locale assegnato e il numero di porta, è possibile usare la LocalEndPoint proprietà dopo il completamento del SendTo metodo.

Anche se destinato ai protocolli senza connessione, SendTo funziona anche con protocolli orientati alla connessione. Se si usa un protocollo orientato alla connessione, è prima necessario stabilire una connessione host remota chiamando il metodo o accettando una richiesta di connessione in ingresso usando il ConnectAccept metodo . Se non si stabilisce o si accetta una connessione host remota, SendTo verrà generata una SocketExceptionclasse . È anche possibile stabilire un host remoto predefinito per un protocollo senza connessione prima di chiamare il SendTo metodo. In uno di questi casi, SendTo ignora il remoteEP parametro e invia solo i dati all'host remoto connesso o predefinito.

I socket di blocco bloccano finché non viene inviato il numero richiesto di byte. Poiché un blocco Socket non viene completato immediatamente, potrebbe non inviare tutti i byte richiesti in una singola operazione. È responsabilità delle applicazioni tenere traccia del numero di byte inviati e riprovare l'operazione fino a quando l'applicazione invia il numero richiesto di byte. Non vi è anche alcuna garanzia che i dati inviati verranno visualizzati immediatamente nella rete. Per aumentare l'efficienza della rete, il sistema sottostante può ritardare la trasmissione fino a quando non viene raccolta una quantità significativa di dati in uscita. Un completamento riuscito del SendTo metodo significa che il sistema sottostante ha avuto spazio per bufferre i dati per un invio di rete.

Se si usa un protocollo senza connessione in modalità di blocco, SendTo il datagram non verrà inviato. Se si desidera inviare dati a un indirizzo di trasmissione, è prima necessario chiamare il SetSocketOption metodo e impostare l'opzione socket su SocketOptionName.Broadcast. È anche necessario assicurarsi che le dimensioni non superino le dimensioni massime del provider di servizi sottostanti. In caso contrario, il datagram non verrà inviato e SendTo genererà un SocketExceptionoggetto .

Vedi anche

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, int size, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo (byte[] buffer, int size, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * int * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), size As Integer, socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Esempio

Nell'esempio di codice seguente viene inviato un datagramma senza connessione all'host remoto specificato. Le dimensioni e SocketFlags vengono passate al SendTo metodo .

static void SendTo3()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );

   array<Byte>^ msg = Encoding::ASCII->GetBytes( "This is a test" );
   Console::WriteLine( "Sending data." );
   // This call blocks. 
   s->SendTo( msg, msg->Length, SocketFlags::None, endPoint );
   s->Close();
}

public static void SendTo3()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, msg.Length, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo3() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, msg.Length, SocketFlags.None, endPoint)
    s.Close()

End Sub

Commenti

In questo overload l'offset del buffer viene impostato su 0. Se si specifica il DontRoute flag come socketflags parametro, i dati inviati non verranno indirizzati.

Se si usa un protocollo senza connessione, non è necessario stabilire un host remoto predefinito con il Connect metodo prima di chiamare SendTo. È necessario eseguire questa operazione solo se si intende chiamare il Send metodo. Se si chiama il Connect metodo prima di chiamare SendTo, il remoteEP parametro eseguirà l'override dell'host remoto predefinito specificato solo per tale operazione di invio. Non è inoltre necessario chiamare il metodo, perché il provider di servizi sottostante assegna l'indirizzo Bind di rete e il numero di porta più appropriato. Se è necessario identificare l'indirizzo di rete locale assegnato e il numero di porta, è possibile usare la LocalEndPoint proprietà dopo il completamento del SendTo metodo.

Anche se destinato ai protocolli senza connessione, SendTo funziona anche con protocolli orientati alla connessione. Se si usa un protocollo orientato alla connessione, è prima necessario stabilire una connessione host remota chiamando il metodo o accettando una richiesta di connessione in ingresso usando il ConnectAccept metodo . Se non si stabilisce o si accetta una connessione host remota, SendTo verrà generata una SocketExceptionclasse . È anche possibile stabilire un host remoto predefinito per un protocollo senza connessione prima di chiamare il SendTo metodo. In uno di questi casi, SendTo ignora il remoteEP parametro e invia solo i dati all'host remoto connesso o predefinito.

I socket di blocco bloccano finché non viene inviato il numero richiesto di byte. Poiché un blocco Socket non viene completato immediatamente, potrebbe non inviare tutti i byte richiesti in una singola operazione. È responsabilità dell'applicazione tenere traccia del numero di byte inviati e riprovare l'operazione fino a quando l'applicazione invia il numero richiesto di byte. Non vi è anche alcuna garanzia che i dati inviati verranno visualizzati immediatamente nella rete. Per aumentare l'efficienza della rete, il sistema sottostante può ritardare la trasmissione fino a quando non viene raccolta una quantità significativa di dati in uscita. Un completamento riuscito del SendTo metodo significa che il sistema sottostante ha avuto spazio per bufferre i dati per un invio di rete.

Se si usa un protocollo senza connessione in modalità di blocco, SendTo il datagram non verrà inviato. Se si desidera inviare dati a un indirizzo di trasmissione, è prima necessario chiamare il SetSocketOption metodo e impostare l'opzione socket su SocketOptionName.Broadcast. È inoltre necessario assicurarsi che il numero di byte inviati non superi le dimensioni massime del pacchetto del provider di servizi sottostante. In caso affermativo, il datagramma non verrà inviato e SendTo genererà un'eccezione SocketException.

Vedi anche

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::SocketAddress ^ socketAddress);

public int SendTo (ReadOnlySpan<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.SocketAddress socketAddress);

member this.SendTo : ReadOnlySpan<byte> * System.Net.Sockets.SocketFlags * System.Net.SocketAddress -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags, socketAddress As SocketAddress) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::EndPoint ^ remoteEP);

public int SendTo (ReadOnlySpan<byte> buffer, System.Net.EndPoint remoteEP);

member this.SendTo : ReadOnlySpan<byte> * System.Net.EndPoint -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo (byte[] buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Esempio

Nell'esempio di codice seguente viene inviato un datagram senza connessione all'host remoto specificato. SocketFlags vengono passati al SendTo metodo .

static void SendTo2()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );

   array<Byte>^ msg = Encoding::ASCII->GetBytes( "This is a test" );
   Console::WriteLine( "Sending data." );
   // This call blocks. 
   s->SendTo( msg, SocketFlags::None, endPoint );
   s->Close();
}

public static void SendTo2()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, SocketFlags.None, endPoint);
    s.Close();
}

Public Shared Sub SendTo2() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, SocketFlags.None, endPoint)
    s.Close()

End Sub

Commenti

In questo overload, l'offset del buffer viene predefinito su 0 e il numero di byte da inviare per impostazione predefinita alle dimensioni dell'oggetto buffer. Se si specifica il DontRoute flag come socketflags parametro, i dati inviati non verranno instradati.

Se si usa un protocollo senza connessione, non è necessario stabilire un host remoto predefinito con il Connect metodo prima di chiamare SendTo. Questa operazione deve essere eseguita solo se si intende chiamare il Send metodo . Se si chiama il Connect metodo prima di chiamare SendTo, il remoteEP parametro eseguirà l'override dell'host remoto predefinito specificato solo per l'operazione di invio. Non è inoltre necessario chiamare il Bind metodo, perché il provider di servizi sottostante assegnerà l'indirizzo di rete locale e il numero di porta più appropriati. Se è necessario identificare l'indirizzo di rete locale assegnato e il numero di porta, è possibile usare la LocalEndPoint proprietà al termine del SendTo metodo.

Anche se destinato ai protocolli senza connessione, SendTo funziona anche con i protocolli orientati alla connessione. Se si usa un protocollo orientato alla connessione, è innanzitutto necessario stabilire una connessione host remota chiamando il Connect metodo o accettando una richiesta di connessione in ingresso usando il Accept metodo . Se non si stabilisce o accetta una connessione host remota, SendTo genera un'eccezione SocketException. È anche possibile stabilire un host remoto predefinito per un protocollo senza connessione prima di chiamare il SendTo metodo . In uno di questi casi, SendTo ignorerà il remoteEP parametro e invierà solo i dati all'host remoto connesso o predefinito.

I socket di blocco verranno bloccati fino a quando non vengono inviati tutti i byte richiesti in buffer . Poiché un non bloccante Socket viene completato immediatamente, potrebbe non inviare tutti i byte in buffer. È responsabilità dell'applicazione tenere traccia del numero di byte inviati e ripetere l'operazione fino a quando l'applicazione non invia tutti i byte in buffer. Non esiste inoltre alcuna garanzia che i dati inviati vengano visualizzati immediatamente nella rete. Per aumentare l'efficienza della rete, il sistema sottostante può ritardare la trasmissione fino a quando non viene raccolta una quantità significativa di dati in uscita. Un completamento corretto del SendTo metodo indica che il sistema sottostante ha avuto spazio per memorizzare nel buffer i dati per un invio di rete.

Se si usa un protocollo senza connessione in modalità di blocco, SendTo verrà bloccato fino all'invio del datagramma. Se si desidera inviare dati a un indirizzo broadcast, è necessario chiamare il SetSocketOption metodo e impostare l'opzione socket su SocketOptionName.Broadcast. È inoltre necessario assicurarsi che il numero di byte inviati non superi le dimensioni massime del pacchetto del provider di servizi sottostante. In caso affermativo, il datagramma non verrà inviato e SendTo genererà un'eccezione SocketException.

Vedi anche

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(cli::array <System::Byte> ^ buffer, System::Net::EndPoint ^ remoteEP);

public int SendTo (byte[] buffer, System.Net.EndPoint remoteEP);

member this.SendTo : byte[] * System.Net.EndPoint -> int

Public Function SendTo (buffer As Byte(), remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni

Esempio

Nell'esempio di codice seguente viene inviato un datagram senza connessione all'host remoto specificato.

static void SendTo1()
{
   IPHostEntry^ hostEntry = Dns::Resolve( Dns::GetHostName() );
   IPEndPoint^ endPoint = gcnew IPEndPoint( hostEntry->AddressList[ 0 ],11000 );

   Socket^ s = gcnew Socket( endPoint->Address->AddressFamily,
      SocketType::Dgram,
      ProtocolType::Udp );

   array<Byte>^ msg = Encoding::ASCII->GetBytes( "This is a test" );
   Console::WriteLine( "Sending data." );
   // This call blocks. 
   s->SendTo( msg, endPoint );
   s->Close();
}

public static void SendTo1()
{
    IPHostEntry hostEntry = Dns.GetHostEntry(Dns.GetHostName());
    IPEndPoint endPoint = new IPEndPoint(hostEntry.AddressList[0], 11000);

    Socket s = new Socket(endPoint.Address.AddressFamily,
        SocketType.Dgram,
        ProtocolType.Udp);

    byte[] msg = Encoding.ASCII.GetBytes("This is a test");
    Console.WriteLine("Sending data.");
    // This call blocks.
    s.SendTo(msg, endPoint);
    s.Close();
}

Public Shared Sub SendTo1() 
    Dim hostEntry As IPHostEntry = Dns.GetHostEntry(Dns.GetHostName())
    Dim endPoint As New IPEndPoint(hostEntry.AddressList(0), 11000)
    
    Dim s As New Socket(endPoint.Address.AddressFamily, SocketType.Dgram, ProtocolType.Udp)
    
    Dim msg As Byte() = Encoding.ASCII.GetBytes("This is a test")
    Console.WriteLine("Sending data.")
    ' This call blocks. 
    s.SendTo(msg, endPoint)
    s.Close()

End Sub

Commenti

In questo overload, l'offset del buffer viene impostato su 0, il numero di byte da inviare per impostazione predefinita alle dimensioni del buffer parametro e il SocketFlags valore predefinito è 0.

Se si usa un protocollo senza connessione, non è necessario stabilire un host remoto predefinito con il Connect metodo prima di chiamare SendTo. Questa operazione deve essere eseguita solo se si intende chiamare il Send metodo . Se si chiama il Connect metodo prima di chiamare SendTo, il remoteEP parametro eseguirà l'override dell'host remoto predefinito specificato solo per l'operazione di invio. Non è inoltre necessario chiamare il Bind metodo, perché il provider di servizi sottostante assegnerà l'indirizzo di rete locale e il numero di porta più appropriati. Se è necessario identificare l'indirizzo di rete locale assegnato e il numero di porta, è possibile usare la LocalEndPoint proprietà al termine del SendTo metodo.

Anche se destinato ai protocolli senza connessione, SendTo funziona anche con i protocolli orientati alla connessione. Se si usa un protocollo orientato alla connessione, è innanzitutto necessario stabilire una connessione host remota chiamando il Connect metodo o accettando una richiesta di connessione in ingresso usando il Accept metodo . Se non si stabilisce o accetta una connessione host remota, SendTo genera un'eccezione SocketException. È anche possibile stabilire un host remoto predefinito per un protocollo senza connessione prima di chiamare il SendTo metodo . In uno di questi casi, SendTo ignorerà il remoteEP parametro e invierà solo i dati all'host remoto connesso o predefinito.

I socket di blocco verranno bloccati fino a quando non vengono inviati tutti i byte nel buffer. Poiché un non bloccante Socket viene completato immediatamente, potrebbe non inviare tutti i byte in buffer. È responsabilità dell'applicazione tenere traccia del numero di byte inviati e ripetere l'operazione fino a quando l'applicazione non invia tutti i byte in buffer. Non esiste inoltre alcuna garanzia che i dati inviati vengano visualizzati immediatamente nella rete. Per aumentare l'efficienza della rete, il sistema sottostante può ritardare la trasmissione fino a quando non viene raccolta una quantità significativa di dati in uscita. Un completamento corretto del SendTo metodo indica che il sistema sottostante ha avuto spazio per memorizzare nel buffer i dati per un invio di rete.

Se si usa un protocollo senza connessione in modalità di blocco, SendTo verrà bloccato fino all'invio del datagramma. Se si desidera inviare dati a un indirizzo broadcast, è necessario chiamare il SetSocketOption metodo e impostare l'opzione socket su SocketOptionName.Broadcast. È inoltre necessario assicurarsi che il numero di byte inviati non superi le dimensioni massime del pacchetto del provider di servizi sottostante. In caso affermativo, il datagramma non verrà inviato e SendTo genererà un'eccezione SocketException.

Vedi anche

• Connect(EndPoint)
• Bind(EndPoint)
• Send(Byte[], Int32, SocketFlags)
• SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)
• SetSocketOption(SocketOptionLevel, SocketOptionName, Int32)
• LocalEndPoint

Origine:

Socket.cs

Origine:

Socket.cs

Origine:

Socket.cs

public:
 int SendTo(ReadOnlySpan<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, System::Net::EndPoint ^ remoteEP);

public int SendTo (ReadOnlySpan<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, System.Net.EndPoint remoteEP);

member this.SendTo : ReadOnlySpan<byte> * System.Net.Sockets.SocketFlags * System.Net.EndPoint -> int

Public Function SendTo (buffer As ReadOnlySpan(Of Byte), socketFlags As SocketFlags, remoteEP As EndPoint) As Integer

Parametri

Restituisce

Numero di byte inviati.

Eccezioni