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 HttpWebRequest.AddRange (String, Int64)

.NET Framework (current version)
 

Data di pubblicazione: ottobre 2016

Aggiunge un'intestazione relativa all'intervallo a una richiesta per un intervallo specifico, a partire dall'inizio o dalla fine dei dati richiesti.

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

public void AddRange(
	string rangeSpecifier,
	long range
)

Parametri

rangeSpecifier
Type: System.String

Descrizione dell'intervallo.

range
Type: System.Int64

Punto iniziale o finale dell'intervallo.

Exception Condition
ArgumentNullException

rangeSpecifier è null.

ArgumentException

rangeSpecifier non è valido.

InvalidOperationException

Non è stato possibile aggiungere l'intestazione di intervallo.

Il HttpWebRequest.AddRange metodo aggiunge un'intestazione di intervallo alla richiesta.

Se range è positivo, il range parametro specifica il punto iniziale dell'intervallo. Il server dovrebbe iniziare l'invio di dati dal range parametro specificato alla fine dei dati dell'entità HTTP.

Se range è negativo, il range parametro specifica il punto finale dell'intervallo. Il server dovrebbe iniziare l'invio di dati dall'inizio dei dati dell'entità HTTP per il range parametro specificato.

Poiché tutte le entità HTTP sono rappresentate nei messaggi HTTP come sequenze di byte, il concetto di un intervallo di byte è significativo per qualsiasi entità HTTP. Tuttavia, non tutti i client e server necessari supportare l'intervallo di byte.

L'intestazione Range in una richiesta consente al client richiedere che desidera ricevere solo alcune parti dell'intervallo specificato di byte in un'entità HTTP. Non sono necessari server per supportare le richieste di intestazione di intervallo.

Il rangeSpecifier verrebbe in genere essere specificato come "byte", poiché questo è l'unico identificatore di intervallo riconosciuto dalla maggior parte dei server HTTP. L'impostazione di rangeSpecifier parametro a un'altra stringa consente il supporto per gli identificatori di intervallo personalizzata diverso da byte (l'identificatore di intervallo di byte definito in RFC 2616 da IETF).

Un esempio di un'intestazione di intervallo in una richiesta di protocollo HTTP che le richieste dei primi 100 byte potrebbe essere il seguente:

Range: bytes=-99\r\n\r\n

Per questo esempio, il rangeSpecifier parametro sarebbe specificato come "byte" e il range parametro sarebbe -99.

Un server HTTP indica il supporto per le intestazioni Range con l'intestazione Accept-Ranges nella risposta. Un esempio di intestazione Accept-Ranges da un server che supporta gli intervalli di byte sarebbe come segue:

Accept-Ranges: bytes\r\n\r\n

Se un'intestazione Accept-Ranges non viene ricevuta nell'intestazione della risposta dal server, il server non supporta le intestazioni Range. Un esempio dell'intestazione Accept-Ranges da un server che non supporta gli intervalli, ma riconosce l'intestazione Accept-Ranges, sarebbe come segue:

Accept-Ranges: none\r\n\r\n

Quando si riceve la risposta da una richiesta di intervallo, solo le intestazioni HTTP associate alla richiesta intera vengono analizzate e rese disponibili tramite la proprietà di HttpWebResponse (classe). Le intestazioni associate a ogni intervallo vengono restituite nella risposta.

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