HttpWebRequest.AddRange Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un en-tête de plage à la requête.
Surcharges
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. |
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. |
AddRange(Int32, Int32) |
Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée. |
AddRange(Int64, Int64) |
Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée. |
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. |
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. |
AddRange(String, Int32, Int32) |
Ajoute un en-tête de plage à une requête d'une plage spécifiée. |
AddRange(String, Int64, Int64) |
Ajoute un en-tête de plage à une requête d'une plage spécifiée. |
Remarques
É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 requis pour prendre en charge les demandes d’en-tête de plage.
AddRange(Int32)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
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.
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
Point de départ ou de fin de la plage.
Exceptions
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 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 requis pour prendre en charge les demandes d’en-tête de plage.
Voici un exemple d’en-tête Range dans une demande 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 à 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
S’applique à
AddRange(Int64)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
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.
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
Point de départ ou de fin de la plage.
Exceptions
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 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 requis pour prendre en charge les demandes d’en-tête de plage.
Voici un exemple d’en-tête Range dans une demande 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 à 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
S’applique à
AddRange(Int32, Int32)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
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
Position à laquelle démarrer l'envoi de données.
- to
- Int32
Position à laquelle arrêter l'envoi de données.
Exceptions
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 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 requis 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 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 à 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
S’applique à
AddRange(Int64, Int64)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
Ajoute un en-tête de plage d'octets à la requête d'une plage spécifiée.
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
Position à laquelle démarrer l'envoi de données.
- to
- Int64
Position à laquelle arrêter l'envoi de données.
Exceptions
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 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 requis 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 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 à 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
S’applique à
AddRange(String, Int32)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
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.
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
Description de la plage.
- range
- Int32
Point de départ ou de fin de la plage.
Exceptions
rangeSpecifier
a la valeur null
.
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 requis 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
S’applique à
AddRange(String, Int64)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
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.
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
Description de la plage.
- range
- Int64
Point de départ ou de fin de la plage.
Exceptions
rangeSpecifier
a la valeur null
.
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 requis 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
S’applique à
AddRange(String, Int32, Int32)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
Ajoute un en-tête de plage à une requête d'une plage spécifiée.
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
Description de la plage.
- from
- Int32
Position à laquelle démarrer l'envoi de données.
- to
- Int32
Position à laquelle arrêter l'envoi de données.
Exceptions
rangeSpecifier
a la valeur null
.
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 requis 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
S’applique à
AddRange(String, Int64, Int64)
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
- Source:
- HttpWebRequest.cs
Ajoute un en-tête de plage à une requête d'une plage spécifiée.
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
Description de la plage.
- from
- Int64
Position à laquelle démarrer l'envoi de données.
- to
- Int64
Position à laquelle arrêter l'envoi de données.
Exceptions
rangeSpecifier
a la valeur null
.
rangeSpecifier
n'est pas valide.
Impossible d’ajouter l’en-tête de plage.
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 requis 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
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour