HttpWebRequest.AddRange Méthode

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(int range);

public void AddRange (int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant ajoute un en-tête de plage à la requête.

// Create a New 'HttpWebRequest' object.
HttpWebRequest^ myHttpWebRequest1 = 
    (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest1->AddRange( 1000);
Console::WriteLine("Call AddRange(1000)");
      Console::Write("Resulting Headers: ");
      Console::WriteLine(myHttpWebRequest1->Headers);

HttpWebRequest^ myHttpWebRequest2 = 
    (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest2->AddRange(-1000);
Console::WriteLine("Call AddRange(-1000)");
      Console::Write("Resulting Headers: ");
      Console::WriteLine(myHttpWebRequest2->Headers);

// Create a New 'HttpWebRequest' object .
HttpWebRequest myHttpWebRequest1=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
myHttpWebRequest1.AddRange(1000);	
Console.WriteLine("Call AddRange(1000)");
Console.Write("Resulting Headers: ");
Console.WriteLine(myHttpWebRequest1.Headers.ToString());

// Create a New 'HttpWebRequest' object .
HttpWebRequest myHttpWebRequest2=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
myHttpWebRequest2.AddRange(-1000);	
Console.WriteLine("Call AddRange(-1000)");
Console.Write("Resulting Headers: ");
Console.WriteLine(myHttpWebRequest2.Headers.ToString());

' A New 'HttpWebRequest' object is created.
Dim myHttpWebRequest1 As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest1.AddRange(1000)
Console.WriteLine("Call AddRange(1000)")
      Console.Write("Resulting Headers: ")
      Console.WriteLine(myHttpWebRequest1.Headers.ToString())

Dim myHttpWebRequest2 As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest2.AddRange(-1000)
Console.WriteLine("Call AddRange(-1000)")
      Console.Write("Resulting Headers: ")
      Console.WriteLine(myHttpWebRequest2.Headers.ToString())

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête de plage d’octets à la requête.

Si range est positif, le paramètre range spécifie le point de départ de la plage. Le serveur doit commencer à envoyer des données à partir du paramètre range spécifié à la fin des données de l’entité HTTP.

Si range est négatif, le paramètre range spécifie le point de terminaison de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au paramètre range spécifié.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande au serveur d’envoyer les 100 premiers octets (du début à la position d’octet 99) :

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

Pour cet exemple, le paramètre range serait -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(long range);

public void AddRange (long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête de plage d’octets à la requête.

Si range est positif, le paramètre range spécifie le point de départ de la plage. Le serveur doit commencer à envoyer des données à partir du paramètre range spécifié à la fin des données de l’entité HTTP.

Si range est négatif, le paramètre range spécifie le point de terminaison de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au paramètre range spécifié.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande au serveur d’envoyer les 100 premiers octets (du début à la position d’octet 99) :

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

Pour cet exemple, le paramètre range serait -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(int from, int to);

public void AddRange (int from, int to);

member this.AddRange : int * int -> unit

Public Sub AddRange (from As Integer, to As Integer)

Paramètres

Exceptions

Exemples

L’exemple de code suivant ajoute un en-tête de plage à la requête.

// Create a New 'HttpWebRequest' object.
HttpWebRequest^ myHttpWebRequest = (HttpWebRequest^)( WebRequest::Create( "http://www.contoso.com" ) );
myHttpWebRequest->AddRange( 50, 150 );
Console::WriteLine("Call AddRange(50, 150)");
      Console::Write("Resulting Request Headers: ");
      Console::WriteLine(myHttpWebRequest->Headers);

// Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
HttpWebResponse^ myHttpWebResponse = (HttpWebResponse^)( myHttpWebRequest->GetResponse() );

// Displays the headers in the response received
Console::Write("Resulting Response Headers: ");
      Console::WriteLine(myHttpWebResponse->Headers);

// Display the contents of the page to the console.
Stream^ streamResponse = myHttpWebResponse->GetResponseStream();
StreamReader^ streamRead = gcnew StreamReader( streamResponse );
array<Char>^ readBuffer = gcnew array<Char>(256);
int count = streamRead->Read( readBuffer, 0, 256 );
Console::WriteLine( "\nThe HTML contents of the page from 50th to 150 charaters are :\n  " );
while ( count > 0 )
{
   String^ outputData = gcnew String( readBuffer,0,count );
   Console::WriteLine( outputData );
   count = streamRead->Read( readBuffer, 0, 256 );
}
streamRead->Close();
streamResponse->Close();
myHttpWebResponse->Close();

      // Create a New 'HttpWebRequest' object .
      HttpWebRequest myHttpWebRequest=(HttpWebRequest)WebRequest.Create("http://www.contoso.com");
      myHttpWebRequest.AddRange(50,150);	
      Console.WriteLine("Call AddRange(50,150)");
      Console.Write("Resulting Request Headers: ");
      Console.WriteLine(myHttpWebRequest.Headers.ToString());

      // Assign the response object of 'HttpWebRequest' to a 'HttpWebResponse' variable.
      HttpWebResponse myHttpWebResponse=(HttpWebResponse)myHttpWebRequest.GetResponse();

// Displays the headers in the response received
Console.Write("Resulting Response Headers: ");
      Console.WriteLine(myHttpWebResponse.Headers.ToString());

      // Display the contents of the page to the console.
      Stream streamResponse=myHttpWebResponse.GetResponseStream();
      StreamReader streamRead = new StreamReader( streamResponse );
      Char[] readBuffer = new Char[256];
      int count = streamRead.Read( readBuffer, 0, 256 );
      Console.WriteLine("\nThe HTML contents of the page from 50th to 150 characters are :\n  ");	
      while (count > 0)
      {
          String outputData = new String(readBuffer, 0, count);
          Console.WriteLine(outputData);
          count = streamRead.Read(readBuffer, 0, 256);
      }
      // Release the response object resources.
      streamRead.Close();
      streamResponse.Close();
      myHttpWebResponse.Close();

' A New 'HttpWebRequest' objetc is created.
Dim myHttpWebRequest As HttpWebRequest = WebRequest.Create("http://www.contoso.com")
myHttpWebRequest.AddRange(50, 150)
Console.WriteLine("Call AddRange(50, 150)")
      Console.Write("Resulting Request Headers: ")
      Console.WriteLine(myHttpWebRequest.Headers.ToString())

' The response object of 'HttpWebRequest' is assigned to a 'HttpWebResponse' variable.
Dim myHttpWebResponse As HttpWebResponse = CType(myHttpWebRequest.GetResponse(), HttpWebResponse)

' Displays the headers in the response received
Console.Write("Resulting Response Headers: ")
      Console.WriteLine(myHttpWebResponse.Headers.ToString())

' Displaying the contents of the page to the console
Dim streamResponse As Stream = myHttpWebResponse.GetResponseStream()
Dim streamRead As New StreamReader(streamResponse)
Dim readBuffer(256) As [Char]
Dim count As Integer = streamRead.Read(readBuffer, 0, 256)
Console.WriteLine(ControlChars.Cr + "The HTML contents of the page from 50th to 150 charaters are :" + ControlChars.Cr + "  ")
While count > 0
    Dim outputData As New [String](readBuffer, 0, count)
    Console.WriteLine(outputData)
    count = streamRead.Read(readBuffer, 0, 256)
End While
' Release the response object resources.
 streamRead.Close()
 streamResponse.Close()
myHttpWebResponse.Close()

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête de plage d’octets à la requête.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre from est spécifié comme 0 et le paramètre to est spécifié comme 99. Le spécificateur de plage est automatiquement défini comme « octets » par cette méthode.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(long from, long to);

public void AddRange (long from, long to);

member this.AddRange : int64 * int64 -> unit

Public Sub AddRange (from As Long, to As Long)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête de plage d’octets à la requête.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre from est spécifié comme 0 et le paramètre to est spécifié comme 99. Le spécificateur de plage est automatiquement défini comme « octets » par cette méthode.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, int range);

public void AddRange (string rangeSpecifier, int range);

member this.AddRange : string * int -> unit

Public Sub AddRange (rangeSpecifier As String, range As Integer)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête Range à la requête.

Si range est positif, le paramètre range spécifie le point de départ de la plage. Le serveur doit commencer à envoyer des données à partir du paramètre range spécifié à la fin des données de l’entité HTTP.

Si range est négatif, le paramètre range spécifie le point de terminaison de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au paramètre range spécifié.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Le paramètre rangeSpecifier serait normalement spécifié en tant qu'« octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. La définition du paramètre rangeSpecifier sur une autre chaîne autorise la prise en charge des spécificateurs de plage personnalisés autres que les octets (spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre rangeSpecifier serait spécifié sous la forme « octets » et le paramètre range serait -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, long range);

public void AddRange (string rangeSpecifier, long range);

member this.AddRange : string * int64 -> unit

Public Sub AddRange (rangeSpecifier As String, range As Long)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête Range à la requête.

Si range est positif, le paramètre range spécifie le point de départ de la plage. Le serveur doit commencer à envoyer des données à partir du paramètre range spécifié à la fin des données de l’entité HTTP.

Si range est négatif, le paramètre range spécifie le point de terminaison de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au paramètre range spécifié.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Le paramètre rangeSpecifier serait normalement spécifié en tant qu'« octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. La définition du paramètre rangeSpecifier sur une autre chaîne autorise la prise en charge des spécificateurs de plage personnalisés autres que les octets (spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre rangeSpecifier serait spécifié sous la forme « octets » et le paramètre range serait -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, int from, int to);

public void AddRange (string rangeSpecifier, int from, int to);

member this.AddRange : string * int * int -> unit

Public Sub AddRange (rangeSpecifier As String, from As Integer, to As Integer)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête Range à la requête.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Le paramètre rangeSpecifier serait normalement spécifié en tant qu'« octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. La définition du paramètre rangeSpecifier sur une autre chaîne autorise la prise en charge des spécificateurs de plage personnalisés autres que les octets (spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre rangeSpecifier serait spécifié sous la forme d’un « octets », le paramètre from serait 0 et le paramètre to serait 99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

La chaîne spécifiée dans l’en-tête Accept-Ranges est le spécificateur de plage qui serait spécifié dans le paramètre rangeSpecifier pour cette méthode.

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

Source:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, long from, long to);

public void AddRange (string rangeSpecifier, long from, long to);

member this.AddRange : string * int64 * int64 -> unit

Public Sub AddRange (rangeSpecifier As String, from As Long, to As Long)

Paramètres

Exceptions

Remarques

La méthode HttpWebRequest.AddRange ajoute un en-tête Range à la requête.

Étant donné que toutes les entités HTTP sont représentées dans les messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour n’importe quelle entité HTTP. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.

L’en-tête Range d’une requête permet à un client de demander qu’il ne souhaite recevoir qu’une partie de la plage d’octets spécifiée dans une entité HTTP. Les serveurs ne sont pas nécessaires pour prendre en charge les demandes d’en-tête de plage.

Le paramètre rangeSpecifier serait normalement spécifié en tant qu'« octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. La définition du paramètre rangeSpecifier sur une autre chaîne autorise la prise en charge des spécificateurs de plage personnalisés autres que les octets (spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).

Voici un exemple d’en-tête range dans une requête de protocole HTTP qui demande les 100 premiers octets :

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

Pour cet exemple, le paramètre rangeSpecifier serait spécifié sous la forme d’un « octets », le paramètre from serait 0 et le paramètre to serait 99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :

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

La chaîne spécifiée dans l’en-tête Accept-Ranges est le spécificateur de plage qui serait spécifié dans le paramètre rangeSpecifier pour cette méthode.

Si un en-tête Accept-Ranges n’est pas reçu dans l’en-tête de la réponse du serveur, le serveur ne prend pas en charge les en-têtes de plage. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais reconnaît l’en-tête Accept-Ranges :

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

Lors de la réception de la réponse à partir d’une requête de plage, seuls les en-têtes HTTP associés à la requête entière sont analysés et rendus disponibles via des propriétés sur la classe HttpWebResponse. Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange