HttpWebRequest.AddRange Метод

Определение

Пространство имен:

System.Net

Сборка:

System.Net.Requests.dll

Добавляет в запрос заголовок диапазона.

Перегрузки

AddRange(Int32)	Добавляет заголовок диапазона байтов в запрос для определенного диапазона от начала или конца запрошенных данных.
AddRange(Int64)	Добавляет заголовок диапазона байтов в запрос для определенного диапазона от начала или конца запрошенных данных.
AddRange(Int32, Int32)	Добавляет заголовок диапазона байтов в запрос для указанного диапазона.
AddRange(Int64, Int64)	Добавляет заголовок диапазона байтов в запрос для указанного диапазона.
AddRange(String, Int32)	Добавляет заголовок Range в запрос для определенного диапазона от начала или конца запрошенных данных.
AddRange(String, Int64)	Добавляет заголовок Range в запрос для определенного диапазона от начала или конца запрошенных данных.
AddRange(String, Int32, Int32)	Добавляет заголовок диапазона в запрос для указанного диапазона.
AddRange(String, Int64, Int64)	Добавляет заголовок диапазона в запрос для указанного диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

AddRange(Int32)

Исходный код:

HttpWebRequest.cs

Добавляет заголовок диапазона байтов в запрос для определенного диапазона от начала или конца запрошенных данных.

public:
 void AddRange(int range);

public void AddRange (int range);

member this.AddRange : int -> unit

Public Sub AddRange (range As Integer)

Параметры

range

Int32

Начальная или конечная точка диапазона.

Исключения

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Примеры

В следующем примере кода в запрос добавляется заголовок диапазона.

// 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())

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок диапазона байтов.

Если range положительным, параметр range указывает начальную точку диапазона. Сервер должен начать отправку данных из параметра range, указанного в конце данных в сущности HTTP.

Если range отрицательно, параметр range указывает конечную точку диапазона. Сервер должен начать отправку данных с начала данных в сущности HTTP в указанный параметр range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Пример заголовка Range в http-протоколе, который запрашивает сервер, отправляющий первые 100 байт (начиная с позиции 99 байтов) будет следующим:

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

В этом примере параметр range будет равно -99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(Int64)

Исходный код:

HttpWebRequest.cs

Добавляет заголовок диапазона байтов в запрос для определенного диапазона от начала или конца запрошенных данных.

public:
 void AddRange(long range);

public void AddRange (long range);

member this.AddRange : int64 -> unit

Public Sub AddRange (range As Long)

Параметры

range

Int64

Начальная или конечная точка диапазона.

Исключения

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок диапазона байтов.

Если range положительным, параметр range указывает начальную точку диапазона. Сервер должен начать отправку данных из параметра range, указанного в конце данных в сущности HTTP.

Если range отрицательно, параметр range указывает конечную точку диапазона. Сервер должен начать отправку данных с начала данных в сущности HTTP в указанный параметр range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Пример заголовка Range в http-протоколе, который запрашивает сервер, отправляющий первые 100 байт (начиная с позиции 99 байтов) будет следующим:

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

В этом примере параметр range будет равно -99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(Int32, Int32)

Исходный код:

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)

Параметры

from

Int32

Позиция, с которой начинается отправка данных.

to

Int32

Позиция, с которой следует прекратить отправку данных.

Исключения

ArgumentException

rangeSpecifier недопустимо.

ArgumentOutOfRangeException

from больше to

-или-

from или to меньше 0.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Примеры

В следующем примере кода в запрос добавляется заголовок диапазона.

// 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()

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок диапазона байтов.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр from будет указан как 0, а параметр to будет указан как 99. Описатель диапазона автоматически задается как "байт" этим методом.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(Int64, Int64)

Исходный код:

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)

Параметры

from

Int64

Позиция, с которой начинается отправка данных.

to

Int64

Позиция, с которой следует прекратить отправку данных.

Исключения

ArgumentException

rangeSpecifier недопустимо.

ArgumentOutOfRangeException

from больше to

-или-

from или to меньше 0.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок диапазона байтов.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр from будет указан как 0, а параметр to будет указан как 99. Описатель диапазона автоматически задается как "байт" этим методом.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(String, Int32)

Исходный код:

HttpWebRequest.cs

Добавляет заголовок Range в запрос для определенного диапазона от начала или конца запрошенных данных.

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)

Параметры

rangeSpecifier

String

Описание диапазона.

range

Int32

Начальная или конечная точка диапазона.

Исключения

ArgumentNullException

rangeSpecifier null.

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок Range.

Если range положительным, параметр range указывает начальную точку диапазона. Сервер должен начать отправку данных из параметра range, указанного в конце данных в сущности HTTP.

Если range отрицательно, параметр range указывает конечную точку диапазона. Сервер должен начать отправку данных с начала данных в сущности HTTP в указанный параметр range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Параметр rangeSpecifier обычно указывается как "байт", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов. Установка параметра rangeSpecifier на другую строку позволяет поддерживать пользовательские описатели диапазонов, отличные от байтов (описатель байтов, определенный в RFC 2616 IETF).

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр rangeSpecifier будет указан как "байт", а параметр range будет -99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges в ответе. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(String, Int64)

Исходный код:

HttpWebRequest.cs

Добавляет заголовок Range в запрос для определенного диапазона от начала или конца запрошенных данных.

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)

Параметры

rangeSpecifier

String

Описание диапазона.

range

Int64

Начальная или конечная точка диапазона.

Исключения

ArgumentNullException

rangeSpecifier null.

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок Range.

Если range положительным, параметр range указывает начальную точку диапазона. Сервер должен начать отправку данных из параметра range, указанного в конце данных в сущности HTTP.

Если range отрицательно, параметр range указывает конечную точку диапазона. Сервер должен начать отправку данных с начала данных в сущности HTTP в указанный параметр range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Параметр rangeSpecifier обычно указывается как "байт", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов. Установка параметра rangeSpecifier на другую строку позволяет поддерживать пользовательские описатели диапазонов, отличные от байтов (описатель байтов, определенный в RFC 2616 IETF).

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр rangeSpecifier будет указан как "байт", а параметр range будет -99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges в ответе. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(String, Int32, Int32)

Исходный код:

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)

Параметры

rangeSpecifier

String

Описание диапазона.

from

Int32

Позиция, с которой начинается отправка данных.

to

Int32

Позиция, с которой следует прекратить отправку данных.

Исключения

ArgumentNullException

rangeSpecifier null.

ArgumentOutOfRangeException

from больше to

-или-

from или to меньше 0.

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок Range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Параметр rangeSpecifier обычно указывается как "байт", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов. Установка параметра rangeSpecifier на другую строку позволяет поддерживать пользовательские описатели диапазонов, отличные от байтов (описатель байтов, определенный в RFC 2616 IETF).

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр rangeSpecifier будет указан как "байт", параметр from будет 0, а параметр to будет иметь значение 99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges в ответе. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Строка, указанная в заголовке Accept-Ranges, представляет собой описатель диапазона, который будет указан в параметре rangeSpecifier для этого метода.

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange

AddRange(String, Int64, Int64)

Исходный код:

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)

Параметры

rangeSpecifier

String

Описание диапазона.

from

Int64

Позиция, с которой начинается отправка данных.

to

Int64

Позиция, с которой следует прекратить отправку данных.

Исключения

ArgumentNullException

rangeSpecifier null.

ArgumentOutOfRangeException

from больше to

-или-

from или to меньше 0.

ArgumentException

rangeSpecifier недопустимо.

InvalidOperationException

Не удалось добавить заголовок диапазона.

Комментарии

Осторожность

WebRequest, HttpWebRequest, ServicePointи WebClient устарели, и их не следует использовать для новой разработки. Вместо этого используйте HttpClient.

Метод HttpWebRequest.AddRange добавляет в запрос заголовок Range.

Так как все сущности HTTP представлены в HTTP-сообщениях в виде последовательностей байтов, концепция диапазона байтов имеет смысл для любой сущности HTTP. Однако не все клиенты и серверы должны поддерживать операции с диапазоном байтов.

Заголовок Range в запросе позволяет клиенту запрашивать только часть указанного диапазона байтов в сущности HTTP. Серверы не требуются для поддержки запросов заголовка range.

Параметр rangeSpecifier обычно указывается как "байт", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов. Установка параметра rangeSpecifier на другую строку позволяет поддерживать пользовательские описатели диапазонов, отличные от байтов (описатель байтов, определенный в RFC 2616 IETF).

Пример заголовка Range в HTTP-запросе протокола, который запрашивает первые 100 байтов, будет следующим:

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

В этом примере параметр rangeSpecifier будет указан как "байт", параметр from будет 0, а параметр to будет иметь значение 99.

HTTP-сервер указывает на поддержку заголовков Range с заголовком Accept-Ranges в ответе. Пример заголовка Accept-Ranges с сервера, поддерживающего диапазоны байтов, будет следующим образом:

Accept-Ranges: bytes\r\n\r\n

Строка, указанная в заголовке Accept-Ranges, представляет собой описатель диапазона, который будет указан в параметре rangeSpecifier для этого метода.

Если заголовок Accept-Ranges не получен в заголовке ответа от сервера, сервер не поддерживает заголовки Range. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет следующим образом:

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

При получении ответа из запроса диапазона только заголовки HTTP, связанные со всем запросом, анализируются и становятся доступными с помощью свойств класса HttpWebResponse. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.

См. также раздел

• AddRange