Opzioni di configurazione del runtime per la rete

Protocollo HTTP/2

• Configura se il supporto per il protocollo HTTP/2 è abilitato.
• Se si omette questa impostazione, il supporto per il protocollo HTTP/2 è abilitato. Equivale a impostare il valore su true.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Protocollo HTTP/3

• A partire da .NET 7, HTTP/3 è abilitato per impostazione predefinita.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Creazione del nome SPN in HttpClient (.NET 6 e versioni successive)

• Influisce sulla generazione di nomi dell'entità servizio (SPN) per l'autenticazione Kerberos e NTLM quando Host l'intestazione è mancante e la destinazione non è in esecuzione sulla porta predefinita.
• .NET 6 e versioni successive non includono la porta nel nome SPN per impostazione predefinita. Tuttavia, il comportamento è configurabile.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Ridimensionamento delle finestre dinamiche HTTP/2

• Configura se l'algoritmo di ridimensionamento delle finestre dinamiche HTTP/2 è disabilitato per il controllo del flusso. L'algoritmo è abilitato per impostazione predefinita.
• Se impostato su true, l'algoritmo di ridimensionamento delle finestre dinamiche è disabilitato.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Dimensioni della finestra di ricezione del flusso HTTP/2

• Configura le dimensioni massime della finestra di ricezione del flusso HTTP/2.
• Il valore predefinito è 16 MB. I valori inferiori a 65.535 sono bloccati a 65.535. Non esiste un limite massimo rigido, ma l'aumento di questa impostazione oltre l'impostazione predefinita è utile solo per le reti con velocità effettiva elevata e latenza elevata.

Soglia di scalabilità della finestra di flusso HTTP/2

• Configura il moltiplicatore che controlla l'aumento aggressivo della finestra di ricezione del flusso HTTP/2. I valori più elevati comportano una crescita più conservativa della finestra, riducendo così la velocità effettiva massima.
• Il valore predefinito è 1.0. I valori inferiori a 0 vengono reimpostati sul valore predefinito. Non esiste un limite massimo rigido, ma i valori superano progressivamente la velocità effettiva predefinita per richiesta.

Propagazione dell'attività HTTP

Configura se la propagazione dell'attività di traccia distribuita è abilitata per HttpClient. Se abilitata, le richieste HTTP in uscita propagano le intestazioni del contesto di traccia (ad esempio traceparent) per strumenti di traccia distribuiti come OpenTelemetry.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Timeout di connessione in sospeso al completamento della richiesta

Configura il timeout (in millisecondi) per il completamento di un tentativo di connessione in sospeso al termine della richiesta HTTP di avvio. Quando una connessione viene ancora stabilita dopo il completamento della richiesta, questo timeout determina quanto tempo attendere prima di abbandonare il tentativo di connessione.

• Il valore predefinito è 5000 (5 secondi).
• Impostare su per -1 attendere a tempo indeterminato fino al completamento della connessione.
• Impostare su 0 per annullare la connessione in sospeso immediatamente al termine della richiesta.
• Non esiste un limite massimo rigido, ma valori molto grandi sono poco pratici.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Preautenticazione proxy

Se abilitata, SocketsHttpHandler invia Basic in modo proattivo le credenziali di autenticazione proxy alla prima richiesta invece di attendere una 407 risposta di richiesta dal proxy. Ciò è utile per i proxy che non inviano 407 risposte di richiesta.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Numero massimo di connessioni per server

Configura il numero massimo di connessioni TCP simultanee che SocketsHttpHandler si apre a un singolo server. Il gestore ignora i valori minori di 1 e usa il valore predefinito.

• Il valore predefinito è illimitato (int.MaxValue).

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Completamenti inline del socket

Configura se le continuazioni socket possono essere eseguite nel thread dell'evento invece di essere inviate a System.Threading.ThreadPool. L'abilitazione di questa impostazione può migliorare le prestazioni in alcuni scenari. Tuttavia, potrebbe peggiorare le prestazioni se il lavoro diSpendioso contiene il thread di I/O per più tempo del necessario.

Conteggio thread socket

Configura il numero di thread usati per l'I/O socket. Se non ne viene eseguito l'override, il valore viene calcolato in base al numero di processori e all'architettura. I valori pratici si trovano nell'intervallo [1, ProcessorCount]. I valori al di fuori di questo intervallo non vengono rifiutati, ma è improbabile che migliorino le prestazioni.

IPv6

Configura se Internet Protocol versione 6 (IPv6) è disabilitato.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Ripresa della sessione TLS

Controllare se la ripresa della sessione TLS disabilita la ripresa della sessione TLS per SslStream. La ripresa della sessione consente alle riconnessioni TLS di ignorare un handshake completo riutilizzando i parametri di sessione negoziati in precedenza, riducendo la latenza.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Download aiA del server

Se abilitato, il client TLS scarica automaticamente i certificati intermedi dagli URL dell'estensione AIA (Authority Information Access) nei certificati server. Ciò consente al client di compilare una catena di certificati completa anche quando il server non invia la catena completa.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Memorizzazione nella cache della configurazione QUIC

Disabilita la memorizzazione nella cache degli oggetti di configurazione MsQuic. Se abilitata (impostazione predefinita), il sistema memorizza nella cache e riutilizza gli oggetti di configurazione tra le connessioni, riducendo il sovraccarico della configurazione TLS e QUIC per le connessioni ripetute con gli stessi parametri.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

MsQuic locale dell'app (Windows)

Se abilitata, l'implementazione QUIC usa la libreria MsQuic dalla directory dell'applicazione anziché la libreria fornita dal sistema in bundle con l'assembly .NET.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.

Buffer delle risposte del kernel HttpListener (Windows)

Se abilitata, HttpListener memorizza nel buffer i dati di risposta nel kernel tramite HTTP.sys. Il buffering del kernel può migliorare significativamente la velocità effettiva rispetto alle connessioni a latenza elevata per le applicazioni che usano operazioni di I/O sincrone o I/O asincrone con al massimo una scrittura in sospeso alla volta. Non abilitare questa impostazione per le applicazioni con più scritture in sospeso simultanee.

Questa impostazione di configurazione non ha una proprietà MSBuild specifica. È tuttavia possibile aggiungere un elemento MSBuild RuntimeHostConfigurationOption in alternativa. Usare il nome dell'impostazione runtimeconfig.json come valore dell'attributo Include. Per un esempio, vedere Proprietà di MSBuild.