HttpWebRequest.AddRange Methode

Definition

Fügt der Anforderung einen Bereichsheader hinzu.

Überlädt

AddRange(Int32)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

AddRange(Int64)

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

AddRange(Int32, Int32)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.

AddRange(Int64, Int64)

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.

AddRange(String, Int32)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

AddRange(String, Int64)

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

AddRange(String, Int32, Int32)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.

AddRange(String, Int64, Int64)

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.

Hinweise

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität sinnvoll. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Range-Header für eine Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

AddRange(Int32)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

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.

Ausnahmen

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Beispiele

Im folgenden Codebeispiel wird der Anforderung ein Bereichsheader hinzugefügt.

// 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 Bytebereichsheader hinzu.

Wenn range positiv ist, gibt der range Parameter den Startpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten aus dem range angegebenen Parameter an das Ende der Daten in der HTTP-Entität beginnen.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den range angegebenen Parameter beginnen.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität von Bedeutung. Allerdings müssen nicht alle Clients und Server Vorgänge im Bytebereich unterstützen.

Mit dem Bereichsheader einer Anforderung kann ein Client anfordern, dass er nur einen Teil des angegebenen Bytesbereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, der den Server anfordert, die ersten 100 Bytes (vom Start bis zur Byteposition 99) zu senden, wäre folgendes:

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

In diesem Beispiel wäre der range Parameter -99.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header an. Ein Beispiel für den Accept-Ranges-Header von einem Server, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, lautet wie folgt:

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

Beim Empfangen der Antwort von einer Bereichsanforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(Int64)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bytebereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

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.

Ausnahmen

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange -Methode fügt der Anforderung einen Bytebereichsheader hinzu.

Wenn range positiv ist, gibt der range Parameter den Startpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten aus dem range angegebenen Parameter an das Ende der Daten in der HTTP-Entität beginnen.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den range angegebenen Parameter beginnen.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität von Bedeutung. Allerdings müssen nicht alle Clients und Server Vorgänge im Bytebereich unterstützen.

Mit dem Bereichsheader einer Anforderung kann ein Client anfordern, dass er nur einen Teil des angegebenen Bytesbereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, der den Server anfordert, die ersten 100 Bytes (vom Start bis zur Byteposition 99) zu senden, wäre folgendes:

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

In diesem Beispiel wäre der range Parameter -99.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header an. Ein Beispiel für den Accept-Ranges-Header von einem Server, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, lautet wie folgt:

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

Beim Empfangen der Antwort von einer Bereichsanforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(Int32, Int32)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.

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.

to
Int32

Die Position, an der das Senden von Daten beendet werden soll.

Ausnahmen

rangeSpecifier ist ungültig.

from ist größer als to

- oder -

from oder to ist kleiner als 0 (null).

Der Bereichsheader konnte nicht hinzugefügt werden.

Beispiele

Im folgenden Codebeispiel wird der Anforderung ein Bereichsheader hinzugefügt.

// 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 Bytebereichsheader hinzu.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität von Bedeutung. Allerdings müssen nicht alle Clients und Server Vorgänge im Bytebereich unterstützen.

Mit dem Bereichsheader einer Anforderung kann ein Client anfordern, dass er nur einen Teil des angegebenen Bytesbereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, der die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der from Parameter als 0 und der to Parameter als 99 angegeben. Der Bereichsbezeichner wird von dieser Methode automatisch auf "Bytes" festgelegt.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header an. Ein Beispiel für den Accept-Ranges-Header von einem Server, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header von einem Server, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, lautet wie folgt:

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

Beim Empfangen der Antwort von einer Bereichsanforderung werden nur die der gesamten Anforderung zugeordneten HTTP-Header analysiert und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(Int64, Int64)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt der Anforderung einen Bytebereichsheader für einen angegebenen Bereich hinzu.

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.

to
Int64

Die Position, an der das Senden von Daten beendet werden soll.

Ausnahmen

rangeSpecifier ist ungültig.

from ist größer als to

- oder -

from oder to ist kleiner als 0 (null).

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange -Methode fügt der Anforderung einen Bytebereichsheader hinzu.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität von Bedeutung. Allerdings müssen nicht alle Clients und Server Vorgänge im Bytebereich unterstützen.

Mit dem Bereichsheader einer Anforderung kann ein Client anfordern, dass er nur einen Teil des angegebenen Bytesbereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der from Parameter als 0 und der to Parameter als 99 angegeben. Der Bereichsspezifizierer wird von dieser Methode automatisch als "Bytes" festgelegt.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header an. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header eines Servers, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt:

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

Beim Empfang der Antwort von einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(String, Int32)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

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.

range
Int32

Der Start- oder Endpunkt des Bereichs.

Ausnahmen

rangeSpecifier ist null.

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.

Wenn range positiv ist, gibt der range Parameter den Ausgangspunkt des Bereichs an. Der Server sollte mit dem Senden von Daten aus dem range angegebenen Parameter an das Ende der Daten in der HTTP-Entität beginnen.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den range angegebenen Parameter beginnen.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität sinnvoll. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Range-Header für eine Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

Der rangeSpecifier Parameter wird normalerweise als "Bytes" angegeben, da dies der einzige Bereichsbezeichner ist, der von den meisten HTTP-Servern erkannt wird. Das Festlegen des rangeSpecifier Parameters auf eine andere Zeichenfolge ermöglicht die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer Bytes (der Bytebereichsspezifizierer, der in RFC 2616 von der IETF definiert ist).

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel würde der rangeSpecifier Parameter als "Bytes" und der range Parameter -99 angegeben werden.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header in der Antwort an. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header eines Servers, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt:

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

Beim Empfang der Antwort von einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(String, Int64)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bereichsheader für einen bestimmten Bereich am Anfang oder Ende der angeforderten Daten hinzu.

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.

range
Int64

Der Start- oder Endpunkt des Bereichs.

Ausnahmen

rangeSpecifier ist null.

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.

Wenn range positiv ist, gibt der range Parameter den Ausgangspunkt des Bereichs an. Der Server sollte mit dem Senden von Daten aus dem range angegebenen Parameter an das Ende der Daten in der HTTP-Entität beginnen.

Wenn range negativ ist, gibt der range Parameter den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den range angegebenen Parameter beginnen.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität sinnvoll. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Range-Header für eine Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

Der rangeSpecifier Parameter wird normalerweise als "Bytes" angegeben, da dies der einzige Bereichsbezeichner ist, der von den meisten HTTP-Servern erkannt wird. Das Festlegen des rangeSpecifier Parameters auf eine andere Zeichenfolge ermöglicht die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer Bytes (der Bytebereichsspezifizierer, der in RFC 2616 von der IETF definiert ist).

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel würde der rangeSpecifier Parameter als "Bytes" und der range Parameter -99 angegeben werden.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header in der Antwort an. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header eines Servers, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt:

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

Beim Empfang der Antwort von einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(String, Int32, Int32)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.

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.

from
Int32

Die Position, an der mit dem Senden von Daten begonnen werden soll.

to
Int32

Die Position, an der das Senden von Daten beendet werden soll.

Ausnahmen

rangeSpecifier ist null.

from ist größer als to

- oder -

from oder to ist kleiner als 0 (null).

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität sinnvoll. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Range-Header für eine Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

Der rangeSpecifier Parameter wird normalerweise als "Bytes" angegeben, da dies der einzige Bereichsbezeichner ist, der von den meisten HTTP-Servern erkannt wird. Das Festlegen des rangeSpecifier Parameters auf eine andere Zeichenfolge ermöglicht die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer Bytes (der Bytebereichsspezifizierer, der in RFC 2616 von der IETF definiert ist).

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der rangeSpecifier Parameter als "Bytes" angegeben, der from Parameter wäre 0, und der to Parameter wäre 99.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header in der Antwort an. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Bytebereiche unterstützt, wäre wie folgt:

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

Die im Accept-Ranges-Header angegebene Zeichenfolge ist der Bereichsspezifizierer, der rangeSpecifier im Parameter für diese Methode angegeben wäre.

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header eines Servers, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt:

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

Beim Empfang der Antwort von einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für:

AddRange(String, Int64, Int64)

Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs
Quelle:
HttpWebRequest.cs

Fügt einer Anforderung einen Bereichsheader für einen angegebenen Bereich hinzu.

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.

from
Int64

Die Position, an der mit dem Senden von Daten begonnen werden soll.

to
Int64

Die Position, an der das Senden von Daten beendet werden soll.

Ausnahmen

rangeSpecifier ist null.

from ist größer als to

- oder -

from oder to ist kleiner als 0 (null).

rangeSpecifier ist ungültig.

Der Bereichsheader konnte nicht hinzugefügt werden.

Hinweise

Die HttpWebRequest.AddRange Methode der Anforderung einen Bereichsheader hinzugefügt.

Da alle HTTP-Entitäten in HTTP-Nachrichten als Bytesequenzen dargestellt werden, ist das Konzept eines Bytebereichs für jede HTTP-Entität sinnvoll. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Range-Header für eine Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server müssen keine Bereichsheaderanforderungen unterstützen.

Der rangeSpecifier Parameter wird normalerweise als "Bytes" angegeben, da dies der einzige Bereichsbezeichner ist, der von den meisten HTTP-Servern erkannt wird. Das Festlegen des rangeSpecifier Parameters auf eine andere Zeichenfolge ermöglicht die Unterstützung für benutzerdefinierte Bereichsspezifizierer außer Bytes (der Bytebereichsspezifizierer, der in RFC 2616 von der IETF definiert ist).

Ein Beispiel für einen Range-Header in einer HTTP-Protokollanforderung, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der rangeSpecifier Parameter als "Bytes" angegeben, der from Parameter wäre 0, und der to Parameter wäre 99.

Ein HTTP-Server gibt die Unterstützung für Range-Header mit dem Accept-Ranges-Header in der Antwort an. Ein Beispiel für den Accept-Ranges-Header eines Servers, der Bytebereiche unterstützt, wäre wie folgt:

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

Die im Accept-Ranges-Header angegebene Zeichenfolge ist der Bereichsspezifizierer, der rangeSpecifier im Parameter für diese Methode angegeben wäre.

Wenn im Header der Antwort vom Server kein Accept-Ranges-Header empfangen wird, unterstützt der Server keine Bereichsheader. Ein Beispiel für den Accept-Ranges-Header eines Servers, der keine Bereiche unterstützt, aber den Accept-Ranges-Header erkennt, wäre wie folgt:

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

Beim Empfang der Antwort von einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse -Klasse zur Verfügung gestellt. Header, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für: