HttpWebRequest.AddRange Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Přidá do požadavku hlavičku rozsahu.
Přetížení
AddRange(Int32) |
Přidá do požadavku hlavičku rozsahu bajtů pro konkrétní rozsah od začátku nebo konce požadovaných dat. |
AddRange(Int64) |
Přidá do požadavku hlavičku rozsahu bajtů pro konkrétní rozsah od začátku nebo konce požadovaných dat. |
AddRange(Int32, Int32) |
Přidá do požadavku hlavičku rozsahu bajtů pro zadaný rozsah. |
AddRange(Int64, Int64) |
Přidá do požadavku hlavičku rozsahu bajtů pro zadaný rozsah. |
AddRange(String, Int32) |
Přidá do požadavku hlavičku Range pro konkrétní rozsah od začátku nebo konce požadovaných dat. |
AddRange(String, Int64) |
Přidá do požadavku hlavičku Range pro konkrétní rozsah od začátku nebo konce požadovaných dat. |
AddRange(String, Int32, Int32) |
Přidá do požadavku na zadaný rozsah hlavičku rozsahu. |
AddRange(String, Int64, Int64) |
Přidá do požadavku na zadaný rozsah hlavičku rozsahu. |
Poznámky
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 potřebují podporovat operace v rozsahu bajtů.
Hlavička Rozsah u požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou potřeba k podpoře požadavků hlaviček rozsahu.
AddRange(Int32)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku hlavičku rozsahu bajtů pro 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
Formát rangeSpecifier
je neplatný.
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
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é
Platí pro
AddRange(Int64)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku hlavičku rozsahu bajtů pro 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
Formát rangeSpecifier
je neplatný.
Záhlaví rozsahu nelze přidat.
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é
Platí pro
AddRange(Int32, Int32)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku hlavičku rozsahu bajtů pro zadaný rozsah.
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, při které chcete zastavit odesílání dat.
Výjimky
Formát rangeSpecifier
je neplatný.
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
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é
Platí pro
AddRange(Int64, Int64)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku na zadaný rozsah hlavičku rozsahu bajtů.
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, při které chcete zastavit odesílání dat.
Výjimky
Formát rangeSpecifier
je neplatný.
Záhlaví rozsahu nelze přidat.
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 potřeba 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 by byl from
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ů, je následující:
Accept-Ranges: bytes\r\n\r\n
Pokud v hlavičce odpovědi ze serveru není přijata hlavička Accept-Ranges, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpoznává hlavičku Accept-Ranges, by byl následující:
Accept-Ranges: none\r\n\r\n
Při příjmu odpovědi z požadavku rozsahu se analyzují a zpřístupní prostřednictvím vlastností ve třídě pouze hlavičky HTTP přidružené k celému HttpWebResponse požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.
Viz také
Platí pro
AddRange(String, Int32)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku na konkrétní rozsah 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
rangeSpecifier
je null
.
Formát rangeSpecifier
je neplatný.
Záhlaví oblasti nelze přidat.
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 potřebují podporovat operace v rozsahu bajtů.
Hlavička Rozsah u požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou potřeba k podpoře požadavků hlaviček rozsahu.
Parametr rangeSpecifier
by se za normálních okolností 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 pro jiné specifikátory vlastního rozsahu než bajty (specifikátor rozsahu bajtů definovaný v RFC 2616 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 pro hlavičky rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, je následující:
Accept-Ranges: bytes\r\n\r\n
Pokud v hlavičce odpovědi ze serveru není přijata hlavička Accept-Ranges, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpoznává hlavičku Accept-Ranges, by byl následující:
Accept-Ranges: none\r\n\r\n
Při příjmu odpovědi z požadavku rozsahu se analyzují a zpřístupní prostřednictvím vlastností ve třídě pouze hlavičky HTTP přidružené k celému HttpWebResponse požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.
Viz také
Platí pro
AddRange(String, Int64)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku na konkrétní rozsah 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
rangeSpecifier
je null
.
Formát rangeSpecifier
je neplatný.
Záhlaví oblasti nelze přidat.
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 potřebují podporovat operace v rozsahu bajtů.
Hlavička Rozsah u požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou potřeba k podpoře požadavků hlaviček rozsahu.
Parametr rangeSpecifier
by se za normálních okolností 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 pro jiné specifikátory vlastního rozsahu než bajty (specifikátor rozsahu bajtů definovaný v RFC 2616 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 pro hlavičky rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, je následující:
Accept-Ranges: bytes\r\n\r\n
Pokud v hlavičce odpovědi ze serveru není přijata hlavička Accept-Ranges, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpoznává hlavičku Accept-Ranges, by byl následující:
Accept-Ranges: none\r\n\r\n
Při příjmu odpovědi z požadavku rozsahu se analyzují a zpřístupní prostřednictvím vlastností ve třídě pouze hlavičky HTTP přidružené k celému HttpWebResponse požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.
Viz také
Platí pro
AddRange(String, Int32, Int32)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku na zadaný rozsah hlavičku rozsahu.
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é se mají začít odesílat data.
- to
- Int32
Pozice, na které se mají zastavit odesílání dat.
Výjimky
rangeSpecifier
je null
.
Formát rangeSpecifier
je neplatný.
Záhlaví oblasti nelze přidat.
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 potřebují podporovat operace v rozsahu bajtů.
Hlavička Rozsah u požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou potřeba k podpoře požadavků hlaviček rozsahu.
Parametr rangeSpecifier
by se za normálních okolností 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 pro jiné specifikátory vlastního rozsahu než bajty (specifikátor rozsahu bajtů definovaný v RFC 2616 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 pro hlavičky rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, je 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 zadaný v parametru rangeSpecifier
pro tuto metodu.
Pokud v hlavičce odpovědi ze serveru není přijata hlavička Accept-Ranges, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpoznává hlavičku Accept-Ranges, by byl následující:
Accept-Ranges: none\r\n\r\n
Při příjmu odpovědi z požadavku rozsahu se analyzují a zpřístupní prostřednictvím vlastností ve třídě pouze hlavičky HTTP přidružené k celému HttpWebResponse požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.
Viz také
Platí pro
AddRange(String, Int64, Int64)
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
- Zdroj:
- HttpWebRequest.cs
Přidá do požadavku na zadaný rozsah hlavičku rozsahu.
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é se mají začít odesílat data.
- to
- Int64
Pozice, na které se mají zastavit odesílání dat.
Výjimky
rangeSpecifier
je null
.
Formát rangeSpecifier
je neplatný.
Záhlaví oblasti nelze přidat.
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 potřebují podporovat operace v rozsahu bajtů.
Hlavička Rozsah u požadavku umožňuje klientovi požadovat, aby v entitě HTTP obdržel pouze část zadaného rozsahu bajtů. Servery nejsou potřeba k podpoře požadavků hlaviček rozsahu.
Parametr rangeSpecifier
by se za normálních okolností 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 pro jiné specifikátory vlastního rozsahu než bajty (specifikátor rozsahu bajtů definovaný v RFC 2616 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 pro hlavičky rozsahu s hlavičkou Accept-Ranges v odpovědi. Příklad hlavičky Accept-Ranges ze serveru, který podporuje rozsahy bajtů, je 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 zadaný v parametru rangeSpecifier
pro tuto metodu.
Pokud v hlavičce odpovědi ze serveru není přijata hlavička Accept-Ranges, server nepodporuje hlavičky rozsahu. Příklad hlavičky Accept-Ranges ze serveru, který nepodporuje rozsahy, ale rozpoznává hlavičku Accept-Ranges, by byl následující:
Accept-Ranges: none\r\n\r\n
Při příjmu odpovědi z požadavku rozsahu se analyzují a zpřístupní prostřednictvím vlastností ve třídě pouze hlavičky HTTP přidružené k celému HttpWebResponse požadavku. V odpovědi se vrátí hlavičky přidružené k jednotlivým oblastem.
Viz také
Platí pro
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro