HttpWebRequest.AddRange Methode

Definitie

Naamruimte:: System.Net

Assembly:: System.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Voegt een bereikheader toe aan de aanvraag.

Overloads

Name	Description
AddRange(Int32)	Hiermee voegt u een bytebereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.
AddRange(Int64)	Hiermee voegt u een bytebereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.
AddRange(Int32, Int32)	Hiermee voegt u een bytebereikheader toe aan de aanvraag voor een opgegeven bereik.
AddRange(Int64, Int64)	Hiermee voegt u een bytebereikheader toe aan de aanvraag voor een opgegeven bereik.
AddRange(String, Int32)	Hiermee voegt u een bereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.
AddRange(String, Int64)	Hiermee voegt u een bereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.
AddRange(String, Int32, Int32)	Hiermee voegt u een bereikheader toe aan een aanvraag voor een opgegeven bereik.
AddRange(String, Int64, Int64)	Hiermee voegt u een bereikheader toe aan een aanvraag voor een opgegeven bereik.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Omdat alle HTTP-entiteiten in HTTP-berichten worden weergegeven als reeksen bytes, is het concept van een bytebereik zinvol voor elke HTTP-entiteit. Niet alle clients en servers moeten echter bytebereikbewerkingen ondersteunen.

Met de bereikheader van een aanvraag kan een client aanvragen dat deze alleen een deel van het opgegeven bereik van bytes in een HTTP-entiteit wil ontvangen. Servers zijn niet vereist voor het ondersteunen van bereikheaderaanvragen.

AddRange(Int32)

Hiermee voegt u een bytebereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.

public:
 void AddRange(int range);

public void AddRange(int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Parameters

range: Int32

Het begin- of eindpunt van het bereik.

Uitzonderingen

ArgumentException

range is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Voorbeelden

In het volgende codevoorbeeld wordt een bereikheader aan de aanvraag toegevoegd.

// 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())

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bytebereikheader aan de aanvraag toegevoegd.

Als range dit positief is, geeft de range parameter het beginpunt van het bereik aan. De server moet beginnen met het verzenden van gegevens van de range parameter die is opgegeven aan het einde van de gegevens in de HTTP-entiteit.

Als range dit een negatief getal is, geeft de range parameter het eindpunt van het bereik aan. De server moet beginnen met het verzenden van gegevens vanaf het begin van de gegevens in de HTTP-entiteit naar de range opgegeven parameter.

Een voorbeeld van een bereikheader in een HTTP-protocolaanvraag waarbij de server de eerste 100 bytes (vanaf de begin-naar-bytepositie 99) verzendt, is het volgende:

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

In dit voorbeeld is de range parameter -99.

Een HTTP-server geeft ondersteuning aan voor bereikheaders met de Accept-Ranges-header. Een voorbeeld van de Accept-Ranges header van een server die bytebereiken ondersteunt, is als volgt:

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

Als er geen Accept-Ranges header wordt ontvangen in de header van het antwoord van de server, biedt de server geen ondersteuning voor bereikheaders. Een voorbeeld van de Accept-Ranges header van een server die geen bereiken ondersteunt, maar de Accept-Ranges header herkent, is als volgt:

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

Wanneer u het antwoord van een bereikaanvraag ontvangt, worden alleen de HTTP-headers die zijn gekoppeld aan de hele aanvraag geparseerd en beschikbaar gemaakt via eigenschappen in de HttpWebResponse klasse. Headers die aan elk bereik zijn gekoppeld, worden geretourneerd in het antwoord.

Zie ook

AddRange

Van toepassing op

AddRange(Int64)

Hiermee voegt u een bytebereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.

public:
 void AddRange(long range);

public void AddRange(long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Parameters

range: Int64

Het begin- of eindpunt van het bereik.

Uitzonderingen

ArgumentException

range is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bytebereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een bereikheader in een HTTP-protocolaanvraag waarbij de server de eerste 100 bytes (vanaf de begin-naar-bytepositie 99) verzendt, is het volgende:

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

In dit voorbeeld is de range parameter -99.

Een HTTP-server geeft ondersteuning aan voor bereikheaders met de Accept-Ranges-header. Een voorbeeld van de Accept-Ranges header van een server die bytebereiken ondersteunt, is als volgt:

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

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

Zie ook

AddRange

Van toepassing op

AddRange(Int32, Int32)

Hiermee voegt u een bytebereikheader toe aan de aanvraag voor een opgegeven bereik.

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)

Parameters

from: Int32

De positie waar gegevens moeten worden verzonden.

to: Int32

De positie waarop het verzenden van gegevens wordt gestopt.

Uitzonderingen

ArgumentOutOfRangeException

from groter is dan to

– of –

from of to kleiner is dan 0.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Voorbeelden

In het volgende codevoorbeeld wordt een bereikheader aan de aanvraag toegevoegd.

      // 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()

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bytebereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld wordt de from parameter opgegeven als 0 en wordt de to parameter opgegeven als 99. De bereikaanduiding wordt automatisch door deze methode ingesteld als 'bytes'.

Een HTTP-server geeft ondersteuning aan voor bereikheaders met de Accept-Ranges-header. Een voorbeeld van de Accept-Ranges header van een server die bytebereiken ondersteunt, is als volgt:

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

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

Zie ook

AddRange

Van toepassing op

AddRange(Int64, Int64)

Hiermee voegt u een bytebereikheader toe aan de aanvraag voor een opgegeven bereik.

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)

Parameters

from: Int64

De positie waar gegevens moeten worden verzonden.

to: Int64

De positie waarop het verzenden van gegevens wordt gestopt.

Uitzonderingen

ArgumentOutOfRangeException

from groter is dan to

– of –

from of to kleiner is dan 0.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bytebereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld wordt de from parameter opgegeven als 0 en wordt de to parameter opgegeven als 99. De bereikaanduiding wordt automatisch door deze methode ingesteld als 'bytes'.

Een HTTP-server geeft ondersteuning aan voor bereikheaders met de Accept-Ranges-header. Een voorbeeld van de Accept-Ranges header van een server die bytebereiken ondersteunt, is als volgt:

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

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

Zie ook

AddRange

Van toepassing op

AddRange(String, Int32)

Hiermee voegt u een bereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.

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)

Parameters

rangeSpecifier: String

De beschrijving van het bereik.

range: Int32

Het begin- of eindpunt van het bereik.

Uitzonderingen

ArgumentNullException

rangeSpecifier is null.

ArgumentException

rangeSpecifier is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bereikheader aan de aanvraag toegevoegd.

De rangeSpecifier parameter wordt normaal gesproken opgegeven als een 'bytes', omdat dit de enige bereikaanduiding is die wordt herkend door de meeste HTTP-servers. Als u de rangeSpecifier parameter instelt op een andere tekenreeks, kunt u ondersteuning bieden voor aangepaste bereikaanduidingen anders dan bytes (de bytebereikaanduiding die is gedefinieerd in RFC 2616 door de IETF).

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld wordt de rangeSpecifier parameter opgegeven als 'bytes' en is de range parameter -99.

Een HTTP-server geeft ondersteuning aan voor Range-headers met de Accept-Ranges-header in het antwoord. Een voorbeeld van de Accept-Ranges header van een server die bytebereiken ondersteunt, is als volgt:

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

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

Zie ook

AddRange

Van toepassing op

AddRange(String, Int64)

Hiermee voegt u een bereikheader toe aan een aanvraag voor een specifiek bereik vanaf het begin of einde van de aangevraagde gegevens.

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)

Parameters

rangeSpecifier: String

De beschrijving van het bereik.

range: Int64

Het begin- of eindpunt van het bereik.

Uitzonderingen

ArgumentNullException

rangeSpecifier is null.

ArgumentException

rangeSpecifier is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld wordt de rangeSpecifier parameter opgegeven als 'bytes' en is de range parameter -99.

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

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

Zie ook

AddRange

Van toepassing op

AddRange(String, Int32, Int32)

Hiermee voegt u een bereikheader toe aan een aanvraag voor een opgegeven bereik.

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)

Parameters

rangeSpecifier: String

De beschrijving van het bereik.

from: Int32

De positie waar gegevens moeten worden verzonden.

to: Int32

De positie waarop het verzenden van gegevens wordt gestopt.

Uitzonderingen

ArgumentNullException

rangeSpecifier is null.

ArgumentOutOfRangeException

from groter is dan to

– of –

from of to kleiner is dan 0.

ArgumentException

rangeSpecifier is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld zou de rangeSpecifier parameter worden opgegeven als een 'bytes', de from parameter zou 0 zijn en de to parameter 99 zou zijn.

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

De tekenreeks die is opgegeven in de Accept-Ranges header, is de bereikaanduiding die moet worden opgegeven in de rangeSpecifier parameter voor deze methode.

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

Zie ook

AddRange

Van toepassing op

AddRange(String, Int64, Int64)

Hiermee voegt u een bereikheader toe aan een aanvraag voor een opgegeven bereik.

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)

Parameters

rangeSpecifier: String

De beschrijving van het bereik.

from: Int64

De positie waar gegevens moeten worden verzonden.

to: Int64

De positie waarop het verzenden van gegevens wordt gestopt.

Uitzonderingen

ArgumentNullException

rangeSpecifier is null.

ArgumentOutOfRangeException

from groter is dan to

– of –

from of to kleiner is dan 0.

ArgumentException

rangeSpecifier is ongeldig.

InvalidOperationException

De bereikkop kan niet worden toegevoegd.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Met HttpWebRequest.AddRange de methode wordt een bereikheader aan de aanvraag toegevoegd.

Een voorbeeld van een Bereik-header in een HTTP-protocolaanvraag die de eerste 100 bytes aanvraagt, is het volgende:

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

In dit voorbeeld zou de rangeSpecifier parameter worden opgegeven als een 'bytes', de from parameter zou 0 zijn en de to parameter 99 zou zijn.

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

De tekenreeks die is opgegeven in de Accept-Ranges header, is de bereikaanduiding die moet worden opgegeven in de rangeSpecifier parameter voor deze methode.

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

Zie ook

AddRange

Van toepassing op

Feedback

Is deze pagina nuttig?