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 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
, ServicePoint
und 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
, ServicePoint
und 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
, ServicePoint
und 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.
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
, ServicePoint
und 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.
Die Bereichsüberschrift konnte nicht hinzugefügt werden.
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und 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
, ServicePoint
und 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
, ServicePoint
und 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
.
rangeSpecifier
ist ungültig.
Die Bereichsüberschrift konnte nicht hinzugefügt werden.
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und 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
.
rangeSpecifier
ist ungültig.
Die Bereichsüberschrift konnte nicht hinzugefügt werden.
Hinweise
Vorsicht
WebRequest
, HttpWebRequest
, ServicePoint
und 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.