Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo Socket.SetSocketOption (SocketOptionLevel, SocketOptionName, Boolean)

 

Data di pubblicazione: ottobre 2016

Imposta l'oggetto specificato Socket opzione specificata Boolean valore.

Spazio dei nomi:   System.Net.Sockets
Assembly:  System (in System.dll)

public void SetSocketOption(
	SocketOptionLevel optionLevel,
	SocketOptionName optionName,
	bool optionValue
)

Parametri

optionLevel
Type: System.Net.Sockets.SocketOptionLevel

Uno dei valori di SocketOptionLevel.

optionName
Type: System.Net.Sockets.SocketOptionName

Uno dei valori di SocketOptionName.

optionValue
Type: System.Boolean

Il valore dell'opzione, rappresentato come un Boolean.

Exception Condition
ObjectDisposedException

Il Socket oggetto è stato chiuso.

SocketException

Si è verificato un errore durante il tentativo di accesso al socket. Per altre informazioni, vedere la sezione Osservazioni.

Socket opzioni determinano il comportamento dell'oggetto Socket. Impostare optionValue a true per abilitare l'opzione o false per disabilitare l'opzione.

Socket le opzioni sono raggruppate dal livello di supporto del protocollo.

Di seguito sono elencati i vari Socket Opzioni che possono essere impostate mediante questo overload. Queste opzioni vengono raggruppate i SocketOptionLevel valore. Se si intende impostare una di queste opzioni, assicurarsi di utilizzare l'oggetto appropriato SocketOptionLevel valore per il optionLevel parametro. È necessario specificare l'opzione per impostare il optionName parametro. Se si desidera ottenere il valore corrente di una delle opzioni elencate, utilizzare il GetSocketOption metodo.

SocketOptionLevel.Socket opzioni che possono essere impostate mediante questo overload.

SocketOptionLevel.IP opzioni che possono essere impostate mediante questo overload.

SocketOptionLevel.Tcp opzioni che possono essere impostate mediante questo overload.

SocketOptionLevel.Udp opzioni che possono essere impostate mediante questo overload.

Per ulteriori informazioni su queste opzioni, vedere il SocketOptionName enumerazione.

System_CAPS_noteNota

Se si riceve un SocketException eccezione, utilizzare il SocketException.ErrorCode proprietà per ottenere il codice di errore specifico. Dopo avere ottenuto il codice, fare riferimento alla versione di Windows Sockets API errore codice documentazione 2 in MSDN library per una descrizione dettagliata dell'errore.

Esempio di codice seguente consente di aprire un socket e consente la DontLinger e OutOfBandInline Opzioni del socket.

// Establish the local endpoint for the socket.
IPHostEntry ipHost = Dns.GetHostEntry(Dns.GetHostName());
IPAddress  ipAddr = ipHost.AddressList[0];
IPEndPoint ipEndPoint = new IPEndPoint(ipAddr, 11000);

// Create a TCP socket.
Socket client = new Socket(AddressFamily.InterNetwork,
    SocketType.Stream, ProtocolType.Tcp);

// Connect the socket to the remote endpoint.
client.Connect(ipEndPoint);

// Set option that allows socket to close gracefully without lingering.
client.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.DontLinger, true);

// Set option that allows socket to receive out-of-band information in the data stream.
client.SetSocketOption(SocketOptionLevel.Socket, SocketOptionName.OutOfBandInline, true);

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: