HttpWebRequest.AddRange Metoda

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(int range);

public void AddRange (int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Parametry

Výjimky

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

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(long range);

public void AddRange (long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Parametry

Výjimky

Poznámky

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(int from, int to);

public void AddRange (int from, int to);

member this.AddRange : int * int -> unit

Public Sub AddRange (from As Integer, to As Integer)

Parametry

Výjimky

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

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(long from, long to);

public void AddRange (long from, long to);

member this.AddRange : int64 * int64 -> unit

Public Sub AddRange (from As Long, to As Long)

Parametry

Výjimky

Poznámky

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, int range);

public void AddRange (string rangeSpecifier, int range);

member this.AddRange : string * int -> unit

Public Sub AddRange (rangeSpecifier As String, range As Integer)

Parametry

Výjimky

Poznámky

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, long range);

public void AddRange (string rangeSpecifier, long range);

member this.AddRange : string * int64 -> unit

Public Sub AddRange (rangeSpecifier As String, range As Long)

Parametry

Výjimky

Poznámky

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, int from, int to);

public void AddRange (string rangeSpecifier, int from, int to);

member this.AddRange : string * int * int -> unit

Public Sub AddRange (rangeSpecifier As String, from As Integer, to As Integer)

Parametry

Výjimky

Poznámky

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

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

Zdroj:

HttpWebRequest.cs

public:
 void AddRange(System::String ^ rangeSpecifier, long from, long to);

public void AddRange (string rangeSpecifier, long from, long to);

member this.AddRange : string * int64 * int64 -> unit

Public Sub AddRange (rangeSpecifier As String, from As Long, to As Long)

Parametry

Výjimky

Poznámky

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