HttpWebRequest.AddRange Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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)
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)
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)
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.
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)
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.
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)
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)
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)
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
.
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)
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
.
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.