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
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
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 otrzymać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka 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
rangeSpecifier
jest nieprawidłowa.
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
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje do żądania nagłówek zakresu bajtów.
Jeśli range
jest dodatnia, parametr 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
jest ujemna, parametr 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 otrzymać 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 wysył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 parametr range
to -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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje do żądania nagłówek zakresu bajtów.
Jeśli range
jest dodatnia, parametr 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
jest ujemna, parametr 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 otrzymać 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 wysył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 parametr range
to -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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
rangeSpecifier
jest nieprawidłowa.
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
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje do żądania nagłówek zakresu bajtów.
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 otrzymać 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 parametr from
zostanie określony jako 0, a parametr to
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje do żądania nagłówek zakresu bajtów.
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 otrzymać 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 parametr from
zostanie określony jako 0, a parametr to
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
jest null
.
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje nagłówek Zakres do żądania.
Jeśli range
jest dodatnia, parametr 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
jest ujemna, parametr 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 otrzymać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
jest zwykle 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=-99\r\n\r\n
W tym przykładzie parametr rangeSpecifier
zostanie określony jako "bajty", a parametr range
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
jest null
.
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje nagłówek Zakres do żądania.
Jeśli range
jest dodatnia, parametr 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
jest ujemna, parametr 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 otrzymać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
jest zwykle 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=-99\r\n\r\n
W tym przykładzie parametr rangeSpecifier
zostanie określony jako "bajty", a parametr range
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
jest null
.
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje nagłówek Zakres 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 otrzymać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
jest zwykle 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 parametr rangeSpecifier
zostanie określony jako "bajty", parametr from
będzie miał wartość 0, a parametr to
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. 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
jest null
.
rangeSpecifier
jest nieprawidłowa.
Nie można dodać nagłówka zakresu.
Uwagi
Ostrożność
WebRequest
, HttpWebRequest
, ServicePoint
i WebClient
są przestarzałe i nie należy ich używać do tworzenia nowych aplikacji. Zamiast tego użyj HttpClient.
Metoda HttpWebRequest.AddRange dodaje nagłówek Zakres 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 otrzymać tylko część określonego zakresu bajtów w jednostce HTTP. Serwery nie są wymagane do obsługi żądań nagłówka zakresu.
Parametr rangeSpecifier
jest zwykle 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 parametr rangeSpecifier
zostanie określony jako "bajty", parametr from
będzie miał wartość 0, a parametr to
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, wygląda następująco:
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
W przypadku 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 klasie HttpWebResponse. Nagłówki skojarzone z każdym zakresem są zwracane w odpowiedzi.