Socket.SendTo Methode

Definitie

Naamruimte:: System.Net.Sockets

Assembly:: System.dll

Assembly:: System.Net.Sockets.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Hiermee worden gegevens naar een specifiek eindpunt verzonden.

Overloads

Name	Description
SendTo(Byte[], EndPoint)	Hiermee worden gegevens naar het opgegeven eindpunt verzonden.
SendTo(Byte[], SocketFlags, EndPoint)	Hiermee worden gegevens naar een specifiek eindpunt verzonden met behulp van de opgegeven SocketFlags.
SendTo(Byte[], Int32, SocketFlags, EndPoint)	Hiermee wordt het opgegeven aantal bytes aan gegevens naar het opgegeven eindpunt verzonden met behulp van het opgegeven SocketFlags.
SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)	Hiermee verzendt u het opgegeven aantal bytes aan gegevens naar het opgegeven eindpunt, te beginnen bij de opgegeven locatie in de buffer en gebruikt u de opgegeven SocketFlags.

SendTo(Byte[], EndPoint)

Hiermee worden gegevens naar het opgegeven eindpunt verzonden.

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

Parameters

buffer: Byte[]

Een matrix van het type Byte dat de gegevens bevat die moeten worden verzonden.

remoteEP: EndPoint

De EndPoint bestemming voor de gegevens.

Retouren

Int32

Het aantal bytes dat is verzonden.

Uitzonderingen

ArgumentNullException

buffer is null.

– of –

remoteEP is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld wordt een gegevensgram zonder verbinding naar de opgegeven externe host verzonden.

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

Opmerkingen

Bij deze overbelasting wordt de bufferverschil standaard ingesteld op 0, het aantal bytes dat standaardwaarden moeten worden verzonden naar de grootte van de buffer parameter en de SocketFlags waarde is standaard ingesteld op 0.

Als u een verbindingsloos protocol gebruikt, hoeft u geen standaard externe host tot stand te brengen met de Connect methode voordat u aanroept SendTo. U hoeft dit alleen te doen als u de Send methode wilt aanroepen. Als u de Connect methode voordat u aanroept SendTo, overschrijft de remoteEP parameter alleen de opgegeven standaard externe host voor die verzendbewerking. U hoeft de Bind methode ook niet aan te roepen, omdat de onderliggende serviceprovider het meest geschikte lokale netwerkadres en poortnummer toewijst. Als u het toegewezen lokale netwerkadres en poortnummer wilt identificeren, kunt u de LocalEndPoint eigenschap gebruiken nadat de SendTo methode is voltooid.

Hoewel deze is bedoeld voor verbindingsloze protocollen, SendTo werkt dit ook met verbindingsgeoriënteerde protocollen. Als u een verbindingsgeoriënteerd protocol gebruikt, moet u eerst een externe hostverbinding tot stand brengen door de Connect methode aan te roepen of een binnenkomende verbindingsaanvraag te accepteren met behulp van de Accept methode. Als u geen externe hostverbinding tot stand brengt of accepteert, SendTo genereert u een SocketException. U kunt ook een standaard externe host instellen voor een verbindingsloos protocol voordat u de SendTo methode aanroept. In beide gevallen SendTo negeert u de remoteEP parameter en verzendt u alleen gegevens naar de verbonden of standaard externe host.

Het blokkeren van sockets wordt geblokkeerd totdat alle bytes in de buffer worden verzonden. Omdat een niet-blokkering Socket onmiddellijk is voltooid, worden mogelijk niet alle bytes in de buffer. Het is de verantwoordelijkheid van uw toepassing om het aantal verzonden bytes bij te houden en de bewerking opnieuw uit te voeren totdat alle bytes in de toepassing worden bufferverzonden. Er is ook geen garantie dat de gegevens die u verzendt, onmiddellijk in het netwerk worden weergegeven. Om de netwerkefficiëntie te verhogen, kan het onderliggende systeem de overdracht vertragen totdat een aanzienlijke hoeveelheid uitgaande gegevens wordt verzameld. Een geslaagde voltooiing van de SendTo methode betekent dat het onderliggende systeem ruimte heeft gehad om uw gegevens te bufferen voor een netwerk verzenden.

Als u een verbindingsloos protocol in de blokkeringsmodus gebruikt, SendTo wordt dit geblokkeerd totdat het datagram wordt verzonden. Als u gegevens naar een broadcast-adres wilt verzenden, moet u eerst de SetSocketOption methode aanroepen en de socketoptie instellen op SocketOptionName.Broadcast. U moet er ook voor zorgen dat het aantal verzonden bytes niet groter is dan de maximale pakketgrootte van de onderliggende serviceprovider. Als dat het geval is, wordt het datagram niet verzonden en SendTo wordt er een SocketException.

Note

Als u een SocketExceptionontvangt, gebruikt u de SocketException.ErrorCode eigenschap om de specifieke foutcode te verkrijgen. Nadat u deze code hebt verkregen, raadpleegt u de Windows Sockets versie 2 API-foutcode documentatie voor een gedetailleerde beschrijving van de fout.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

SendTo(Byte[], SocketFlags, EndPoint)

Hiermee worden gegevens naar een specifiek eindpunt verzonden met behulp van de opgegeven SocketFlags.

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

Parameters

buffer: Byte[]

Een matrix van het type Byte dat de gegevens bevat die moeten worden verzonden.

socketFlags: SocketFlags

Een bitsgewijze combinatie van de SocketFlags waarden.

remoteEP: EndPoint

De EndPoint locatie die de doellocatie voor de gegevens vertegenwoordigt.

Retouren

Int32

Het aantal bytes dat is verzonden.

Uitzonderingen

ArgumentNullException

buffer is null.

– of –

remoteEP is null.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld wordt een gegevensgram zonder verbinding naar de opgegeven externe host verzonden. SocketFlags worden doorgegeven aan de SendTo methode.

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

Opmerkingen

Bij deze overbelasting wordt de buffer offset standaard ingesteld op 0 en het aantal bytes dat standaardwaarden naar de grootte van de buffer. Als u de DontRoute vlag opgeeft als de socketflags parameter, worden de gegevens die u verzendt, niet gerouteerd.

Het blokkeren van sockets wordt geblokkeerd totdat alle bytes in de buffer bytes worden verzonden. Omdat een niet-blokkering Socket onmiddellijk is voltooid, worden mogelijk niet alle bytes in de buffer. Het is de verantwoordelijkheid van uw toepassing om het aantal verzonden bytes bij te houden en de bewerking opnieuw uit te voeren totdat alle bytes in de toepassing worden bufferverzonden. Er is ook geen garantie dat de gegevens die u verzendt, onmiddellijk in het netwerk worden weergegeven. Om de netwerkefficiëntie te verhogen, kan het onderliggende systeem de overdracht vertragen totdat een aanzienlijke hoeveelheid uitgaande gegevens wordt verzameld. Een geslaagde voltooiing van de SendTo methode betekent dat het onderliggende systeem ruimte heeft gehad om uw gegevens te bufferen voor een netwerk verzenden.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

SendTo(Byte[], Int32, SocketFlags, EndPoint)

Hiermee wordt het opgegeven aantal bytes aan gegevens naar het opgegeven eindpunt verzonden met behulp van het opgegeven SocketFlags.

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

Parameters

buffer: Byte[]

Een matrix van het type Byte dat de gegevens bevat die moeten worden verzonden.

size: Int32

Het aantal te verzenden bytes.

socketFlags: SocketFlags

Een bitsgewijze combinatie van de SocketFlags waarden.

remoteEP: EndPoint

De EndPoint locatie die de doellocatie voor de gegevens vertegenwoordigt.

Retouren

Int32

Het aantal bytes dat is verzonden.

Uitzonderingen

ArgumentNullException

buffer is null.

– of –

remoteEP is null.

ArgumentOutOfRangeException

De opgegeven size waarde overschrijdt de grootte van buffer.

SocketException

Er is een fout opgetreden bij het openen van de socket.

ObjectDisposedException

De Socket is gesloten.

Voorbeelden

In het volgende codevoorbeeld wordt een gegevensgram zonder verbinding naar de opgegeven externe host verzonden. De grootte en SocketFlags worden doorgegeven aan de SendTo methode.

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

Opmerkingen

Bij deze overbelasting wordt de bufferverschil standaard ingesteld op 0. Als u de DontRoute vlag opgeeft als de socketflags parameter, worden de gegevens die u verzendt, niet gerouteerd.

Het blokkeren van sockets wordt geblokkeerd totdat het aangevraagde aantal bytes wordt verzonden. Omdat een niet-blokkering Socket onmiddellijk is voltooid, worden mogelijk niet alle bytes verzonden die in één bewerking zijn aangevraagd. Het is de verantwoordelijkheid van uw toepassing om het aantal verzonden bytes bij te houden en de bewerking opnieuw uit te voeren totdat de toepassing het aangevraagde aantal bytes verzendt. Er is ook geen garantie dat de gegevens die u verzendt, onmiddellijk in het netwerk worden weergegeven. Om de netwerkefficiëntie te verhogen, kan het onderliggende systeem de overdracht vertragen totdat een aanzienlijke hoeveelheid uitgaande gegevens wordt verzameld. Een geslaagde voltooiing van de SendTo methode betekent dat het onderliggende systeem ruimte heeft gehad om uw gegevens te bufferen voor een netwerk verzenden.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)

Hiermee verzendt u het opgegeven aantal bytes aan gegevens naar het opgegeven eindpunt, te beginnen bij de opgegeven locatie in de buffer en gebruikt u de opgegeven SocketFlags.

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

Parameters

buffer: Byte[]

Een matrix van het type Byte dat de gegevens bevat die moeten worden verzonden.

offset: Int32

De positie in de gegevensbuffer waarop gegevens moeten worden verzonden.

size: Int32

Het aantal te verzenden bytes.

socketFlags: SocketFlags

Een bitsgewijze combinatie van de SocketFlags waarden.

remoteEP: EndPoint

De EndPoint locatie die de doellocatie voor de gegevens vertegenwoordigt.

Retouren

Int32

Het aantal bytes dat is verzonden.

Uitzonderingen

ArgumentNullException

buffer is null.

– of –

remoteEP is null.

ArgumentOutOfRangeException

offset is kleiner dan 0.

– of –

offset is groter dan de lengte van buffer.

– of –

size is kleiner dan 0.

– of –

size is groter dan de lengte van buffer min de waarde van de offset parameter.

SocketException

socketFlags is geen geldige combinatie van waarden.

– of –

Er treedt een fout op in het besturingssysteem tijdens het openen van de Socket.

ObjectDisposedException

De Socket is gesloten.

SecurityException

Een aanroeper in de aanroepstack beschikt niet over de vereiste machtigingen.

Voorbeelden

In het volgende codevoorbeeld wordt een gegevensgram zonder verbinding naar de opgegeven externe host verzonden. De offset, grootte en SocketFlags worden doorgegeven aan de SendTo methode.

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

Opmerkingen

Als u bij deze overbelasting de DontRoute vlag opgeeft als parameter socketflags , worden de gegevens die u verzendt, niet gerouteerd.

Het blokkeren van sockets wordt geblokkeerd totdat het aangevraagde aantal bytes wordt verzonden. Omdat een niet-blokkerende Socket bewerking onmiddellijk is voltooid, worden mogelijk niet alle bytes verzonden die in één bewerking zijn aangevraagd. Het is de verantwoordelijkheid van uw toepassingen om het aantal verzonden bytes bij te houden en de bewerking opnieuw uit te voeren totdat de toepassing het aangevraagde aantal bytes verzendt. Er is ook geen garantie dat de gegevens die u verzendt, onmiddellijk in het netwerk worden weergegeven. Om de netwerkefficiëntie te verhogen, kan het onderliggende systeem de overdracht vertragen totdat een aanzienlijke hoeveelheid uitgaande gegevens wordt verzameld. Een geslaagde voltooiing van de SendTo methode betekent dat het onderliggende systeem ruimte heeft gehad om uw gegevens te bufferen voor een netwerk verzenden.

Als u een verbindingsloos protocol in de blokkeringsmodus gebruikt, SendTo wordt dit geblokkeerd totdat het datagram wordt verzonden. Als u gegevens naar een broadcast-adres wilt verzenden, moet u eerst de SetSocketOption methode aanroepen en de socketoptie instellen op SocketOptionName.Broadcast. U moet er ook voor zorgen dat de grootte niet groter is dan de maximale pakketgrootte van de onderliggende serviceprovider. Als dat het geval is, wordt het datagram niet verzonden en SendTo wordt er een SocketException.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Zie ook

Van toepassing op

Feedback

Is deze pagina nuttig?