Freigeben über


HttpWebRequest.AddRange Methode

Definition

Fügt der Anforderung einen Bereichsheader hinzu.

Überlädt

AddRange(Int32)

Fügt eine Bytebereichskopfzeile zu einer Anforderung für einen bestimmten Bereich vom Anfang oder Ende der angeforderten Daten hinzu.

AddRange(Int64)

Fügt eine Bytebereichskopfzeile zu einer Anforderung für einen bestimmten Bereich vom Anfang oder Ende der angeforderten Daten hinzu.

AddRange(Int32, Int32)

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

AddRange(Int64, Int64)

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

AddRange(String, Int32)

Fügt eine Bereichsüberschrift zu einer Anforderung für einen bestimmten Bereich vom Anfang oder Ende der angeforderten Daten hinzu.

AddRange(String, Int64)

Fügt eine Bereichsüberschrift zu einer Anforderung für einen bestimmten Bereich vom Anfang oder Ende der angeforderten Daten hinzu.

AddRange(String, Int32, Int32)

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

AddRange(String, Int64, Int64)

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

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

AddRange(Int32)

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

Fügt eine Bytebereichskopfzeile zu einer Anforderung für einen bestimmten Bereich vom 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.

Die Bereichsüberschrift 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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

Wenn range positiv ist, gibt der parameter range den Anfangspunkt des Bereichs an. 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.

Wenn range negativ ist, gibt der parameter range den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den angegebenen range 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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs 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, die den Server anfordert, die ersten 100 Bytes (von Anfang an Byteposition 99) zu senden, wäre folgendes:

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

In diesem Beispiel wäre der parameter range -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 ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 eine Bytebereichskopfzeile zu einer Anforderung für einen bestimmten Bereich vom 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.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

Wenn range positiv ist, gibt der parameter range den Anfangspunkt des Bereichs an. 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.

Wenn range negativ ist, gibt der parameter range den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den angegebenen range 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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs 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, die den Server anfordert, die ersten 100 Bytes (von Anfang an Byteposition 99) zu senden, wäre folgendes:

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

In diesem Beispiel wäre der parameter range -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 ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 für einen angegebenen Bereich einen Bytebereichsheader 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.

Die Bereichsüberschrift 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

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs 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, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der parameter from als 0 angegeben, und der parameter to wird als 99 angegeben. Der Bereichsbezeichner 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 von einem Server, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 für einen angegebenen Bereich einen Bytebereichsheader 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.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs 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, die die ersten 100 Bytes anfordert, wäre folgendes:

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

In diesem Beispiel wird der parameter from als 0 angegeben, und der parameter to wird als 99 angegeben. Der Bereichsbezeichner 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 von einem Server, der Bytebereiche unterstützt, wäre wie folgt:

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

Wenn ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 eine Bereichsüberschrift zu einer Anforderung für einen bestimmten Bereich vom 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.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

Wenn range positiv ist, gibt der parameter range den Anfangspunkt des Bereichs an. 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.

Wenn range negativ ist, gibt der parameter range den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den angegebenen range 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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Der parameter rangeSpecifier würde normalerweise als "bytes" angegeben werden, 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 Bereichsbezeichner außer Bytes (der in RFC 2616 vom IETF definierte Bytebereichsbezeichner).

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 parameter rangeSpecifier als "bytes" angegeben und der range Parameter wäre -99.

Ein HTTP-Server gibt die Unterstützung für Bereichsheader mit dem Accept-Ranges-Header in der Antwort 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 ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 eine Bereichsüberschrift zu einer Anforderung für einen bestimmten Bereich vom 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.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

Wenn range positiv ist, gibt der parameter range den Anfangspunkt des Bereichs an. 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.

Wenn range negativ ist, gibt der parameter range den Endpunkt des Bereichs an. Der Server sollte mit dem Senden von Daten vom Anfang der Daten in der HTTP-Entität an den angegebenen range 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 aussagekräftig. Allerdings müssen nicht alle Clients und Server Bytebereichsvorgänge unterstützen.

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Der parameter rangeSpecifier würde normalerweise als "bytes" angegeben werden, 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 Bereichsbezeichner außer Bytes (der in RFC 2616 vom IETF definierte Bytebereichsbezeichner).

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 parameter rangeSpecifier als "bytes" angegeben und der range Parameter wäre -99.

Ein HTTP-Server gibt die Unterstützung für Bereichsheader mit dem Accept-Ranges-Header in der Antwort 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 ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 für einen angegebenen Bereich einen Bereichsheader 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.

rangeSpecifier ist ungültig.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

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

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Der parameter rangeSpecifier würde normalerweise als "bytes" angegeben werden, 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 Bereichsbezeichner außer Bytes (der in RFC 2616 vom IETF definierte Bytebereichsbezeichner).

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 würde der parameter rangeSpecifier 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 Bereichsheader mit dem Accept-Ranges-Header in der Antwort 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

Die im header Accept-Ranges angegebene Zeichenfolge ist der Bereichsbezeichner, der im parameter rangeSpecifier für diese Methode angegeben wird.

Wenn ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, 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 für einen angegebenen Bereich einen Bereichsheader 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.

rangeSpecifier ist ungültig.

Die Bereichsüberschrift konnte nicht hinzugefügt werden.

Hinweise

Vorsicht

WebRequest, HttpWebRequest, ServicePointund WebClient sind veraltet, und Sie sollten sie nicht für die neue Entwicklung verwenden. Verwenden Sie stattdessen HttpClient.

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

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

Der Bereichsheader einer Anforderung ermöglicht es einem Client, anzufordern, dass er nur einen Teil des angegebenen Bytebereichs in einer HTTP-Entität empfangen möchte. Server sind nicht erforderlich, um Bereichsheaderanforderungen zu unterstützen.

Der parameter rangeSpecifier würde normalerweise als "bytes" angegeben werden, 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 Bereichsbezeichner außer Bytes (der in RFC 2616 vom IETF definierte Bytebereichsbezeichner).

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 würde der parameter rangeSpecifier 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 Bereichsheader mit dem Accept-Ranges-Header in der Antwort 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

Die im header Accept-Ranges angegebene Zeichenfolge ist der Bereichsbezeichner, der im parameter rangeSpecifier für diese Methode angegeben wird.

Wenn ein Accept-Ranges-Header nicht in der Kopfzeile der Antwort vom Server empfangen wird, unterstützt der Server keine Range-Header. 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:

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

Beim Empfangen der Antwort aus einer Bereichsanforderung werden nur die http-Header analysiert, die der gesamten Anforderung zugeordnet sind, und über Eigenschaften der HttpWebResponse-Klasse verfügbar gemacht. Kopfzeilen, die jedem Bereich zugeordnet sind, werden in der Antwort zurückgegeben.

Weitere Informationen

Gilt für: