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 demande.

// 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 HttpWebRequest.AddRange méthode ajoute un en-tête de plage d’octets à la requête.

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

Si range est négatif, le range paramètre spécifie le point de fin de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au range paramètre 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 toute 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 range.

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 range paramètre est -99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges. Voici un exemple d’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 Range. Voici un exemple d’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 d’une requête de plage, seuls les en-têtes HTTP associés à l’ensemble de la requête sont analysés et mis à disposition via des propriétés sur la HttpWebResponse classe. 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 HttpWebRequest.AddRange méthode ajoute un en-tête de plage d’octets à la requête.

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

Si range est négatif, le range paramètre spécifie le point de fin de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au range paramètre 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 toute 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 range.

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 range paramètre est -99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges. Voici un exemple d’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 Range. Voici un exemple d’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 d’une requête de plage, seuls les en-têtes HTTP associés à l’ensemble de la requête sont analysés et mis à disposition via des propriétés sur la HttpWebResponse classe. 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 demande.

// 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 HttpWebRequest.AddRange méthode 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 toute 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 range.

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 from paramètre est spécifié sous la forme 0 et le to paramètre est 99. Le spécificateur de plage est automatiquement défini en tant que « octets » par cette méthode.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges. Voici un exemple d’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 Range. Voici un exemple d’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 d’une requête de plage, seuls les en-têtes HTTP associés à l’ensemble de la requête sont analysés et mis à disposition via des propriétés sur la HttpWebResponse classe. 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 HttpWebRequest.AddRange méthode 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 toute 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 from paramètre est spécifié sous la forme 0 et le to paramètre est 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 range avec l’en-tête Accept-Ranges. Voici un exemple d’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 range. Voici un exemple d’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 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 les propriétés de la HttpWebResponse classe . 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 HttpWebRequest.AddRange méthode ajoute un en-tête Range à la requête.

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

Si range est négatif, le range paramètre spécifie le point de fin de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au range paramètre 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 de plage d’octets est significatif pour toute 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 rangeSpecifier paramètre est normalement spécifié en tant que « octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. Définir le rangeSpecifier paramètre sur une autre chaîne permet 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 rangeSpecifier paramètre est spécifié en tant que « octets » et le range paramètre est -99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple d’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 range. Voici un exemple d’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 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 les propriétés de la HttpWebResponse classe . 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 HttpWebRequest.AddRange méthode ajoute un en-tête Range à la requête.

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

Si range est négatif, le range paramètre spécifie le point de fin de la plage. Le serveur doit commencer à envoyer des données à partir du début des données de l’entité HTTP au range paramètre 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 de plage d’octets est significatif pour toute 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 rangeSpecifier paramètre est normalement spécifié en tant que « octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. Définir le rangeSpecifier paramètre sur une autre chaîne permet 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 rangeSpecifier paramètre est spécifié en tant que « octets » et le range paramètre est -99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple d’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 range. Voici un exemple d’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 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 les propriétés de la HttpWebResponse classe . 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 HttpWebRequest.AddRange méthode 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 de plage d’octets est significatif pour toute 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 rangeSpecifier paramètre est normalement spécifié en tant que « octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. Définir le rangeSpecifier paramètre sur une autre chaîne permet 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 rangeSpecifier paramètre est spécifié en tant que « octets », le from paramètre est 0 et le to paramètre est 99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple d’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 par spécifié dans le rangeSpecifier paramètre 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 range. Voici un exemple d’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 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 les propriétés de la HttpWebResponse classe . 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 HttpWebRequest.AddRange méthode 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 de plage d’octets est significatif pour toute 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 rangeSpecifier paramètre est normalement spécifié en tant que « octets », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs HTTP. Définir le rangeSpecifier paramètre sur une autre chaîne permet 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 rangeSpecifier paramètre est spécifié en tant que « octets », le from paramètre est 0 et le to paramètre est 99.

Un serveur HTTP indique la prise en charge des en-têtes range avec l’en-tête Accept-Ranges dans la réponse. Voici un exemple d’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 par spécifié dans le rangeSpecifier paramètre 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 range. Voici un exemple d’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 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 les propriétés de la HttpWebResponse classe . Les en-têtes associés à chaque plage sont retournés dans la réponse.

Voir aussi

• AddRange