Socket.SendTo Metódus

Definíció

Névtér:: System.Net.Sockets

Szerelvény:: System.dll

Szerelvény:: System.Net.Sockets.dll

Szerelvény:: netstandard.dll

Fontos

Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.

Adatokat küld egy adott végpontnak.

Túlterhelések

Name	Description
SendTo(Byte[], EndPoint)	Adatokat küld a megadott végpontnak.
SendTo(Byte[], SocketFlags, EndPoint)	Adatokat küld egy adott végpontnak a megadott SocketFlagshasználatával.
SendTo(Byte[], Int32, SocketFlags, EndPoint)	A megadott számú bájtnyi adatot elküldi a megadott végpontnak a megadott SocketFlagshasználatával.
SendTo(Byte[], Int32, Int32, SocketFlags, EndPoint)	A megadott számú bájtnyi adatot elküldi a megadott végpontnak, a puffer megadott helyétől kezdve a megadott SocketFlagsmódon.

SendTo(Byte[], EndPoint)

Adatokat küld a megadott végpontnak.

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

Paraméterek

buffer: Byte[]

Az elküldendő adatokat tartalmazó tömb Byte .

remoteEP: EndPoint

Az EndPoint adatok célhelyét jelképező érték.

Válaszok

Int32

Az elküldött bájtok száma.

Kivételek

ArgumentNullException

buffer az null.

-vagy-

remoteEP az null.

SocketException

Hiba történt a szoftvercsatorna elérésekor.

ObjectDisposedException

A Socket le van zárva.

Példák

Az alábbi példakód kapcsolat nélküli datagramot küld a megadott távoli gazdagépnek.

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

Megjegyzések

Ebben a túlterhelésben a puffer eltolása alapértelmezés szerint 0, a paraméter méretére buffer küldendő bájtok száma, az SocketFlags alapértelmezett érték pedig 0.

Ha kapcsolat nélküli protokollt használ, nem kell alapértelmezett távoli gazdagépet létrehoznia a metódussal a Connect hívás SendToelőtt. Ezt csak akkor kell megtennie, ha meg szeretné hívni a metódust Send . Ha a metódust a Connect hívás SendToelőtt hívja meg, a remoteEP paraméter csak az adott küldési művelethez megadott alapértelmezett távoli gazdagépet bírálja felül. A metódus meghívása Bind sem kötelező, mert a mögöttes szolgáltató a legmegfelelőbb helyi hálózati címet és portszámot rendeli hozzá. Ha azonosítania kell a hozzárendelt helyi hálózati címet és portszámot, a metódus sikeres befejezése után használhatja a LocalEndPoint SendTo tulajdonságot.

Bár kapcsolat nélküli protokollokhoz készült, SendTo a kapcsolatorientált protokollokkal is működik. Ha kapcsolatorientált protokollt használ, először létre kell hoznia egy távoli gazdakapcsolatot a Connect metódus meghívásával, vagy fogadnia kell egy bejövő kapcsolatkérést a Accept metódus használatával. Ha nem hoz létre vagy fogad el távoli gazdakapcsolatot, SendTo a rendszer egy SocketException. A metódus meghívása SendTo előtt létrehozhat egy alapértelmezett távoli gazdagépet is egy kapcsolat nélküli protokollhoz. Bármelyik esetben figyelmen kívül hagyja a paramétertremoteEP, SendTo és csak a csatlakoztatott vagy alapértelmezett távoli gazdagépnek küld adatokat.

A blokkoló szoftvercsatornák mindaddig blokkolva lesznek, amíg a pufferben lévő összes bájt el nem lesz küldve. Mivel a tiltás feloldása Socket azonnal befejeződik, előfordulhat, hogy nem küldi el az összes bájtot a buffer. Az alkalmazás felelőssége, hogy nyomon kövesse az elküldött bájtok számát, és próbálkozzon újra a művelettel, amíg az alkalmazás az összes bájtot el nem küldi a bufferfájlban. Azt sem garantálja, hogy a küldött adatok azonnal megjelennek a hálózaton. A hálózati hatékonyság növelése érdekében a mögöttes rendszer késleltetheti az átvitelt, amíg jelentős mennyiségű kimenő adatot nem gyűjt. A módszer sikeres végrehajtása SendTo azt jelenti, hogy a mögöttes rendszernek volt helye az adatok pufferelésére egy hálózati küldéshez.

Ha kapcsolat nélküli protokollt használ blokkoló módban, SendTo a datagram elküldéséig le lesz tiltva. Ha adatokat szeretne küldeni egy szórási címre, először hívja meg a metódust SetSocketOption , és állítsa a szoftvercsatorna beállítását a következőre SocketOptionName.Broadcast: . Azt is meg kell győződnie, hogy az elküldött bájtok száma nem haladja meg a mögöttes szolgáltató maximális csomagméretét. Ha igen, a datagram nem lesz elküldve, és SendTo egy SocketException.

Note

Ha kap egy SocketException, használja a SocketException.ErrorCode tulajdonságot az adott hibakód lekéréséhez. A kód beszerzése után tekintse meg a Windows Sockets 2-es verziójának API-hibakódját a hiba részletes leírását.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Lásd még

A következőre érvényes:

SendTo(Byte[], SocketFlags, EndPoint)

Adatokat küld egy adott végpontnak a megadott SocketFlagshasználatával.

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

Paraméterek

buffer: Byte[]

Az elküldendő adatokat tartalmazó tömb Byte .

socketFlags: SocketFlags

Az értékek bitenkénti kombinációja SocketFlags .

remoteEP: EndPoint

Az EndPoint adatok célhelyét jelképező hely.

Válaszok

Int32

Az elküldött bájtok száma.

Kivételek

ArgumentNullException

buffer az null.

-vagy-

remoteEP az null.

SocketException

Hiba történt a szoftvercsatorna elérésekor.

ObjectDisposedException

A Socket le van zárva.

Példák

Az alábbi példakód kapcsolat nélküli datagramot küld a megadott távoli gazdagépnek. SocketFlags a rendszer átadja a SendTo metódusnak.

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

Megjegyzések

Ebben a túlterhelésben a puffer eltolása alapértelmezés szerint 0, az alapértelmezett küldési bájtok száma pedig a bufferméretére. Ha paraméterként socketflags a DontRoute jelölőt adja meg, a küldendő adatok nem lesznek átirányítva.

A blokkoló szoftvercsatornák mindaddig blokkolva lesznek, amíg a kért összes bájtot el nem küldi a buffer rendszer. Mivel a tiltás feloldása Socket azonnal befejeződik, előfordulhat, hogy nem küldi el az összes bájtot a buffer. Az alkalmazás felelőssége, hogy nyomon kövesse az elküldött bájtok számát, és próbálkozzon újra a művelettel, amíg az alkalmazás az összes bájtot el nem küldi a bufferfájlban. Azt sem garantálja, hogy a küldött adatok azonnal megjelennek a hálózaton. A hálózati hatékonyság növelése érdekében a mögöttes rendszer késleltetheti az átvitelt, amíg jelentős mennyiségű elavult adatot nem gyűjt. A módszer sikeres végrehajtása SendTo azt jelenti, hogy a mögöttes rendszernek volt helye az adatok pufferelésére egy hálózati küldéshez.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Lásd még

A következőre érvényes:

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

A megadott számú bájtnyi adatot elküldi a megadott végpontnak a megadott SocketFlagshasználatával.

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

Paraméterek

buffer: Byte[]

Az elküldendő adatokat tartalmazó tömb Byte .

size: Int32

A küldendő bájtok száma.

socketFlags: SocketFlags

Az értékek bitenkénti kombinációja SocketFlags .

remoteEP: EndPoint

Az EndPoint adatok célhelyét jelképező hely.

Válaszok

Int32

Az elküldött bájtok száma.

Kivételek

ArgumentNullException

buffer az null.

-vagy-

remoteEP az null.

ArgumentOutOfRangeException

A megadott size érték meghaladja a méretet buffer.

SocketException

Hiba történt a szoftvercsatorna elérésekor.

ObjectDisposedException

A Socket le van zárva.

Példák

Az alábbi példakód kapcsolat nélküli datagramot küld a megadott távoli gazdagépnek. A méret, és SocketFlags a rendszer átadja a SendTo metódusnak.

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

Megjegyzések

Ebben a túlterhelésben a puffer eltolása alapértelmezés szerint 0. Ha paraméterként socketflags a DontRoute jelölőt adja meg, a küldendő adatok nem lesznek átirányítva.

A blokkoló szoftvercsatornák a kért bájtszám elküldéséig blokkolva lesznek. Mivel a letiltás feloldása Socket azonnal befejeződik, előfordulhat, hogy egyetlen műveletben nem küldi el az összes kért bájtot. Az alkalmazás felelőssége, hogy nyomon kövesse az elküldött bájtok számát, és próbálkozzon újra a művelettel, amíg az alkalmazás el nem küldi a kért bájtszámot. Azt sem garantálja, hogy a küldött adatok azonnal megjelennek a hálózaton. A hálózati hatékonyság növelése érdekében a mögöttes rendszer késleltetheti az átvitelt, amíg jelentős mennyiségű elavult adatot nem gyűjt. A módszer sikeres végrehajtása SendTo azt jelenti, hogy a mögöttes rendszernek volt helye az adatok pufferelésére egy hálózati küldéshez.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Lásd még

A következőre érvényes:

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

A megadott számú bájtnyi adatot elküldi a megadott végpontnak, a puffer megadott helyétől kezdve a megadott SocketFlagsmódon.

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

Paraméterek

buffer: Byte[]

Az elküldendő adatokat tartalmazó tömb Byte .

offset: Int32

Az a pozíció az adatpufferben, ahol megkezdheti az adatok küldését.

size: Int32

A küldendő bájtok száma.

socketFlags: SocketFlags

Az értékek bitenkénti kombinációja SocketFlags .

remoteEP: EndPoint

Az EndPoint adatok célhelyét jelképező hely.

Válaszok

Int32

Az elküldött bájtok száma.

Kivételek

ArgumentNullException

buffer az null.

-vagy-

remoteEP az null.

ArgumentOutOfRangeException

offset kisebb, mint 0.

-vagy-

offset nagyobb, mint a hossza buffer.

-vagy-

size kisebb, mint 0.

-vagy-

size nagyobb, mint a paraméter értékének bufferoffset mínusz hossza.

SocketException

socketFlags nem az értékek érvényes kombinációja.

-vagy-

Operációs rendszerhiba lép fel a Socket.

ObjectDisposedException

A Socket le van zárva.

SecurityException

A hívásverem hívói nem rendelkeznek a szükséges engedélyekkel.

Példák

Az alábbi példakód kapcsolat nélküli datagramot küld a megadott távoli gazdagépnek. Az eltolás, a méret és SocketFlags a SendTo metódusnak átadott érték.

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

Megjegyzések

Ebben a túlterhelésben, ha paraméterként socketflags a DontRoute jelölőt adja meg, a küldendő adatok nem lesznek átirányítva.

A blokkoló szoftvercsatornák a kért bájtszám elküldéséig blokkolva lesznek. Mivel a nem blokkolás Socket azonnal befejeződik, előfordulhat, hogy egyetlen műveletben nem küldi el az összes kért bájtot. Az alkalmazások feladata nyomon követni az elküldött bájtok számát, és újrapróbálkoznia a műveletet, amíg az alkalmazás el nem küldi a kért bájtszámot. Azt sem garantálja, hogy a küldött adatok azonnal megjelennek a hálózaton. A hálózati hatékonyság növelése érdekében a mögöttes rendszer késleltetheti az átvitelt, amíg jelentős mennyiségű elavult adatot nem gyűjt. A módszer sikeres végrehajtása SendTo azt jelenti, hogy a mögöttes rendszernek volt helye az adatok pufferelésére egy hálózati küldéshez.

Ha kapcsolat nélküli protokollt használ blokkoló módban, SendTo a datagram elküldéséig le lesz tiltva. Ha adatokat szeretne küldeni egy szórási címre, először hívja meg a metódust SetSocketOption , és állítsa a szoftvercsatorna beállítását a következőre SocketOptionName.Broadcast: . Azt is meg kell győződnie, hogy a méret nem haladja meg a mögöttes szolgáltató maximális csomagméretét. Ha igen, a datagram nem lesz elküldve, és SendTo egy SocketException.

Note

Ez a tag nyomkövetési adatokat ad ki, amikor engedélyezi a hálózati nyomkövetést az alkalmazásban. További információ: Network Tracing in .NET Framework.

Lásd még

A következőre érvényes:

Visszajelzés

Hasznosnak találta ezt az oldalt?