HttpWebRequest.AddRange Methode

Definition

Fügt der Anforderung einen Bereichsheader hinzu.Adds a range header to the request.

Überlädt

AddRange(Int32)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int64)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.Adds a byte range header to a request for a specific range from the beginning or end of the requested data.

AddRange(Int32, Int32)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.Adds a byte range header to the request for a specified range.

AddRange(Int64, Int64)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.Adds a byte range header to the request for a specified range.

AddRange(String, Int32)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int64)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.Adds a Range header to a request for a specific range from the beginning or end of the requested data.

AddRange(String, Int32, Int32)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.Adds a range header to a request for a specified range.

AddRange(String, Int64, Int64)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.Adds a range header to a request for a specified range.

Hinweise

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

AddRange(Int32)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.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)

Parameter

range
Int32

Der Start- oder Endpunkt des Bereichs.The starting or ending point of the range.

Ausnahmen

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Beispiele

Im folgenden Codebeispiel wird der Anforderung ein Bereichs Header hinzugefügt.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())

Hinweise

Die HttpWebRequest.AddRange-Methode fügt der Anforderung einen Byte Bereichs Header hinzu.The HttpWebRequest.AddRange method adds a byte range header to the request.

Wenn range positiv ist, gibt der range Parameter den Anfangspunkt des Bereichs an.If range is positive, the range parameter specifies the starting point of the range. Der Server sollte mit dem Senden von Daten aus dem range-Parameter beginnen, der an das Ende der Daten in der HTTP-Entität angegeben ist.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an.If range is negative, the range parameter specifies the ending point of the range. Der Server sollte mit dem Senden von Daten vom Beginn der Daten in der HTTP-Entität an den angegebenen range Parameter beginnen.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der den Server anfordert, die ersten 100 Bytes (von der Start-an-Byte-Position 99) zu senden, lautet wie folgt: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

In diesem Beispiel wäre der range-Parameter-99.For this example, the range parameter would be -99.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header an.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(Int64)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.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)

Parameter

range
Int64

Der Start- oder Endpunkt des Bereichs.The starting or ending point of the range.

Ausnahmen

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange-Methode fügt der Anforderung einen Byte Bereichs Header hinzu.The HttpWebRequest.AddRange method adds a byte range header to the request.

Wenn range positiv ist, gibt der range Parameter den Anfangspunkt des Bereichs an.If range is positive, the range parameter specifies the starting point of the range. Der Server sollte mit dem Senden von Daten aus dem range-Parameter beginnen, der an das Ende der Daten in der HTTP-Entität angegeben ist.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an.If range is negative, the range parameter specifies the ending point of the range. Der Server sollte mit dem Senden von Daten vom Beginn der Daten in der HTTP-Entität an den angegebenen range Parameter beginnen.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der den Server anfordert, die ersten 100 Bytes (von der Start-an-Byte-Position 99) zu senden, lautet wie folgt: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

In diesem Beispiel wäre der range-Parameter-99.For this example, the range parameter would be -99.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header an.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(Int32, Int32)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.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)

Parameter

from
Int32

Die Position, an der mit dem Senden von Daten begonnen werden soll.The position at which to start sending data.

to
Int32

Die Position, an der das Senden von Daten beendet werden soll.The position at which to stop sending data.

Ausnahmen

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

from ist größer als tofrom is greater than to

- oder --or- from oder to ist kleiner als 0 (null).from or to is less than 0.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Beispiele

Im folgenden Codebeispiel wird der Anforderung ein Bereichs Header hinzugefügt.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()

Hinweise

Die HttpWebRequest.AddRange-Methode fügt der Anforderung einen Byte Bereichs Header hinzu.The HttpWebRequest.AddRange method adds a byte range header to the request.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der from-Parameter als 0 und der to Parameter als 99 angegeben werden.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Der Bereichsspezifizierer wird von dieser Methode automatisch als "Bytes" festgelegt.The range specifier is automatically set as "bytes" by this method.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header an.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(Int64, Int64)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.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)

Parameter

from
Int64

Die Position, an der mit dem Senden von Daten begonnen werden soll.The position at which to start sending data.

to
Int64

Die Position, an der das Senden von Daten beendet werden soll.The position at which to stop sending data.

Ausnahmen

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

from ist größer als tofrom is greater than to

- oder --or- from oder to ist kleiner als 0 (null).from or to is less than 0.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange-Methode fügt der Anforderung einen Byte Bereichs Header hinzu.The HttpWebRequest.AddRange method adds a byte range header to the request.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der from-Parameter als 0 und der to Parameter als 99 angegeben werden.For this example, the from parameter would be specified as 0 and the to parameter would be specified as 99. Der Bereichsspezifizierer wird von dieser Methode automatisch als "Bytes" festgelegt.The range specifier is automatically set as "bytes" by this method.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header an.A HTTP server indicates support for Range headers with the Accept-Ranges header. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(String, Int32)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.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)

Parameter

rangeSpecifier
String

Die Beschreibung des Bereichs.The description of the range.

range
Int32

Der Start- oder Endpunkt des Bereichs.The starting or ending point of the range.

Ausnahmen

rangeSpecifier ist null.rangeSpecifier is null.

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.The HttpWebRequest.AddRange method adds a Range header to the request.

Wenn range positiv ist, gibt der range Parameter den Anfangspunkt des Bereichs an.If range is positive, the range parameter specifies the starting point of the range. Der Server sollte mit dem Senden von Daten aus dem range-Parameter beginnen, der an das Ende der Daten in der HTTP-Entität angegeben ist.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an.If range is negative, the range parameter specifies the ending point of the range. Der Server sollte mit dem Senden von Daten vom Beginn der Daten in der HTTP-Entität an den angegebenen range Parameter beginnen.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Der rangeSpecifier-Parameter würde normalerweise als "Bytes" angegeben werden, da dies der einzige von den meisten HTTP-Servern erkannte Bereichsspezifizierer ist.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Wenn der rangeSpecifier-Parameter auf eine andere Zeichenfolge festgelegt wird, ist die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer bytes (der in RFC 2616 durch IETF definierte Byte Bereichs Bezeichner) möglich.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).

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der rangeSpecifier-Parameter als "Bytes" angegeben werden, und der range Parameter wäre "-99".For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header in der Antwort an.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(String, Int64)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.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)

Parameter

rangeSpecifier
String

Die Beschreibung des Bereichs.The description of the range.

range
Int64

Der Start- oder Endpunkt des Bereichs.The starting or ending point of the range.

Ausnahmen

rangeSpecifier ist null.rangeSpecifier is null.

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.The HttpWebRequest.AddRange method adds a Range header to the request.

Wenn range positiv ist, gibt der range Parameter den Anfangspunkt des Bereichs an.If range is positive, the range parameter specifies the starting point of the range. Der Server sollte mit dem Senden von Daten aus dem range-Parameter beginnen, der an das Ende der Daten in der HTTP-Entität angegeben ist.The server should start sending data from the range parameter specified to the end of the data in the HTTP entity.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an.If range is negative, the range parameter specifies the ending point of the range. Der Server sollte mit dem Senden von Daten vom Beginn der Daten in der HTTP-Entität an den angegebenen range Parameter beginnen.The server should start sending data from the start of the data in the HTTP entity to the range parameter specified.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Der rangeSpecifier-Parameter würde normalerweise als "Bytes" angegeben werden, da dies der einzige von den meisten HTTP-Servern erkannte Bereichsspezifizierer ist.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Wenn der rangeSpecifier-Parameter auf eine andere Zeichenfolge festgelegt wird, ist die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer bytes (der in RFC 2616 durch IETF definierte Byte Bereichs Bezeichner) möglich.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).

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der rangeSpecifier-Parameter als "Bytes" angegeben werden, und der range Parameter wäre "-99".For this example, the rangeSpecifier parameter would be specified as "bytes" and the range parameter would be -99.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header in der Antwort an.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(String, Int32, Int32)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.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)

Parameter

rangeSpecifier
String

Die Beschreibung des Bereichs.The description of the range.

from
Int32

Die Position, an der mit dem Senden von Daten begonnen werden soll.The position at which to start sending data.

to
Int32

Die Position, an der das Senden von Daten beendet werden soll.The position at which to stop sending data.

Ausnahmen

rangeSpecifier ist null.rangeSpecifier is null.

from ist größer als tofrom is greater than to

- oder --or- from oder to ist kleiner als 0 (null).from or to is less than 0.

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.The HttpWebRequest.AddRange method adds a Range header to the request.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Der rangeSpecifier-Parameter würde normalerweise als "Bytes" angegeben werden, da dies der einzige von den meisten HTTP-Servern erkannte Bereichsspezifizierer ist.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Wenn der rangeSpecifier-Parameter auf eine andere Zeichenfolge festgelegt wird, ist die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer bytes (der in RFC 2616 durch IETF definierte Byte Bereichs Bezeichner) möglich.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).

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der rangeSpecifier-Parameter als "Bytes" angegeben werden, der from-Parameter ist 0, und der to-Parameter wäre 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.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header in der Antwort an.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Die im Accept-Ranges-Header angegebene Zeichenfolge ist der Bereichsspezifizierer, der im rangeSpecifier-Parameter für diese Methode angegeben wird.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

AddRange(String, Int64, Int64)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.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)

Parameter

rangeSpecifier
String

Die Beschreibung des Bereichs.The description of the range.

from
Int64

Die Position, an der mit dem Senden von Daten begonnen werden soll.The position at which to start sending data.

to
Int64

Die Position, an der das Senden von Daten beendet werden soll.The position at which to stop sending data.

Ausnahmen

rangeSpecifier ist null.rangeSpecifier is null.

from ist größer als tofrom is greater than to

- oder --or- from oder to ist kleiner als 0 (null).from or to is less than 0.

rangeSpecifier ist ungültig.rangeSpecifier is invalid.

Der Bereichsheader konnte nicht hinzugefügt werden.The range header could not be added.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.The HttpWebRequest.AddRange method adds a Range header to the request.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Byte Sequenzen dargestellt werden, ist das Konzept eines Byte Bereichs für jede HTTP-Entität sinnvoll.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. Allerdings müssen nicht alle Clients und Server Byte Bereichs Vorgänge unterstützen.However, not all clients and servers need to support byte-range operations.

Der Range-Header einer Anforderung ermöglicht einem Client, anzufordern, dass er nur einen Teil des angegebenen Byte Bereichs in einer HTTP-Entität empfangen möchte.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. Server müssen keine Bereichs Header Anforderungen unterstützen.Servers are not required to support Range header requests.

Der rangeSpecifier-Parameter würde normalerweise als "Bytes" angegeben werden, da dies der einzige von den meisten HTTP-Servern erkannte Bereichsspezifizierer ist.The rangeSpecifier parameter would normally be specified as a "bytes", since this is the only range specifier recognized by most HTTP servers. Wenn der rangeSpecifier-Parameter auf eine andere Zeichenfolge festgelegt wird, ist die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer bytes (der in RFC 2616 durch IETF definierte Byte Bereichs Bezeichner) möglich.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).

Ein Beispiel für einen Bereichs Header in einer HTTP-Protokoll Anforderung, der die ersten 100 Bytes anfordert, wäre Folgendes: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

In diesem Beispiel würde der rangeSpecifier-Parameter als "Bytes" angegeben werden, der from-Parameter ist 0, und der to-Parameter wäre 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.

Ein HTTP-Server gibt die Unterstützung für Bereichs Header mit dem Accept-Ranges-Header in der Antwort an.A HTTP server indicates support for Range headers with the Accept-Ranges header in the response. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Byte Bereiche unterstützt, wäre wie folgt: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

Die im Accept-Ranges-Header angegebene Zeichenfolge ist der Bereichsspezifizierer, der im rangeSpecifier-Parameter für diese Methode angegeben wird.The string specified in the Accept-Ranges header is the range-specifier that would be by specified in the rangeSpecifier parameter for this method.

Wenn ein Accept-Ranges-Header nicht im Header der Antwort vom Server empfangen wird, unterstützt der Server keine Bereichs Kopfzeilen.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. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt: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

Beim Empfang der Antwort von einer Bereichs Anforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über die Eigenschaften der HttpWebResponse Klasse verfügbar gemacht.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. Header, die mit jedem Bereich verknüpft sind, werden in der Antwort zurückgegeben.Headers associated with each range are returned in the response.

Siehe auch

Gilt für: