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 přidá do požadavku hlavičku rozsahu bajtů.

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

Pokud range je záporná, range parametr 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Příklad hlavičky Range v požadavku protokolu HTTP, který požaduje, aby server odeslal prvních 100 bajtů (od počáteční do pozice 99), by byl 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 pomocí hlavičky 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 přidá do požadavku hlavičku rozsahu bajtů.

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

Pokud range je záporná, range parametr 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Příklad hlavičky Range v požadavku protokolu HTTP, který požaduje, aby server odeslal prvních 100 bajtů (od počáteční do pozice 99), by byl 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 pomocí hlavičky 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 přidá do požadavku hlavičku rozsahu bajtů.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

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

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

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

Server HTTP označuje podporu hlaviček rozsahu pomocí hlavičky 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 přidá do požadavku hlavičku rozsahu bajtů.

Vzhledem k tomu, že všechny entity HTTP jsou ve zprávách HTTP reprezentovány jako sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

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

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

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

Server HTTP označuje podporu hlaviček rozsahu pomocí hlavičky 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 range je hodnota kladná, range parametr určuje počáteční bod oblasti. Server by měl začít odesílat data ze zadaného range parametru na konec dat v entitě HTTP.

Pokud range je záporná, range parametr 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Parametr rangeSpecifier by se normálně zadal jako "bajty", protože je to jediný specifikátor rozsahu, který rozpozná většina serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu vlastních specifikátorů rozsahu jiných než bajtů (specifikátor rozsahu bajtů definovaný v DOKUMENTU RFC 2616 pomocí IETF).

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

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

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

Server HTTP označuje podporu hlaviček rozsahu 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 range je hodnota kladná, range parametr určuje počáteční bod oblasti. Server by měl začít odesílat data ze zadaného range parametru na konec dat v entitě HTTP.

Pokud range je záporná, range parametr 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Parametr rangeSpecifier by se normálně zadal jako "bajty", protože je to jediný specifikátor rozsahu, který rozpozná většina serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu vlastních specifikátorů rozsahu jiných než bajtů (specifikátor rozsahu bajtů definovaný v DOKUMENTU RFC 2616 pomocí IETF).

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

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

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

Server HTTP označuje podporu hlaviček rozsahu 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 v hlavičce odpovědi ze serveru není v hlavičce odpovědi přijata hlavička Accept-Ranges, znamená to, že server hlavičky rozsahu nepodporuje. Příklad Accept-Ranges hlavičky ze serveru, který nepodporuje rozsahy, ale rozpoznává Accept-Ranges hlavičku, by byl následující:

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Parametr rangeSpecifier by se normálně zadal jako "bajty", protože je to jediný specifikátor rozsahu, který rozpozná většina serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu vlastních specifikátorů rozsahu jiných než bajtů (specifikátor rozsahu bajtů definovaný v DOKUMENTU RFC 2616 pomocí IETF).

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

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

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

Server HTTP označuje podporu hlaviček rozsahu 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 pro tuto metodu rangeSpecifier .

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

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

Při přijetí odpovědi z požadavku rozsahu se analyzují a zpřístupní pouze hlavičky HTTP přidružené k celému požadavku prostřednictvím vlastností ve HttpWebResponse třídě . 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 sekvence bajtů, je koncept rozsahu bajtů smysluplný pro každou entitu HTTP. Ne všichni klienti a servery ale musí podporovat operace s rozsahem bajtů.

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

Parametr rangeSpecifier by se normálně zadal jako "bajty", protože je to jediný specifikátor rozsahu, který rozpozná většina serverů HTTP. Nastavení parametru rangeSpecifier na jiný řetězec umožňuje podporu vlastních specifikátorů rozsahu jiných než bajtů (specifikátor rozsahu bajtů definovaný v DOKUMENTU RFC 2616 pomocí IETF).

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

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

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

Server HTTP označuje podporu hlaviček rozsahu 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 pro tuto metodu rangeSpecifier .

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

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

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

Viz také

• AddRange