Socket.Shutdown(SocketShutdown) Metoda

Definice

Obor názvů:

System.Net.Sockets

Sestavení:

netstandard.dll, System.Net.Sockets.dll

Zdroj:

Socket.cs

Zakáže odesílání a přijímání na .Socket

public:
 void Shutdown(System::Net::Sockets::SocketShutdown how);

public void Shutdown(System.Net.Sockets.SocketShutdown how);

member this.Shutdown : System.Net.Sockets.SocketShutdown -> unit

Public Sub Shutdown (how As SocketShutdown)

Parametry

how

SocketShutdown

Jedna z SocketShutdown hodnot, která určuje operaci, která již nebude povolena.

Výjimky

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 používá Shutdown k zakázání Socket.

try
{
    aSocket.Shutdown(SocketShutdown.Both);
}
finally
{
    aSocket.Close();
}

    Try
        aSocket.Shutdown(SocketShutdown.Both)
    Finally
        aSocket.Close()
    End Try

End Sub

Poznámky

Při použití připojení orientované Socket, vždy volejte metodu Shutdown před zavřením Socket. Tím se zajistí, že se před uzavřením všech dat odesílají a přijímají na připojeném soketu.

Close Volání metody uvolnit všechny spravované a nespravované prostředky přidružené k Socket. Nepokoušejte se znovu použít Socket po zavření.

Následující tabulka ukazuje hodnoty výčtu SocketShutdown , které jsou platné pro how parametr.

Hodnota	Description
Poslat	Zakažte odesílání v tomto Socketsouboru .
Obdržet	Zakažte příjem tohoto Socket.
Oboje	Zakažte odesílání i příjem .Socket

Nastavení how , které Send určuje, že další volání Send nejsou povolena. Pokud používáte bez připojení Socket, Send zadání nebude mít žádný vliv.

Nastavení how , které Receive určuje, že další volání Receive nejsou povolena. To nemá žádný vliv na nižší vrstvy protokolu. Pokud používáte protokol orientovaný na připojení, připojení se ukončí, pokud po volání Shutdown některé z následujících podmínek existují:

• Data jsou v příchozí síťové vyrovnávací paměti čekající na přijetí.

• Přišlo více dat.

Pokud používáte protokol bez připojení, datagramy se přijímají a zařadí do fronty. Pokud ale není k dispozici žádné místo vyrovnávací paměti pro další příchozí datagramy, zahodí se a odesílateli se nevrátí žádná chyba. Použití Shutdown na bezpojení Socket se nedoporučuje.

Nastavení how pro Both zakázání odesílání a přijímání, jak je popsáno výše.

Poznámka:

Pokud se vám při volání Shutdown metody zobrazíSocketException, 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é

• Close()
• SocketShutdown