HttpWebRequest.AddRange HttpWebRequest.AddRange HttpWebRequest.AddRange HttpWebRequest.AddRange Method

Définition

Ajoute un en-tête de plage à la requête.Adds a range header to the request.

Surcharges

AddRange(Int32) AddRange(Int32) AddRange(Int32) AddRange(Int32)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int64) AddRange(Int64) AddRange(Int64) AddRange(Int64)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int32, Int32) AddRange(Int32, Int32) AddRange(Int32, Int32) AddRange(Int32, Int32)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.Adds a byte range header to the request for a specified range.

AddRange(Int64, Int64) AddRange(Int64, Int64) AddRange(Int64, Int64) AddRange(Int64, Int64)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.Adds a byte range header to the request for a specified range.

AddRange(String, Int32) AddRange(String, Int32) AddRange(String, Int32) AddRange(String, Int32)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int64) AddRange(String, Int64) AddRange(String, Int64) AddRange(String, Int64)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int32, Int32) AddRange(String, Int32, Int32) AddRange(String, Int32, Int32) AddRange(String, Int32, Int32)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.Adds a range header to a request for a specified range.

AddRange(String, Int64, Int64) AddRange(String, Int64, Int64) AddRange(String, Int64, Int64) AddRange(String, Int64, Int64)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.Adds a range header to a request for a specified range.

Remarques

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

AddRange(Int32) AddRange(Int32) AddRange(Int32) AddRange(Int32)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

public:
 void AddRange(int range);
public void AddRange (int range);
member this.AddRange : int -> unit
Public Sub AddRange (range As Integer)

Paramètres

range
Int32 Int32 Int32 Int32

Point de départ ou de fin de la plage.The starting or ending point of the range.

Exceptions

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Exemples

L’exemple de code suivant ajoute un en-tête de plage à la requête.The following code example adds a range header to the request.

   // 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 demande.The HttpWebRequest.AddRange method adds a byte range header to the request.

Si range est positif, le range paramètre spécifie le point de départ de la plage.If range is positive, the range parameter specifies the starting point of the range. Le serveur doit commencer à envoyer des données range à partir du paramètre spécifié jusqu’à la fin des données dans l’entité http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range est négatif, le range paramètre spécifie le point de fin de la plage.If range is negative, the range parameter specifies the ending point of the range. Le serveur doit commencer à envoyer des données depuis le début des données de l’entité http vers range le paramètre spécifié.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande au serveur d’envoyer les 100 premiers octets (de la position de début à octet 99) :An example of a Range header in an HTTP protocol request that requests the server send the first 100 bytes (from the start to byte position 99) would be the following:

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

Pour cet exemple, le range paramètre serait-99.For this example, the range parameter would be -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(Int64) AddRange(Int64) AddRange(Int64) AddRange(Int64)

Ajoute un en-tête de plage d'octets à une requête d'une plage spécifique à partir du début ou de la fin des données demandées.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

public:
 void AddRange(long range);
public void AddRange (long range);
member this.AddRange : int64 -> unit
Public Sub AddRange (range As Long)

Paramètres

range
Int64 Int64 Int64 Int64

Point de départ ou de fin de la plage.The starting or ending point of the range.

Exceptions

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage d’octets à la demande.The HttpWebRequest.AddRange method adds a byte range header to the request.

Si range est positif, le range paramètre spécifie le point de départ de la plage.If range is positive, the range parameter specifies the starting point of the range. Le serveur doit commencer à envoyer des données range à partir du paramètre spécifié jusqu’à la fin des données dans l’entité http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range est négatif, le range paramètre spécifie le point de fin de la plage.If range is negative, the range parameter specifies the ending point of the range. Le serveur doit commencer à envoyer des données depuis le début des données de l’entité http vers range le paramètre spécifié.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande au serveur d’envoyer les 100 premiers octets (de la position de début à octet 99) :An example of a Range header in an HTTP protocol request that requests the server send the first 100 bytes (from the start to byte position 99) would be the following:

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

Pour cet exemple, le range paramètre serait-99.For this example, the range parameter would be -99.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(Int32, Int32) AddRange(Int32, Int32) AddRange(Int32, Int32) AddRange(Int32, Int32)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.Adds a byte range header to the request for a specified range.

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

from
Int32 Int32 Int32 Int32

Position à laquelle démarrer l'envoi de données.The position at which to start sending data.

to
Int32 Int32 Int32 Int32

Position à laquelle arrêter l'envoi de données.The position at which to stop sending data.

Exceptions

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

from est supérieur à tofrom is greater than to

- ou --or- from ou to est inférieur à 0.from or to is less than 0.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Exemples

L’exemple de code suivant ajoute un en-tête de plage à la requête.The following code example adds a range header to the request.

   // 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 demande.The HttpWebRequest.AddRange method adds a byte range header to the request.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le from paramètre est spécifié avec la valeur 0 et to le paramètre est spécifié en tant que 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Le spécificateur de plage est défini automatiquement comme « octets » par cette méthode.The range specifier is automatically set as "bytes" by this method.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(Int64, Int64) AddRange(Int64, Int64) AddRange(Int64, Int64) AddRange(Int64, Int64)

Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.Adds a byte range header to the request for a specified range.

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

from
Int64 Int64 Int64 Int64

Position à laquelle démarrer l'envoi de données.The position at which to start sending data.

to
Int64 Int64 Int64 Int64

Position à laquelle arrêter l'envoi de données.The position at which to stop sending data.

Exceptions

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

from est supérieur à tofrom is greater than to

- ou --or- from ou to est inférieur à 0.from or to is less than 0.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage d’octets à la demande.The HttpWebRequest.AddRange method adds a byte range header to the request.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le from paramètre est spécifié avec la valeur 0 et to le paramètre est spécifié en tant que 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Le spécificateur de plage est défini automatiquement comme « octets » par cette méthode.The range specifier is automatically set as "bytes" by this method.

Un serveur HTTP indique la prise en charge des en-têtes de plage avec l’en-tête Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(String, Int32) AddRange(String, Int32) AddRange(String, Int32) AddRange(String, Int32)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

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

rangeSpecifier
String String String String

Description de la plage.The description of the range.

range
Int32 Int32 Int32 Int32

Point de départ ou de fin de la plage.The starting or ending point of the range.

Exceptions

rangeSpecifier a la valeur null.rangeSpecifier is null.

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage à la requête.The HttpWebRequest.AddRange method adds a Range header to the request.

Si range est positif, le range paramètre spécifie le point de départ de la plage.If range is positive, the range parameter specifies the starting point of the range. Le serveur doit commencer à envoyer des données range à partir du paramètre spécifié jusqu’à la fin des données dans l’entité http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range est négatif, le range paramètre spécifie le point de fin de la plage.If range is negative, the range parameter specifies the ending point of the range. Le serveur doit commencer à envoyer des données depuis le début des données de l’entité http vers range le paramètre spécifié.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Le rangeSpecifier paramètre est normalement spécifié en tant que « bytes », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. La définition rangeSpecifier du paramètre sur une autre chaîne permet la prise en charge des spécificateurs de plages personnalisées autres que bytes (le spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le rangeSpecifier paramètre est spécifié en tant que « bytes » range et le paramètre est-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -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.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(String, Int64) AddRange(String, Int64) AddRange(String, Int64) AddRange(String, Int64)

Ajoute un en-tête de plage à une requête pour une plage spécifique à partir du début ou de la fin des données demandées.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

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

rangeSpecifier
String String String String

Description de la plage.The description of the range.

range
Int64 Int64 Int64 Int64

Point de départ ou de fin de la plage.The starting or ending point of the range.

Exceptions

rangeSpecifier a la valeur null.rangeSpecifier is null.

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage à la requête.The HttpWebRequest.AddRange method adds a Range header to the request.

Si range est positif, le range paramètre spécifie le point de départ de la plage.If range is positive, the range parameter specifies the starting point of the range. Le serveur doit commencer à envoyer des données range à partir du paramètre spécifié jusqu’à la fin des données dans l’entité http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range est négatif, le range paramètre spécifie le point de fin de la plage.If range is negative, the range parameter specifies the ending point of the range. Le serveur doit commencer à envoyer des données depuis le début des données de l’entité http vers range le paramètre spécifié.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Le rangeSpecifier paramètre est normalement spécifié en tant que « bytes », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. La définition rangeSpecifier du paramètre sur une autre chaîne permet la prise en charge des spécificateurs de plages personnalisées autres que bytes (le spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le rangeSpecifier paramètre est spécifié en tant que « bytes » range et le paramètre est-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -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.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(String, Int32, Int32) AddRange(String, Int32, Int32) AddRange(String, Int32, Int32) AddRange(String, Int32, Int32)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.Adds a range header to a request for a specified range.

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

rangeSpecifier
String String String String

Description de la plage.The description of the range.

from
Int32 Int32 Int32 Int32

Position à laquelle démarrer l'envoi de données.The position at which to start sending data.

to
Int32 Int32 Int32 Int32

Position à laquelle arrêter l'envoi de données.The position at which to stop sending data.

Exceptions

rangeSpecifier a la valeur null.rangeSpecifier is null.

from est supérieur à tofrom is greater than to

- ou --or- from ou to est inférieur à 0.from or to is less than 0.

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage à la requête.The HttpWebRequest.AddRange method adds a Range header to the request.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Le rangeSpecifier paramètre est normalement spécifié en tant que « bytes », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. La définition rangeSpecifier du paramètre sur une autre chaîne permet la prise en charge des spécificateurs de plages personnalisées autres que bytes (le spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le rangeSpecifier paramètre est spécifié en tant que « bytes », from le paramètre est 0 et le to paramètre est 99.For this example, the rangeSpecifier parameter would be specified as a "bytes", the from parameter would be 0, and the to parameter would be 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.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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 rangeSpecifier paramètre pour cette méthode.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

AddRange(String, Int64, Int64) AddRange(String, Int64, Int64) AddRange(String, Int64, Int64) AddRange(String, Int64, Int64)

Ajoute un en-tête de plage à une requête d'une plage spécifiée.Adds a range header to a request for a specified range.

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

rangeSpecifier
String String String String

Description de la plage.The description of the range.

from
Int64 Int64 Int64 Int64

Position à laquelle démarrer l'envoi de données.The position at which to start sending data.

to
Int64 Int64 Int64 Int64

Position à laquelle arrêter l'envoi de données.The position at which to stop sending data.

Exceptions

from est supérieur à tofrom is greater than to

- ou --or- from ou to est inférieur à 0.from or to is less than 0.

rangeSpecifier n'est pas valide.rangeSpecifier is invalid.

Impossible d’ajouter l’en-tête de plage.The range header could not be added.

Remarques

La HttpWebRequest.AddRange méthode ajoute un en-tête de plage à la requête.The HttpWebRequest.AddRange method adds a Range header to the request.

Étant donné que toutes les entités HTTP sont représentées dans des messages HTTP sous forme de séquences d’octets, le concept d’une plage d’octets est significatif pour toute entité HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Toutefois, tous les clients et serveurs n’ont pas besoin de prendre en charge les opérations de plage d’octets.However, not all clients and servers need to support byte-range operations.

L’en-tête Range d’une requête permet à un client de demander qu’il souhaite uniquement recevoir une partie de la plage d’octets spécifiée dans une entité HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Les serveurs ne sont pas requis pour prendre en charge les demandes d’en-tête de plage.Servers are not required to support Range header requests.

Le rangeSpecifier paramètre est normalement spécifié en tant que « bytes », car il s’agit du seul spécificateur de plage reconnu par la plupart des serveurs http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. La définition rangeSpecifier du paramètre sur une autre chaîne permet la prise en charge des spécificateurs de plages personnalisées autres que bytes (le spécificateur de plage d’octets défini dans RFC 2616 par l’IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Voici un exemple d’en-tête de plage dans une requête de protocole HTTP qui demande le premier 100 octets :An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

Pour cet exemple, le rangeSpecifier paramètre est spécifié en tant que « bytes », from le paramètre est 0 et le to paramètre est 99.For this example, the rangeSpecifier parameter would be specified as a "bytes", the from parameter would be 0, and the to parameter would be 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.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui prend en charge les plages d’octets :An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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 rangeSpecifier paramètre pour cette méthode.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

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.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Voici un exemple de l’en-tête Accept-Ranges d’un serveur qui ne prend pas en charge les plages, mais qui reconnaît l’en-tête Accept-Ranges :An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

Lors de la réception de la réponse d’une demande de plage, seuls les en-têtes http associés à l’ensemble de la requête sont analysés HttpWebResponse et rendus disponibles via les propriétés de la classe.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Les en-têtes associés à chaque plage sont retournés dans la réponse.Headers associated with each range are returned in the response.

Voir aussi

S’applique à