HttpWebRequest.AddRange Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Dodaje nagłówek zakresu do żądania.
Przeciążenia
AddRange(Int32) |
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych. |
AddRange(Int64) |
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych. |
AddRange(Int32, Int32) |
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu. |
AddRange(Int64, Int64) |
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu. |
AddRange(String, Int32) |
Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych. |
AddRange(String, Int64) |
Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych. |
AddRange(String, Int32, Int32) |
Dodaje nagłówek zakresu do żądania dla określonego zakresu. |
AddRange(String, Int64, Int64) |
Dodaje nagłówek zakresu do żądania dla określonego zakresu. |
Uwagi
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres żądania umożliwia klientowi żądanie, że chce otrzymywać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.
AddRange(Int32)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.
public:
void AddRange(int range);
public void AddRange (int range);
member this.AddRange : int -> unit
Public Sub AddRange (range As Integer)
Parametry
- range
- Int32
Początkowy lub końcowy punkt zakresu.
Wyjątki
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Przykłady
Poniższy przykład kodu dodaje nagłówek zakresu do żądania.
// 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())
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.
Jeśli range
parametr jest dodatni, range
określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range
określonego na końcu danych w jednostce HTTP.
Jeśli range
parametr jest ujemny, range
określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range
.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Przykład nagłówka zakresu w żądaniu protokołu HTTP, który żąda od serwera wysłania pierwszych 100 bajtów (od początku do pozycji bajtowej 99) będzie następujący:
Range: bytes=0-99\r\n\r\n
W tym przykładzie range
parametr ma wartość -99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(Int64)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu od początku lub końca żądanych danych.
public:
void AddRange(long range);
public void AddRange (long range);
member this.AddRange : int64 -> unit
Public Sub AddRange (range As Long)
Parametry
- range
- Int64
Początkowy lub końcowy punkt zakresu.
Wyjątki
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.
Jeśli range
parametr jest dodatni, range
określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range
określonego na końcu danych w jednostce HTTP.
Jeśli range
parametr jest ujemny, range
określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range
.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Przykład nagłówka zakresu w żądaniu protokołu HTTP, który żąda od serwera wysłania pierwszych 100 bajtów (od początku do pozycji bajtowej 99) będzie następujący:
Range: bytes=0-99\r\n\r\n
W tym przykładzie range
parametr ma wartość -99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(Int32, Int32)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.
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
Położenie, w którym należy rozpocząć wysyłanie danych.
- to
- Int32
Położenie, w którym należy przestać wysyłać dane.
Wyjątki
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Przykłady
Poniższy przykład kodu dodaje nagłówek zakresu do żądania.
// 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()
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=0-99\r\n\r\n
W tym przykładzie from
parametr zostanie określony jako 0, a to
parametr zostanie określony jako 99. Specyfikator zakresu jest automatycznie ustawiany jako "bajty" przez tę metodę.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(Int64, Int64)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu bajtów do żądania dla określonego zakresu.
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
Położenie, w którym należy rozpocząć wysyłanie danych.
- to
- Int64
Położenie, w którym należy przestać wysyłać dane.
Wyjątki
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek zakresu bajtów do żądania.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=0-99\r\n\r\n
W tym przykładzie from
parametr zostanie określony jako 0, a to
parametr zostanie określony jako 99. Specyfikator zakresu jest automatycznie ustawiany jako "bajty" przez tę metodę.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(String, Int32)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.
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
Opis zakresu.
- range
- Int32
Początkowy lub końcowy punkt zakresu.
Wyjątki
rangeSpecifier
to null
.
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.
Jeśli range
parametr jest dodatni, range
określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range
określonego na końcu danych w jednostce HTTP.
Jeśli range
parametr jest ujemny, range
określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range
.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier
na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=-99\r\n\r\n
W tym przykładzie rangeSpecifier
parametr zostanie określony jako "bajty", a range
parametr to -99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(String, Int64)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek Zakres do żądania dla określonego zakresu od początku lub końca żądanych danych.
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
Opis zakresu.
- range
- Int64
Początkowy lub końcowy punkt zakresu.
Wyjątki
rangeSpecifier
to null
.
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.
Jeśli range
parametr jest dodatni, range
określa punkt początkowy zakresu. Serwer powinien rozpocząć wysyłanie danych z parametru range
określonego na końcu danych w jednostce HTTP.
Jeśli range
parametr jest ujemny, range
określa punkt końcowy zakresu. Serwer powinien rozpocząć wysyłanie danych od początku danych w jednostce HTTP do określonego parametru range
.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier
na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=-99\r\n\r\n
W tym przykładzie rangeSpecifier
parametr zostanie określony jako "bajty", a range
parametr to -99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(String, Int32, Int32)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu do żądania dla określonego zakresu.
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
Opis zakresu.
- from
- Int32
Położenie, w którym należy rozpocząć wysyłanie danych.
- to
- Int32
Położenie, w którym należy przestać wysyłać dane.
Wyjątki
rangeSpecifier
to null
.
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
zwykle jest określony jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier
na inny ciąg umożliwia obsługę specyfikatorów zakresu niestandardowego innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=0-99\r\n\r\n
W tym przykładzie rangeSpecifier
parametr zostanie określony jako "bajty", from
parametr będzie miał wartość 0, a to
parametr będzie miał wartość 99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera, który obsługuje zakresy bajtów, będzie następujący:
Accept-Ranges: bytes\r\n\r\n
Ciąg określony w nagłówku Accept-Ranges jest specyfikatorem zakresu, który byłby określony w parametrze rangeSpecifier
dla tej metody.
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, będzie następujący:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości w HttpWebResponse klasie. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
AddRange(String, Int64, Int64)
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
- Źródło:
- HttpWebRequest.cs
Dodaje nagłówek zakresu do żądania dla określonego zakresu.
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
Opis zakresu.
- from
- Int64
Położenie, w którym należy rozpocząć wysyłanie danych.
- to
- Int64
Położenie, w którym należy przestać wysyłać dane.
Wyjątki
rangeSpecifier
to null
.
Nazwa rangeSpecifier
jest niepoprawna.
Nie można dodać nagłówka zakresu.
Uwagi
Metoda HttpWebRequest.AddRange dodaje nagłówek Range do żądania.
Ponieważ wszystkie jednostki HTTP są reprezentowane w komunikatach HTTP jako sekwencje bajtów, pojęcie zakresu bajtów ma znaczenie dla każdej jednostki HTTP. Jednak nie wszyscy klienci i serwery muszą obsługiwać operacje zakresu bajtów.
Nagłówek Zakres w żądaniu umożliwia klientowi żądanie, że chce odbierać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówków zakresu.
Parametr rangeSpecifier
zwykle jest określany jako "bajty", ponieważ jest to jedyny specyfikator zakresu rozpoznawany przez większość serwerów HTTP. Ustawienie parametru rangeSpecifier
na inny ciąg umożliwia obsługę niestandardowych specyfikatorów zakresu innych niż bajty (specyfikator zakresu bajtów zdefiniowany w dokumencie RFC 2616 przez IETF).
Przykładem nagłówka zakresu w żądaniu protokołu HTTP, które żąda pierwszych 100 bajtów, byłoby następujące:
Range: bytes=0-99\r\n\r\n
W tym przykładzie rangeSpecifier
parametr zostanie określony jako "bajty", from
parametr będzie 0, a to
parametr będzie miał wartość 99.
Serwer HTTP wskazuje obsługę nagłówków zakresów z nagłówkiem Accept-Ranges w odpowiedzi. Przykład nagłówka Accept-Ranges z serwera obsługującego zakresy bajtów:
Accept-Ranges: bytes\r\n\r\n
Ciąg określony w nagłówku Accept-Ranges jest specyfikatorem zakresu, który byłby określony w parametrze rangeSpecifier
dla tej metody.
Jeśli nagłówek Accept-Ranges nie zostanie odebrany w nagłówku odpowiedzi z serwera, serwer nie obsługuje nagłówków zakresu. Przykład nagłówka Accept-Ranges z serwera, który nie obsługuje zakresów, ale rozpoznaje nagłówek Accept-Ranges, wygląda następująco:
Accept-Ranges: none\r\n\r\n
Podczas odbierania odpowiedzi z żądania zakresu tylko nagłówki HTTP skojarzone z całym żądaniem są analizowane i udostępniane za pośrednictwem właściwości klasy HttpWebResponse . Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.
Zobacz też
Dotyczy
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla