Socket.Receive Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Přijímá data z vázaného Socketobjektu .

Přetížení

Name	Description
Receive(Byte[], Int32, Int32, SocketFlags, SocketError)	Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(Span<Byte>, SocketFlags, SocketError)	Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(IList<ArraySegment<Byte>>, SocketFlags, SocketError)	Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu pomocí zadaného SocketFlags.
Receive(Byte[], Int32, SocketFlags)	Přijme zadaný počet bajtů dat z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(Span<Byte>, SocketFlags)	Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(Byte[], Int32, Int32, SocketFlags)	Přijme zadaný počet bajtů z vazby Socket do zadané pozice posunu vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(Byte[], SocketFlags)	Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.
Receive(Span<Byte>)	Přijímá data z vazby Socket do vyrovnávací paměti pro příjem.
Receive(IList<ArraySegment<Byte>>)	Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu.
Receive(Byte[])	Přijímá data z vazby Socket do vyrovnávací paměti pro příjem.
Receive(IList<ArraySegment<Byte>>, SocketFlags)	Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu pomocí zadaného SocketFlags.

Receive(Byte[], Int32, Int32, SocketFlags, SocketError)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

public:
 int Receive(cli::array <System::Byte> ^ buffer, int offset, int size, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive(byte[] buffer, int offset, int size, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : byte[] * int * int * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parametry

buffer

Byte[]

Pole typu Byte , které je umístěním úložiště pro přijatá data.

offset

Int32

Pozice v parametru buffer pro uložení přijatých dat.

size

Int32

Počet bajtů, které se mají přijmout.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

errorCode

SocketError

Objekt SocketError , který ukládá chybu soketu.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset je menší než 0.

nebo

offset je větší než délka buffer.

nebo

size je menší než 0.

nebo

size je větší než délka buffer minus hodnota parametru offset .

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Při pokusu o přístup k soketu došlo k chybě. Viz poznámky níže. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do počtu bajtů určených parametrem velikosti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Span<Byte>, SocketFlags, SocketError)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive(Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parametry

buffer

Span<Byte>

Rozsah bajtů, který je umístěním úložiště pro přijatá data.

socketFlags

SocketFlags

Bitová kombinace hodnot výčtu, která určuje chování při odesílání a příjmu.

errorCode

SocketError

Když tato metoda vrátí, obsahuje jednu z hodnot výčtu, která definuje kódy chyb pro soket.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti pro příjem. Posun vyrovnávací paměti je výchozí na 0, výchozí velikost na délku parametru vyrovnávací paměti a SocketFlags hodnota je výchozí None.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Při překročení hodnoty časového limitu Receive volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(IList<ArraySegment<Byte>>, SocketFlags, SocketError)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu pomocí zadaného SocketFlags.

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags, [Runtime::InteropServices::Out] System::Net::Sockets::SocketError % errorCode);

public int Receive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags, out System.Net.Sockets.SocketError errorCode);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags * SocketError -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags, ByRef errorCode As SocketError) As Integer

Parametry

buffers

IList<ArraySegment<Byte>>

Seznam ArraySegment<T>typů Byte , které obsahují přijatá data.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

errorCode

SocketError

Objekt SocketError , který ukládá chybu soketu.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffers je null.

nebo

buffers. Počet je nula.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

Poznámky

Tato metoda načte data do parametru buffers a vrátí počet bajtů, které byly úspěšně přečteny. Můžete volat ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje poskytnutí jedné nebo více vyrovnávacích pamětí příjmu. Výchozí SocketFlags hodnota Noneje .

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí z připojení vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy,Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffers , buffers vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Byte[], Int32, SocketFlags)

Zdroj:

Socket.cs

Přijme zadaný počet bajtů dat z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

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

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

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

Public Function Receive (buffer As Byte(), size As Integer, socketFlags As SocketFlags) As Integer

Parametry

buffer

Byte[]

Pole typu Byte , které je umístěním úložiště pro přijatá data.

size

Int32

Počet bajtů, které se mají přijmout.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

size překračuje velikost buffer.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Příklady

Následující příkaz obdrží data nalezená v buffersouboru , a určuje None pro SocketFlags.

// Receive the host home page content and loop until all the data is received.
Int32 bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
strRetPage = "Default HTML page on " + server + ":\r\n";
strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);

while (bytes > 0)
{
  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0);
  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes);
}

' Receive the host home page content and loop until all the data is received.

'Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)
Dim bytes As Int32 = s.Receive(RecvBytes, RecvBytes.Length, 0)

strRetPage = "Default HTML page on " + server + ":\r\n"
strRetPage = "Default HTML page on " + server + ":" + ControlChars.Lf + ControlChars.NewLine

Dim i As Integer

While bytes > 0

  bytes = s.Receive(RecvBytes, RecvBytes.Length, 0)

  strRetPage = strRetPage + ASCII.GetString(RecvBytes, 0, bytes)

End While

Poznámky

Metoda Receive načte data do parametru buffer a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti pro příjem, počet bajtů, které chcete přijmout, a nezbytné SocketFlags.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do počtu bajtů určených parametrem size . Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Span<Byte>, SocketFlags)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

public:
 int Receive(Span<System::Byte> buffer, System::Net::Sockets::SocketFlags socketFlags);

public int Receive(Span<byte> buffer, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : Span<byte> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffer As Span(Of Byte), socketFlags As SocketFlags) As Integer

Parametry

buffer

Span<Byte>

Rozsah bajtů, který je umístěním úložiště pro přijatá data.

socketFlags

SocketFlags

Bitová kombinace hodnot výčtu, která určuje chování při odesílání a příjmu.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti pro příjem. Posun vyrovnávací paměti je výchozí na 0, výchozí velikost na délku parametru vyrovnávací paměti a SocketFlags hodnota je výchozí None.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Při překročení hodnoty časového limitu Receive volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní se první částí zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Byte[], Int32, Int32, SocketFlags)

Zdroj:

Socket.cs

Přijme zadaný počet bajtů z vazby Socket do zadané pozice posunu vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

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

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

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

Public Function Receive (buffer As Byte(), offset As Integer, size As Integer, socketFlags As SocketFlags) As Integer

Parametry

buffer

Byte[]

Pole typu Byte , které je umístěním úložiště pro přijatá data.

offset

Int32

Umístění buffer pro uložení přijatých dat.

size

Int32

Počet bajtů, které se mají přijmout.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffer je null.

ArgumentOutOfRangeException

offset je menší než 0.

nebo

offset je větší než délka buffer.

nebo

size je menší než 0.

nebo

size je větší než délka buffer minus hodnota parametru offset .

SocketException

socketFlags není platná kombinace hodnot.

nebo

Vlastnost LocalEndPoint nebyla nastavena.

nebo

Při přístupu k systému dojde k chybě operačního Socketsystému .

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Příklady

Následující příklad kódu určuje vyrovnávací paměť dat, posun, velikost a příznak soketu před příjmem dat na připojeném Socket.

// Displays sending with a connected socket
// using the overload that takes a buffer, offset, message size, and socket flags.
public static int SendReceiveTest4(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, 0, msg.Length, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, 0, bytes.Length, SocketFlags.None);

        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes, 0, byteCount));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer, offset, message size, and socket flags.
Public Shared Function SendReceiveTest4(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, 0, msg.Length, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, 0, server.Available, SocketFlags.None)
        
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest4

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Při pokusu o přístup k soketu došlo k chybě. Viz poznámky níže. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do počtu bajtů určených parametrem velikosti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Byte[], SocketFlags)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti příjmu pomocí zadaného SocketFlags.

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

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

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

Public Function Receive (buffer As Byte(), socketFlags As SocketFlags) As Integer

Parametry

buffer

Byte[]

Pole typu Byte , které je umístěním úložiště pro přijatá data.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffer je null.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Příklady

Následující příklad kódu určuje vyrovnávací paměť dat a SocketFlags pro příjem dat v připojené Socket.

// Displays sending with a connected socket
// using the overload that takes a buffer and socket flags.
public static int SendReceiveTest2(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int byteCount = server.Send(msg, SocketFlags.None);
        Console.WriteLine("Sent {0} bytes.", byteCount);

        // Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None);
        if (byteCount > 0)
            Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer and socket flags.
Public Shared Function SendReceiveTest2(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim byteCount As Integer = server.Send(msg, SocketFlags.None)
        Console.WriteLine("Sent {0} bytes.", byteCount)
        
        ' Get reply from the server.
        byteCount = server.Receive(bytes, SocketFlags.None)
        If byteCount > 0 Then
            Console.WriteLine(Encoding.UTF8.GetString(bytes))
        End If
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest2

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti příjmu a nezbytné SocketFlags. Posun vyrovnávací paměti se standardně nastaví na 0 a velikost se ve výchozím nastavení nastaví na délku parametru bajtu.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda zablokuje, Receive dokud nebudou k dispozici data. Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první výčet datagramu z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(Span<Byte>)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti pro příjem.

public:
 int Receive(Span<System::Byte> buffer);

public int Receive(Span<byte> buffer);

member this.Receive : Span<byte> -> int

Public Function Receive (buffer As Span(Of Byte)) As Integer

Parametry

buffer

Span<Byte>

Rozsah bajtů, který je umístěním úložiště pro přijatá data.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti pro příjem. Posun vyrovnávací paměti je výchozí na 0, výchozí velikost na délku parametru vyrovnávací paměti a SocketFlags hodnota je výchozí None.

Pokud používáte protokol orientovaný na připojení, musíte buď volat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Při překročení hodnoty časového limitu Receive volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní se první částí zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(IList<ArraySegment<Byte>>)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu.

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers);

public int Receive(System.Collections.Generic.IList<ArraySegment<byte>> buffers);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte))) As Integer

Parametry

buffers

IList<ArraySegment<Byte>>

Seznam ArraySegment<T>typů Byte , které obsahují přijatá data.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

Parametr buffers je null.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

Poznámky

Tato metoda načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje poskytnutí jedné nebo více vyrovnávacích pamětí příjmu.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí z připojení vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první výčet datagramu z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffers , buffers vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Receive(Byte[])

Zdroj:

Socket.cs

Přijímá data z vazby Socket do vyrovnávací paměti pro příjem.

public:
 int Receive(cli::array <System::Byte> ^ buffer);

public int Receive(byte[] buffer);

member this.Receive : byte[] -> int

Public Function Receive (buffer As Byte()) As Integer

Parametry

buffer

Byte[]

Pole typu Byte , které je umístěním úložiště pro přijatá data.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffer je null.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

SecurityException

Volající v zásobníku volání nemá požadovaná oprávnění.

Příklady

Následující příklad kódu přijímá data na připojeném Socket.

// Displays sending with a connected socket
// using the overload that takes a buffer.
public static int SendReceiveTest1(Socket server)
{
    byte[] msg = Encoding.UTF8.GetBytes("This is a test");
    byte[] bytes = new byte[256];
    try
    {
        // Blocks until send returns.
        int i = server.Send(msg);
        Console.WriteLine("Sent {0} bytes.", i);

        // Get reply from the server.
        i = server.Receive(bytes);
        Console.WriteLine(Encoding.UTF8.GetString(bytes));
    }
    catch (SocketException e)
    {
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode);
        return (e.ErrorCode);
    }
    return 0;
}

' Displays sending with a connected socket
' using the overload that takes a buffer.
Public Shared Function SendReceiveTest1(ByVal server As Socket) As Integer 
    Dim msg As Byte() = Encoding.UTF8.GetBytes("This is a test")
    Dim bytes(255) As Byte
    Try
        ' Blocks until send returns.
        Dim i As Integer = server.Send(msg)
        Console.WriteLine("Sent {0} bytes.", i)
        
        ' Get reply from the server.
        i = server.Receive(bytes)
        Console.WriteLine(Encoding.UTF8.GetString(bytes))
    Catch e As SocketException
        Console.WriteLine("{0} Error code: {1}.", e.Message, e.ErrorCode)
        Return e.ErrorCode
    End Try
    Return 0

End Function 'SendReceiveTest1

Poznámky

Metoda Receive načte data do parametru vyrovnávací paměti a vrátí počet bajtů úspěšně přečtených. Můžete volat Receive ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje pouze poskytnutí vyrovnávací paměti pro příjem. Posun vyrovnávací paměti je výchozí na 0, výchozí velikost na délku parametru vyrovnávací paměti a SocketFlags hodnota je výchozí None.

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí ze vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první datagram zařazený do fronty z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffer , buffer vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()

Receive(IList<ArraySegment<Byte>>, SocketFlags)

Zdroj:

Socket.cs

Přijímá data z vazby Socket do seznamu vyrovnávacích pamětí příjmu pomocí zadaného SocketFlags.

public:
 int Receive(System::Collections::Generic::IList<ArraySegment<System::Byte>> ^ buffers, System::Net::Sockets::SocketFlags socketFlags);

public int Receive(System.Collections.Generic.IList<ArraySegment<byte>> buffers, System.Net.Sockets.SocketFlags socketFlags);

member this.Receive : System.Collections.Generic.IList<ArraySegment<byte>> * System.Net.Sockets.SocketFlags -> int

Public Function Receive (buffers As IList(Of ArraySegment(Of Byte)), socketFlags As SocketFlags) As Integer

Parametry

buffers

IList<ArraySegment<Byte>>

Seznam ArraySegment<T>typů Byte , které obsahují přijatá data.

socketFlags

SocketFlags

Bitové kombinace SocketFlags hodnot.

Návraty

Int32

Celkový počet přijatých bajtů Metoda vrátí nulu (0), pouze pokud byly požadovány nulové bajty nebo pokud nejsou k dispozici žádné další bajty, protože peer socket provedl řádné vypnutí.

Výjimky

ArgumentNullException

buffers je null.

nebo

buffers. Počet je nula.

SocketException

Při pokusu o přístup k soketu došlo k chybě.

ObjectDisposedException

Ta Socket byla uzavřena.

Příklady

Následující příklad kódu ukazuje, jak přijímat data na připojeném Socket.

// Build the buffers for the receive.
List<ArraySegment<byte>> recvBuffers =
                         new List<ArraySegment<byte>>(2);

byte[] bigBuffer = new byte[1024];

// Specify the first buffer segment (2 bytes, starting
// at the 4th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 4, 2));

// Specify the second buffer segment (500 bytes, starting
// at the 20th element of bigBuffer)
recvBuffers.Add(new ArraySegment<byte>(bigBuffer, 20, 500));

int bytesReceived = mySocket.Receive(recvBuffers);

Console.WriteLine("{0}", ASCII.GetString(bigBuffer));

Poznámky

Tato metoda načte data do parametru buffers a vrátí počet bajtů, které byly úspěšně přečteny. Můžete volat ze soketů orientovaných na připojení i bez připojení.

Toto přetížení vyžaduje poskytnutí jedné nebo více vyrovnávacích pamětí příjmu. Výchozí SocketFlags hodnota Noneje .

Pokud používáte protokol orientovaný na připojení, musíte buď zavolat Connect navázat připojení ke vzdálenému hostiteli, nebo Accept přijmout příchozí připojení před voláním Receive. Metoda Receive bude číst pouze data, která přicházejí z připojení vzdáleného hostitele vytvořeného v metoděConnect.Accept Pokud používáte protokol bez připojení, můžete také použít metodu ReceiveFrom . ReceiveFrom vám umožní přijímat data přicházející z libovolného hostitele.

Pokud nejsou k dispozici žádná data pro čtení, metoda bude blokovat, Receive dokud nebudou k dispozici data, pokud nebyla nastavena hodnota časového limitu pomocí Socket.ReceiveTimeout. Pokud byla překročena hodnota časového limitu Receive , volání vyvolá SocketExceptionchybu . Pokud jste v neblokovacím režimu a v vyrovnávací paměti zásobníku protokolu nejsou k dispozici žádná data, Receive metoda se okamžitě dokončí a vyvolá SocketException. Pomocí vlastnosti můžete Available určit, jestli jsou data k dispozici pro čtení. Pokud Available není nula, zkuste operaci příjmu zopakovat.

Pokud používáte připojení orientované Socketna připojení, Receive metoda bude číst tolik dat, kolik je k dispozici, až do velikosti vyrovnávací paměti. Pokud vzdálený hostitel vypne Socket připojení s metodou Shutdown a všechna dostupná data byla přijata, Receive metoda se okamžitě dokončí a vrátí nulové bajty.

Pokud používáte bez připojení Socket, přečte první výčet datagramu z cílové adresy, Receive kterou zadáte v Connect metodě. Pokud je datagram, který obdržíte, větší než velikost parametru buffers , buffers vyplní první část zprávy, dojde ke ztrátě nadbytečných dat a SocketException vyvolá se.

Poznámka:

Pokud se zobrazí kód SocketExceptionchyby, použijte SocketException.ErrorCode vlastnost k získání konkrétního kódu chyby. Po získání tohoto kódu si přečtěte dokumentaci k chybě rozhraní API rozhraní WINDOWS Sockets verze 2 , kde najdete podrobný popis chyby.

Poznámka:

Tento člen vypíše informace o trasování, když ve své aplikaci povolíte trasování sítě. Další informace naleznete v tématu Trasování sítě v rozhraní .NET Framework.

Viz také

• Connect(EndPoint)
• ReceiveFrom(Byte[], Int32, Int32, SocketFlags, EndPoint)
• Available
• Shutdown(SocketShutdown)
• Close()