HttpWebRequest.AddRange Método

Definición

Agrega un encabezado de intervalo a la solicitud.Adds a range header to the request.

Sobrecargas

AddRange(Int32)

Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int64)

Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int32, Int32)

Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.Adds a byte range header to the request for a specified range.

AddRange(Int64, Int64)

Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.Adds a byte range header to the request for a specified range.

AddRange(String, Int32)

Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int64)

Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int32, Int32)

Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.Adds a range header to a request for a specified range.

AddRange(String, Int64, Int64)

Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.Adds a range header to a request for a specified range.

Comentarios

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

AddRange(Int32)

Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.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)

Parámetros

range
Int32

Punto inicial o final del intervalo.The starting or ending point of the range.

Excepciones

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Ejemplos

En el ejemplo de código siguiente se agrega un encabezado de intervalo a la solicitud.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())

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo de bytes a la solicitud.The HttpWebRequest.AddRange method adds a byte range header to the request.

Si range es positivo, el range parámetro especifica el punto inicial del intervalo.If range is positive, the range parameter specifies the starting point of the range. El servidor debe empezar a enviar datos desde el range parámetro especificado al final de los datos de la entidad http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range es negativo, el range parámetro especifica el punto final del intervalo.If range is negative, the range parameter specifies the ending point of the range. El servidor debe empezar a enviar datos desde el inicio de los datos de la entidad HTTP al range parámetro especificado.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

A continuación se proporciona un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita al servidor que envíe los primeros 100 bytes (desde el principio hasta la posición de byte 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

En este ejemplo, el range parámetro sería-99.For this example, the range parameter would be -99.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(Int64)

Agrega un encabezado de intervalo de bytes a una solicitud de un intervalo específico desde el principio o el final de los datos solicitados.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)

Parámetros

range
Int64

Punto inicial o final del intervalo.The starting or ending point of the range.

Excepciones

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo de bytes a la solicitud.The HttpWebRequest.AddRange method adds a byte range header to the request.

Si range es positivo, el range parámetro especifica el punto inicial del intervalo.If range is positive, the range parameter specifies the starting point of the range. El servidor debe empezar a enviar datos desde el range parámetro especificado al final de los datos de la entidad http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range es negativo, el range parámetro especifica el punto final del intervalo.If range is negative, the range parameter specifies the ending point of the range. El servidor debe empezar a enviar datos desde el inicio de los datos de la entidad HTTP al range parámetro especificado.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

A continuación se proporciona un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita al servidor que envíe los primeros 100 bytes (desde el principio hasta la posición de byte 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

En este ejemplo, el range parámetro sería-99.For this example, the range parameter would be -99.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(Int32, Int32)

Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.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)

Parámetros

from
Int32

Posición en la que se va a empezar a enviar datos.The position at which to start sending data.

to
Int32

Posición en la que se va a terminar de enviar datos.The position at which to stop sending data.

Excepciones

rangeSpecifier no es válido.rangeSpecifier is invalid.

from es mayor que to.from is greater than to

o bien-or- from o to es menor que 0.from or to is less than 0.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Ejemplos

En el ejemplo de código siguiente se agrega un encabezado de intervalo a la solicitud.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()

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo de bytes a la solicitud.The HttpWebRequest.AddRange method adds a byte range header to the request.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el from parámetro se especificaría como 0 y el to parámetro se especificaría como 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Este método establece automáticamente el especificador de intervalo como "bytes".The range specifier is automatically set as "bytes" by this method.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(Int64, Int64)

Agrega un encabezado de intervalo de bytes a la solicitud de un intervalo especificado.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)

Parámetros

from
Int64

Posición en la que se va a empezar a enviar datos.The position at which to start sending data.

to
Int64

Posición en la que se va a terminar de enviar datos.The position at which to stop sending data.

Excepciones

rangeSpecifier no es válido.rangeSpecifier is invalid.

from es mayor que to.from is greater than to

o bien-or- from o to es menor que 0.from or to is less than 0.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo de bytes a la solicitud.The HttpWebRequest.AddRange method adds a byte range header to the request.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el from parámetro se especificaría como 0 y el to parámetro se especificaría como 99.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Este método establece automáticamente el especificador de intervalo como "bytes".The range specifier is automatically set as "bytes" by this method.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges.A HTTP server indicates support for Range headers with the Accept-Ranges header. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(String, Int32)

Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.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)

Parámetros

rangeSpecifier
String

Descripción del intervalo.The description of the range.

range
Int32

Punto inicial o final del intervalo.The starting or ending point of the range.

Excepciones

rangeSpecifier es null.rangeSpecifier is null.

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo a la solicitud.The HttpWebRequest.AddRange method adds a Range header to the request.

Si range es positivo, el range parámetro especifica el punto inicial del intervalo.If range is positive, the range parameter specifies the starting point of the range. El servidor debe empezar a enviar datos desde el range parámetro especificado al final de los datos de la entidad http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range es negativo, el range parámetro especifica el punto final del intervalo.If range is negative, the range parameter specifies the ending point of the range. El servidor debe empezar a enviar datos desde el inicio de los datos de la entidad HTTP al range parámetro especificado.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

rangeSpecifierNormalmente, el parámetro se especificaría como "bytes", ya que es el único especificador de intervalo reconocido por la mayoría de los servidores http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Establecer el rangeSpecifier parámetro en otra cadena permite la compatibilidad con especificadores de intervalo personalizados que no sean bytes (el especificador de intervalo de bytes definido en RFC 2616 por 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).

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el rangeSpecifier parámetro se especificaría como "bytes" y el range parámetro sería-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges en la respuesta.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(String, Int64)

Agrega un encabezado Range a una solicitud de un intervalo específico del principio o del final de los datos solicitados.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)

Parámetros

rangeSpecifier
String

Descripción del intervalo.The description of the range.

range
Int64

Punto inicial o final del intervalo.The starting or ending point of the range.

Excepciones

rangeSpecifier es null.rangeSpecifier is null.

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo a la solicitud.The HttpWebRequest.AddRange method adds a Range header to the request.

Si range es positivo, el range parámetro especifica el punto inicial del intervalo.If range is positive, the range parameter specifies the starting point of the range. El servidor debe empezar a enviar datos desde el range parámetro especificado al final de los datos de la entidad http.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Si range es negativo, el range parámetro especifica el punto final del intervalo.If range is negative, the range parameter specifies the ending point of the range. El servidor debe empezar a enviar datos desde el inicio de los datos de la entidad HTTP al range parámetro especificado.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

rangeSpecifierNormalmente, el parámetro se especificaría como "bytes", ya que es el único especificador de intervalo reconocido por la mayoría de los servidores http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Establecer el rangeSpecifier parámetro en otra cadena permite la compatibilidad con especificadores de intervalo personalizados que no sean bytes (el especificador de intervalo de bytes definido en RFC 2616 por 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).

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el rangeSpecifier parámetro se especificaría como "bytes" y el range parámetro sería-99.For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges en la respuesta.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(String, Int32, Int32)

Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.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)

Parámetros

rangeSpecifier
String

Descripción del intervalo.The description of the range.

from
Int32

Posición en la que se va a empezar a enviar datos.The position at which to start sending data.

to
Int32

Posición en la que se va a terminar de enviar datos.The position at which to stop sending data.

Excepciones

rangeSpecifier es null.rangeSpecifier is null.

from es mayor que to.from is greater than to

o bien-or- from o to es menor que 0.from or to is less than 0.

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo a la solicitud.The HttpWebRequest.AddRange method adds a Range header to the request.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

rangeSpecifierNormalmente, el parámetro se especificaría como "bytes", ya que es el único especificador de intervalo reconocido por la mayoría de los servidores http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Establecer el rangeSpecifier parámetro en otra cadena permite la compatibilidad con especificadores de intervalo personalizados que no sean bytes (el especificador de intervalo de bytes definido en RFC 2616 por 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).

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el rangeSpecifier parámetro se especificaría como "bytes", el from parámetro sería 0 y el to parámetro sería 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.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges en la respuesta.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

La cadena especificada en el encabezado Accept-Ranges es Range-Specifier que se especificaría en el rangeSpecifier parámetro de este método.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a

AddRange(String, Int64, Int64)

Agrega un encabezado de intervalo a una solicitud de un intervalo especificado.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)

Parámetros

rangeSpecifier
String

Descripción del intervalo.The description of the range.

from
Int64

Posición en la que se va a empezar a enviar datos.The position at which to start sending data.

to
Int64

Posición en la que se va a terminar de enviar datos.The position at which to stop sending data.

Excepciones

rangeSpecifier es null.rangeSpecifier is null.

from es mayor que to.from is greater than to

o bien-or- from o to es menor que 0.from or to is less than 0.

rangeSpecifier no es válido.rangeSpecifier is invalid.

No se pudo agregar el encabezado de intervalo.The range header could not be added.

Comentarios

El HttpWebRequest.AddRange método agrega un encabezado de intervalo a la solicitud.The HttpWebRequest.AddRange method adds a Range header to the request.

Dado que todas las entidades HTTP se representan en los mensajes HTTP como secuencias de bytes, el concepto de un intervalo de bytes es significativo para cualquier entidad 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. Sin embargo, no todos los clientes y servidores deben admitir operaciones de intervalo de bytes.However, not all clients and servers need to support byte-range operations.

El encabezado de intervalo de una solicitud permite que un cliente solicite que solo desea recibir parte del intervalo de bytes especificado en una entidad 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. No es necesario que los servidores admitan solicitudes de encabezado de intervalo.Servers are not required to support Range header requests.

rangeSpecifierNormalmente, el parámetro se especificaría como "bytes", ya que es el único especificador de intervalo reconocido por la mayoría de los servidores http.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Establecer el rangeSpecifier parámetro en otra cadena permite la compatibilidad con especificadores de intervalo personalizados que no sean bytes (el especificador de intervalo de bytes definido en RFC 2616 por 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).

Un ejemplo de un encabezado de intervalo en una solicitud de protocolo HTTP que solicita los primeros 100 bytes sería el siguiente: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

En este ejemplo, el rangeSpecifier parámetro se especificaría como "bytes", el from parámetro sería 0 y el to parámetro sería 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.

Un servidor HTTP indica la compatibilidad con encabezados de intervalo con el encabezado Accept-Ranges en la respuesta.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que admite intervalos de bytes: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

La cadena especificada en el encabezado Accept-Ranges es Range-Specifier que se especificaría en el rangeSpecifier parámetro de este método.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Si no se recibe un encabezado Accept-Ranges en el encabezado de la respuesta del servidor, el servidor no admite encabezados de intervalo.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. A continuación se muestra un ejemplo del encabezado Accept-Ranges de un servidor que no admite intervalos, pero que reconoce el encabezado 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

Al recibir la respuesta de una solicitud de intervalo, solo los encabezados HTTP asociados a toda la solicitud se analizan y se ponen a disposición a través de las propiedades de la HttpWebResponse clase.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. Los encabezados asociados a cada intervalo se devuelven en la respuesta.Headers associated with each range are returned in the response.

Consulte también

Se aplica a