HttpWebRequest.AddRange Метод

Определение

Добавляет в запрос заголовок диапазона.Adds a range header to the request.

Перегрузки

AddRange(Int32)

Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int64)

Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int32, Int32)

Добавляет в запрос заголовок диапазона байтов для заданного диапазона.Adds a byte range header to the request for a specified range.

AddRange(Int64, Int64)

Добавляет в запрос заголовок диапазона байтов для заданного диапазона.Adds a byte range header to the request for a specified range.

AddRange(String, Int32)

Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int64)

Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int32, Int32)

Добавляет в запрос заголовок диапазона для заданного диапазона.Adds a range header to a request for a specified range.

AddRange(String, Int64, Int64)

Добавляет в запрос заголовок диапазона для заданного диапазона.Adds a range header to a request for a specified range.

Комментарии

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

AddRange(Int32)

Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

public:
 void AddRange(int range);
public void AddRange (int range);
member this.AddRange : int -> unit
Public Sub AddRange (range As Integer)

Параметры

range
Int32

Начальная или конечная точка диапазона.The starting or ending point of the range.

Исключения

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Примеры

В следующем примере кода в запрос добавляется заголовок диапазона.The following code example adds a range header to the request.

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

Комментарии

HttpWebRequest.AddRangeМетод добавляет в запрос заголовок диапазона байтов.The HttpWebRequest.AddRange method adds a byte range header to the request.

Если range аргумент имеет положительное значение, range параметр задает начальную точку диапазона.If range is positive, the range parameter specifies the starting point of the range. Сервер должен начать отправку данных из range параметра, указанного в конец данных в СУЩНОСТИ HTTP.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Если range имеет отрицательное значение, range параметр задает конечную точку диапазона.If range is negative, the range parameter specifies the ending point of the range. Сервер должен начать отправку данных с начала данных в сущности HTTP в range указанный параметр.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

Пример заголовка диапазона в запросе протокола HTTP, запрашивающего сервер, который отправляет первые 100 байт (от начала до байта 99), будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the server send the first 100 bytes (from the start to byte position 99) would be the following:

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

В этом примере range параметр равен-99.For this example, the range parameter would be -99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(Int64)

Добавляет в запрос заголовок диапазона байтов для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

public:
 void AddRange(long range);
public void AddRange (long range);
member this.AddRange : int64 -> unit
Public Sub AddRange (range As Long)

Параметры

range
Int64

Начальная или конечная точка диапазона.The starting or ending point of the range.

Исключения

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет в запрос заголовок диапазона байтов.The HttpWebRequest.AddRange method adds a byte range header to the request.

Если range аргумент имеет положительное значение, range параметр задает начальную точку диапазона.If range is positive, the range parameter specifies the starting point of the range. Сервер должен начать отправку данных из range параметра, указанного в конец данных в СУЩНОСТИ HTTP.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Если range имеет отрицательное значение, range параметр задает конечную точку диапазона.If range is negative, the range parameter specifies the ending point of the range. Сервер должен начать отправку данных с начала данных в сущности HTTP в range указанный параметр.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

Пример заголовка диапазона в запросе протокола HTTP, запрашивающего сервер, который отправляет первые 100 байт (от начала до байта 99), будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the server send the first 100 bytes (from the start to byte position 99) would be the following:

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

В этом примере range параметр равен-99.For this example, the range parameter would be -99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(Int32, Int32)

Добавляет в запрос заголовок диапазона байтов для заданного диапазона.Adds a byte range header to the request for a specified range.

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

Место начала передачи данных.The position at which to start sending data.

to
Int32

Место остановки передачи данных.The position at which to stop sending data.

Исключения

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

from больше tofrom is greater than to

-или--or- Значение from или to меньше 0.from or to is less than 0.

Не удалось добавить заголовок диапазона.The range header could not be added.

Примеры

В следующем примере кода в запрос добавляется заголовок диапазона.The following code example adds a range header to the request.

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

Комментарии

HttpWebRequest.AddRangeМетод добавляет в запрос заголовок диапазона байтов.The HttpWebRequest.AddRange method adds a byte range header to the request.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет from указан как 0, а to параметр будет указан как 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Этот метод автоматически задает для спецификатора диапазона значение "байт".The range specifier is automatically set as "bytes" by this method.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(Int64, Int64)

Добавляет в запрос заголовок диапазона байтов для заданного диапазона.Adds a byte range header to the request for a specified range.

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

Место начала передачи данных.The position at which to start sending data.

to
Int64

Место остановки передачи данных.The position at which to stop sending data.

Исключения

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

from больше tofrom is greater than to

-или--or- Значение from или to меньше 0.from or to is less than 0.

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет в запрос заголовок диапазона байтов.The HttpWebRequest.AddRange method adds a byte range header to the request.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет from указан как 0, а to параметр будет указан как 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Этот метод автоматически задает для спецификатора диапазона значение "байт".The range specifier is automatically set as "bytes" by this method.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(String, Int32)

Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

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

Описание диапазона.The description of the range.

range
Int32

Начальная или конечная точка диапазона.The starting or ending point of the range.

Исключения

rangeSpecifier имеет значение null.rangeSpecifier is null.

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет к запросу заголовок диапазона.The HttpWebRequest.AddRange method adds a Range header to the request.

Если range аргумент имеет положительное значение, range параметр задает начальную точку диапазона.If range is positive, the range parameter specifies the starting point of the range. Сервер должен начать отправку данных из range параметра, указанного в конец данных в СУЩНОСТИ HTTP.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Если range имеет отрицательное значение, range параметр задает конечную точку диапазона.If range is negative, the range parameter specifies the ending point of the range. Сервер должен начать отправку данных с начала данных в сущности HTTP в range указанный параметр.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

rangeSpecifierОбычно параметр задается как "bytes", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Присвоение rangeSpecifier параметру другой строки обеспечивает поддержку настраиваемых описателей диапазона, отличных от байтов (спецификатор диапазона байтов, определенный в RFC 2616 консорциумом IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет rangeSpecifier указан как "bytes", а range параметр — значение-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges в ответе.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(String, Int64)

Добавляет в запрос заголовок Range для определенного диапазона, располагающегося с начала или с конца запрашиваемых данных.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

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

Описание диапазона.The description of the range.

range
Int64

Начальная или конечная точка диапазона.The starting or ending point of the range.

Исключения

rangeSpecifier имеет значение null.rangeSpecifier is null.

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет к запросу заголовок диапазона.The HttpWebRequest.AddRange method adds a Range header to the request.

Если range аргумент имеет положительное значение, range параметр задает начальную точку диапазона.If range is positive, the range parameter specifies the starting point of the range. Сервер должен начать отправку данных из range параметра, указанного в конец данных в СУЩНОСТИ HTTP.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Если range имеет отрицательное значение, range параметр задает конечную точку диапазона.If range is negative, the range parameter specifies the ending point of the range. Сервер должен начать отправку данных с начала данных в сущности HTTP в range указанный параметр.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

rangeSpecifierОбычно параметр задается как "bytes", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Присвоение rangeSpecifier параметру другой строки обеспечивает поддержку настраиваемых описателей диапазона, отличных от байтов (спецификатор диапазона байтов, определенный в RFC 2616 консорциумом IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет rangeSpecifier указан как "bytes", а range параметр — значение-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges в ответе.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(String, Int32, Int32)

Добавляет в запрос заголовок диапазона для заданного диапазона.Adds a range header to a request for a specified range.

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

Описание диапазона.The description of the range.

from
Int32

Место начала передачи данных.The position at which to start sending data.

to
Int32

Место остановки передачи данных.The position at which to stop sending data.

Исключения

rangeSpecifier имеет значение null.rangeSpecifier is null.

from больше tofrom is greater than to

-или--or- Значение from или to меньше 0.from or to is less than 0.

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет к запросу заголовок диапазона.The HttpWebRequest.AddRange method adds a Range header to the request.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

rangeSpecifierОбычно параметр задается как "bytes", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Присвоение rangeSpecifier параметру другой строки обеспечивает поддержку настраиваемых описателей диапазона, отличных от байтов (спецификатор диапазона байтов, определенный в RFC 2616 консорциумом IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет rangeSpecifier указан как "bytes", параметр будет иметь значение from 0, а to параметр — 99.For this example, the rangeSpecifier parameter would be specified as a "bytes", the from parameter would be 0, and the to parameter would be 99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges в ответе.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Строка, указанная в заголовке Accept-Ranges, — это описатель диапазона, который будет указан в rangeSpecifier параметре для этого метода.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к

AddRange(String, Int64, Int64)

Добавляет в запрос заголовок диапазона для заданного диапазона.Adds a range header to a request for a specified range.

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

Описание диапазона.The description of the range.

from
Int64

Место начала передачи данных.The position at which to start sending data.

to
Int64

Место остановки передачи данных.The position at which to stop sending data.

Исключения

rangeSpecifier имеет значение null.rangeSpecifier is null.

from больше tofrom is greater than to

-или--or- Значение from или to меньше 0.from or to is less than 0.

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

Не удалось добавить заголовок диапазона.The range header could not be added.

Комментарии

HttpWebRequest.AddRangeМетод добавляет к запросу заголовок диапазона.The HttpWebRequest.AddRange method adds a Range header to the request.

Так как все сущности HTTP представлены в сообщениях HTTP как последовательности байтов, понятие диапазона байтов имеет смысл для любой сущности HTTP.Since all HTTP entities are represented in HTTP messages as sequences of bytes, the concept of a byte range is meaningful for any HTTP entity. Однако не все клиенты и серверы должны поддерживать операции с диапазонами байтов.However, not all clients and servers need to support byte-range operations.

Заголовок Range в запросе позволяет клиенту запросить, чтобы он получал некоторую часть указанного диапазона байтов в сущности HTTP.The Range header on a request allows a client to request that it only wants to receive some part of the specified range of bytes in an HTTP entity. Серверы не должны поддерживать запросы заголовков диапазонов.Servers are not required to support Range header requests.

rangeSpecifierОбычно параметр задается как "bytes", так как это единственный описатель диапазона, распознаваемый большинством HTTP-серверов.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Присвоение rangeSpecifier параметру другой строки обеспечивает поддержку настраиваемых описателей диапазона, отличных от байтов (спецификатор диапазона байтов, определенный в RFC 2616 консорциумом IETF).Setting the rangeSpecifier parameter to some other string allows support for custom range specifiers other than bytes (the byte-range specifier defined in RFC 2616 by the IETF).

Пример заголовка диапазона в запросе протокола HTTP, который запрашивает первые 100 байт, будет выглядеть следующим образом:An example of a Range header in an HTTP protocol request that requests the first 100 bytes would be would be the following:

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

В этом примере параметр будет rangeSpecifier указан как "bytes", параметр будет иметь значение from 0, а to параметр — 99.For this example, the rangeSpecifier parameter would be specified as a "bytes", the from parameter would be 0, and the to parameter would be 99.

HTTP-сервер указывает на поддержку заголовков диапазонов с заголовком Accept-Ranges в ответе.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ниже приведен пример заголовка Accept-Ranges с сервера, который поддерживает диапазоны байтов.An example of the Accept-Ranges header from a server that supports byte-ranges would be as follows:

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

Строка, указанная в заголовке Accept-Ranges, — это описатель диапазона, который будет указан в rangeSpecifier параметре для этого метода.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Если заголовок Accept-Ranges не получен в заголовке ответа сервера, то сервер не поддерживает заголовки диапазонов.If an Accept-Ranges header is not received in the header of the response from the server, then the server does not support Range headers. Пример заголовка Accept-Ranges с сервера, который не поддерживает диапазоны, но распознает заголовок Accept-Ranges, будет выглядеть следующим образом:An example of the Accept-Ranges header from a server that does not support ranges, but recognizes the Accept-Ranges header, would be as follows:

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

При получении ответа из запроса диапазона анализируются только заголовки HTTP, связанные со всем запросом, и становятся доступными через свойства HttpWebResponse класса.When receiving the response from a range request, only the HTTP headers associated with the entire request are parsed and made available via properties on the HttpWebResponse class. Заголовки, связанные с каждым диапазоном, возвращаются в ответе.Headers associated with each range are returned in the response.

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

Применяется к