HttpWebRequest.AddRange Metoda

Definice

Obor názvů:

System.Net

Sestavení:

System.Net.Requests.dll

Přidá do požadavku hlavičku rozsahu.

Přetížení

AddRange(Int32)	Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.
AddRange(Int64)	Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.
AddRange(Int32, Int32)	Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.
AddRange(Int64, Int64)	Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.
AddRange(String, Int32)	Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.
AddRange(String, Int64)	Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.
AddRange(String, Int32, Int32)	Přidá hlavičku rozsahu do požadavku na zadaný rozsah.
AddRange(String, Int64, Int64)	Přidá hlavičku rozsahu do požadavku na zadaný rozsah.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

AddRange(Int32)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.

public:
 void AddRange(int range);

public void AddRange (int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Parametry

range

Int32

Počáteční nebo koncový bod rozsahu.

Výjimky

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Příklady

Následující příklad kódu přidá do požadavku hlavičku rozsahu.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange do požadavku přidá hlavičku rozsahu bajtů.

Pokud je range pozitivní, parametr range určuje počáteční bod rozsahu. Server by měl začít odesílat data z parametru range zadaného na konec dat v entitě HTTP.

Pokud je range záporný, parametr range určuje koncový bod oblasti. Server by měl začít odesílat data od začátku dat v entitě HTTP do zadaného parametru range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Příklad hlavičky Rozsah v požadavku protokolu HTTP, který požaduje, aby server odeslal prvních 100 bajtů (od začátku do bajtu pozice 99), by bylo následující:

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

V tomto příkladu by parametr range byl -99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(Int64)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku bajtového rozsahu do požadavku na konkrétní rozsah od začátku nebo konce požadovaných dat.

public:
 void AddRange(long range);

public void AddRange (long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Parametry

range

Int64

Počáteční nebo koncový bod rozsahu.

Výjimky

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange do požadavku přidá hlavičku rozsahu bajtů.

Pokud je range pozitivní, parametr range určuje počáteční bod rozsahu. Server by měl začít odesílat data z parametru range zadaného na konec dat v entitě HTTP.

Pokud je range záporný, parametr range určuje koncový bod oblasti. Server by měl začít odesílat data od začátku dat v entitě HTTP do zadaného parametru range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Příklad hlavičky Rozsah v požadavku protokolu HTTP, který požaduje, aby server odeslal prvních 100 bajtů (od začátku do bajtu pozice 99), by bylo následující:

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

V tomto příkladu by parametr range byl -99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(Int32, Int32)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.

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)

Parametry

from

Int32

Pozice, na které chcete začít odesílat data.

to

Int32

Pozice, ve které se mají ukončit odesílání dat.

Výjimky

ArgumentException

rangeSpecifier je neplatný.

ArgumentOutOfRangeException

from je větší než to

-nebo-

from nebo to je menší než 0.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Příklady

Následující příklad kódu přidá do požadavku hlavičku rozsahu.

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

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange do požadavku přidá hlavičku rozsahu bajtů.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr from zadán jako 0 a parametr to by byl zadán jako 99. Specifikátor rozsahu je automaticky nastaven jako "bajty" touto metodou.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(Int64, Int64)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku bajtového rozsahu do požadavku na zadanou oblast.

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)

Parametry

from

Int64

Pozice, na které chcete začít odesílat data.

to

Int64

Pozice, ve které se mají ukončit odesílání dat.

Výjimky

ArgumentException

rangeSpecifier je neplatný.

ArgumentOutOfRangeException

from je větší než to

-nebo-

from nebo to je menší než 0.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange do požadavku přidá hlavičku rozsahu bajtů.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr from zadán jako 0 a parametr to by byl zadán jako 99. Specifikátor rozsahu je automaticky nastaven jako "bajty" touto metodou.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(String, Int32)

Zdroj:

HttpWebRequest.cs

Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.

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)

Parametry

rangeSpecifier

String

Popis rozsahu.

range

Int32

Počáteční nebo koncový bod rozsahu.

Výjimky

ArgumentNullException

rangeSpecifier je null.

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange přidá do požadavku hlavičku Range.

Pokud je range pozitivní, parametr range určuje počáteční bod rozsahu. Server by měl začít odesílat data z parametru range zadaného na konec dat v entitě HTTP.

Pokud je range záporný, parametr range určuje koncový bod oblasti. Server by měl začít odesílat data od začátku dat v entitě HTTP do zadaného parametru range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Parametr rangeSpecifier by se normálně zadal jako bajty, protože se jedná o jediný specifikátor rozsahu rozpoznaný většinou serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu specifikátorů vlastního rozsahu kromě bajtů (specifikátor bajtového rozsahu definovaný v RFC 2616 pomocí IETF).

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr rangeSpecifier zadán jako bajty a parametr range by byl -99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(String, Int64)

Zdroj:

HttpWebRequest.cs

Přidá do požadavku hlavičku Rozsah od začátku nebo konce požadovaných dat.

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)

Parametry

rangeSpecifier

String

Popis rozsahu.

range

Int64

Počáteční nebo koncový bod rozsahu.

Výjimky

ArgumentNullException

rangeSpecifier je null.

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange přidá do požadavku hlavičku Range.

Pokud je range pozitivní, parametr range určuje počáteční bod rozsahu. Server by měl začít odesílat data z parametru range zadaného na konec dat v entitě HTTP.

Pokud je range záporný, parametr range určuje koncový bod oblasti. Server by měl začít odesílat data od začátku dat v entitě HTTP do zadaného parametru range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Parametr rangeSpecifier by se normálně zadal jako bajty, protože se jedná o jediný specifikátor rozsahu rozpoznaný většinou serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu specifikátorů vlastního rozsahu kromě bajtů (specifikátor bajtového rozsahu definovaný v RFC 2616 pomocí IETF).

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr rangeSpecifier zadán jako bajty a parametr range by byl -99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(String, Int32, Int32)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku rozsahu do požadavku na zadaný rozsah.

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)

Parametry

rangeSpecifier

String

Popis rozsahu.

from

Int32

Pozice, na které chcete začít odesílat data.

to

Int32

Pozice, ve které se mají ukončit odesílání dat.

Výjimky

ArgumentNullException

rangeSpecifier je null.

ArgumentOutOfRangeException

from je větší než to

-nebo-

from nebo to je menší než 0.

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange přidá do požadavku hlavičku Range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Parametr rangeSpecifier by se normálně zadal jako bajty, protože se jedná o jediný specifikátor rozsahu rozpoznaný většinou serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu specifikátorů vlastního rozsahu kromě bajtů (specifikátor bajtového rozsahu definovaný v RFC 2616 pomocí IETF).

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr rangeSpecifier zadán jako bajty, parametr from bude 0 a parametr to bude 99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Řetězec zadaný v hlavičce Accept-Ranges je specifikátor rozsahu, který by byl zadán v parametru rangeSpecifier pro tuto metodu.

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange

AddRange(String, Int64, Int64)

Zdroj:

HttpWebRequest.cs

Přidá hlavičku rozsahu do požadavku na zadaný rozsah.

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)

Parametry

rangeSpecifier

String

Popis rozsahu.

from

Int64

Pozice, na které chcete začít odesílat data.

to

Int64

Pozice, ve které se mají ukončit odesílání dat.

Výjimky

ArgumentNullException

rangeSpecifier je null.

ArgumentOutOfRangeException

from je větší než to

-nebo-

from nebo to je menší než 0.

ArgumentException

rangeSpecifier je neplatný.

InvalidOperationException

Záhlaví rozsahu nelze přidat.

Poznámky

Opatrnost

WebRequest, HttpWebRequest, ServicePointa WebClient jsou zastaralé a neměli byste je používat pro nový vývoj. Místo toho použijte HttpClient.

Metoda HttpWebRequest.AddRange přidá do požadavku hlavičku Range.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako posloupnosti bajtů, je koncept rozsahu bajtů smysluplný pro libovolnou entitu HTTP. Ne všichni klienti a servery ale potřebují podporovat operace v rozsahu bajtů.

Hlavička Range v požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou nutné pro podporu požadavků hlaviček rozsahu.

Parametr rangeSpecifier by se normálně zadal jako bajty, protože se jedná o jediný specifikátor rozsahu rozpoznaný většinou serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu specifikátorů vlastního rozsahu kromě bajtů (specifikátor bajtového rozsahu definovaný v RFC 2616 pomocí IETF).

Příkladem hlavičky Rozsah v požadavku protokolu HTTP, který požaduje prvních 100 bajtů, by bylo následující:

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

V tomto příkladu by byl parametr rangeSpecifier zadán jako bajty, parametr from bude 0 a parametr to bude 99.

Server HTTP označuje podporu hlaviček rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, by byl následující:

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

Řetězec zadaný v hlavičce Accept-Ranges je specifikátor rozsahu, který by byl zadán v parametru rangeSpecifier pro tuto metodu.

Pokud hlavička Accept-Ranges není přijata v hlavičce odpovědi ze serveru, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpozná Accept-Ranges hlavičku, by byla následující:

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

Při příjmu odpovědi z požadavku rozsahu se parsují a zpřístupní prostřednictvím vlastností třídy HttpWebResponse pouze hlavičky HTTP přidružené k celému požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.

Viz také

• AddRange