HttpWebRequest.AddRange 方法

  • 參考

定義

命名空間:
System.Net
組件:
System.Net.Requests.dll
組件:
System.dll
組件:
netstandard.dll

將範圍標頭加入至要求。

多載

AddRange(Int32)

針對從已要求資料的起始或結尾的特定範圍，將位元組範圍標頭加入至要求。
AddRange(Int64)

針對從已要求資料的起始或結尾的特定範圍，將位元組範圍標頭加入至要求。
AddRange(Int32, Int32)

將位元組範圍標頭加入至指定範圍的要求。
AddRange(Int64, Int64)

將位元組範圍標頭加入至指定範圍的要求。
AddRange(String, Int32)

針對從已要求資料的起始或結尾的特定範圍，將範圍標頭加入至要求。
AddRange(String, Int64)

針對從已要求資料的起始或結尾的特定範圍，將範圍標頭加入至要求。
AddRange(String, Int32, Int32)

將範圍標頭加入至指定範圍的要求。
AddRange(String, Int64, Int64)

將範圍標頭加入至指定範圍的要求。

備註

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

AddRange(Int32)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

針對從已要求資料的起始或結尾的特定範圍，將位元組範圍標頭加入至要求。

public:
 void AddRange(int range);
public void AddRange (int range);
member this.AddRange : int -> unit
Public Sub AddRange (range As Integer)

參數

range
Int32

範圍的起始和結束點。

例外狀況

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

範例

下列程式碼範例會將範圍標頭新增至要求。

// 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())

備註

方法 HttpWebRequest.AddRange 會將位元組範圍標頭新增至要求。

如果 range 為正數，則 range 參數會指定範圍的起點。 伺服器應該會開始將資料從 range 指定的 參數傳送至 HTTP 實體中的資料結尾。

如果 range 為負數，則 range 參數會指定範圍的結束點。 伺服器應該會開始將資料從 HTTP 實體中的資料開頭傳送至 range 指定的參數。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

HTTP 通訊協定要求中要求伺服器從開始到位元組位置 99) 傳送前 100 個位元組 (的 Range 標頭範例如下：

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

在此範例中 range ，參數會是 -99。

HTTP 伺服器表示支援具有 Accept-Ranges 標頭的 Range 標頭。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(Int64)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

針對從已要求資料的起始或結尾的特定範圍，將位元組範圍標頭加入至要求。

public:
 void AddRange(long range);
public void AddRange (long range);
member this.AddRange : int64 -> unit
Public Sub AddRange (range As Long)

參數

range
Int64

範圍的起始和結束點。

例外狀況

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將位元組範圍標頭新增至要求。

如果 range 為正數，則 range 參數會指定範圍的起點。 伺服器應該會開始將資料從 range 指定的 參數傳送至 HTTP 實體中的資料結尾。

如果 range 為負數，則 range 參數會指定範圍的結束點。 伺服器應該會開始將資料從 HTTP 實體中的資料開頭傳送至 range 指定的參數。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

HTTP 通訊協定要求中要求伺服器從開始到位元組位置 99) 傳送前 100 個位元組 (的 Range 標頭範例如下：

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

在此範例中 range ，參數會是 -99。

HTTP 伺服器表示支援具有 Accept-Ranges 標頭的 Range 標頭。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(Int32, Int32)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

將位元組範圍標頭加入至指定範圍的要求。

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)

參數

from
Int32

要開始傳送資料的位置。

to
Int32

要停止傳送資料的位置。

例外狀況

ArgumentException

rangeSpecifier 無效。

ArgumentOutOfRangeException

from 大於 to

-或-

from 或 to 小於 0。

InvalidOperationException

無法加入範圍標頭。

範例

下列程式碼範例會將範圍標頭新增至要求。

// 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()

備註

方法 HttpWebRequest.AddRange 會將位元組範圍標頭新增至要求。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中，參數 from 會指定為 0，並將 to 參數指定為 99。 這個方法會自動將範圍規範設定為 「bytes」。

HTTP 伺服器表示支援具有 Accept-Ranges 標頭的 Range 標頭。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(Int64, Int64)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

將位元組範圍標頭加入至指定範圍的要求。

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)

參數

from
Int64

要開始傳送資料的位置。

to
Int64

要停止傳送資料的位置。

例外狀況

ArgumentException

rangeSpecifier 無效。

ArgumentOutOfRangeException

from 大於 to

-或-

from 或 to 小於 0。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將位元組範圍標頭新增至要求。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中，參數 from 會指定為 0，並將 to 參數指定為 99。 這個方法會自動將範圍規範設定為 「bytes」。

HTTP 伺服器表示支援具有 Accept-Ranges 標頭的 Range 標頭。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(String, Int32)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

針對從已要求資料的起始或結尾的特定範圍，將範圍標頭加入至要求。

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)

參數

rangeSpecifier
String

範圍的描述。

range
Int32

範圍的起始和結束點。

例外狀況

ArgumentNullException

rangeSpecifier 為 null。

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將 Range 標頭新增至要求。

如果 range 為正數，則 range 參數會指定範圍的起點。 伺服器應該會開始將資料從 range 指定的 參數傳送至 HTTP 實體中的資料結尾。

如果 range 為負數，則 range 參數會指定範圍的結束點。 伺服器應該會開始將資料從 HTTP 實體中的資料開頭傳送至 range 指定的參數。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

參數 rangeSpecifier 通常會指定為 「bytes」，因為這是大部分 HTTP 伺服器所辨識的唯一範圍規範。 rangeSpecifier將 參數設定為其他字串，可支援 IETF) RFC 2616 中所定義的位元組範圍規範 (位元組範圍規範以外的自訂範圍規範。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中，參數 rangeSpecifier 會指定為 「bytes」，而 range 參數會是 -99。

HTTP 伺服器表示回應中具有 Accept-Ranges 標頭的 Range 標頭支援。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(String, Int64)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

針對從已要求資料的起始或結尾的特定範圍，將範圍標頭加入至要求。

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)

參數

rangeSpecifier
String

範圍的描述。

range
Int64

範圍的起始和結束點。

例外狀況

ArgumentNullException

rangeSpecifier 為 null。

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將 Range 標頭新增至要求。

如果 range 為正數，則 range 參數會指定範圍的起點。 伺服器應該會開始將資料從 range 指定的 參數傳送至 HTTP 實體中的資料結尾。

如果 range 為負數，則 range 參數會指定範圍的結束點。 伺服器應該會開始將資料從 HTTP 實體中的資料開頭傳送至 range 指定的參數。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

參數 rangeSpecifier 通常會指定為 「bytes」，因為這是大部分 HTTP 伺服器所辨識的唯一範圍規範。 rangeSpecifier將 參數設定為其他字串，可支援 IETF) RFC 2616 中所定義的位元組範圍規範 (位元組範圍規範以外的自訂範圍規範。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中，參數 rangeSpecifier 會指定為 「bytes」，而 range 參數會是 -99。

HTTP 伺服器表示回應中具有 Accept-Ranges 標頭的 Range 標頭支援。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(String, Int32, Int32)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

將範圍標頭加入至指定範圍的要求。

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)

參數

rangeSpecifier
String

範圍的描述。

from
Int32

要開始傳送資料的位置。

to
Int32

要停止傳送資料的位置。

例外狀況

ArgumentNullException

rangeSpecifier 為 null。

ArgumentOutOfRangeException

from 大於 to

-或-

from 或 to 小於 0。

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將 Range 標頭新增至要求。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

參數 rangeSpecifier 通常會指定為 「bytes」，因為這是大部分 HTTP 伺服器所辨識的唯一範圍規範。 rangeSpecifier將 參數設定為其他字串，可支援 IETF) RFC 2616 中所定義的位元組範圍規範 (位元組範圍規範以外的自訂範圍規範。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中 rangeSpecifier ，參數會指定為 「bytes」， from 參數會是 0，而 to 參數會是 99。

HTTP 伺服器表示回應中具有 Accept-Ranges 標頭的 Range 標頭支援。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

在Accept-Ranges標頭中指定的字串是範圍規範，此範圍規範是由這個方法的 rangeSpecifier 參數中所指定。

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於

AddRange(String, Int64, Int64)

來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs
來源:
HttpWebRequest.cs

將範圍標頭加入至指定範圍的要求。

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)

參數

rangeSpecifier
String

範圍的描述。

from
Int64

要開始傳送資料的位置。

to
Int64

要停止傳送資料的位置。

例外狀況

ArgumentNullException

rangeSpecifier 為 null。

ArgumentOutOfRangeException

from 大於 to

-或-

from 或 to 小於 0。

ArgumentException

rangeSpecifier 無效。

InvalidOperationException

無法加入範圍標頭。

備註

方法 HttpWebRequest.AddRange 會將 Range 標頭新增至要求。

由於所有 HTTP 實體都會以位元組序列的形式在 HTTP 訊息中表示，因此位元組範圍的概念對於任何 HTTP 實體都有意義。 不過，並非所有用戶端和伺服器都需要支援位元組範圍作業。

要求上的 Range 標頭可讓用戶端要求它只想要接收 HTTP 實體中指定位元組範圍的一部分。 伺服器不需要支援 Range 標頭要求。

參數 rangeSpecifier 通常會指定為 「bytes」，因為這是大部分 HTTP 伺服器所辨識的唯一範圍規範。 rangeSpecifier將 參數設定為其他字串，可支援 IETF) RFC 2616 中所定義的位元組範圍規範 (位元組範圍規範以外的自訂範圍規範。

HTTP 通訊協定要求中要求前 100 個位元組的 Range 標頭範例如下：

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

在此範例中 rangeSpecifier ，參數會指定為 「bytes」， from 參數會是 0，而 to 參數會是 99。

HTTP 伺服器表示回應中具有 Accept-Ranges 標頭的 Range 標頭支援。 支援位元組範圍之伺服器的Accept-Ranges標頭範例如下：

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

在Accept-Ranges標頭中指定的字串是範圍規範，此範圍規範是由這個方法的 rangeSpecifier 參數中所指定。

如果伺服器回應的標頭中未收到Accept-Ranges標頭，則伺服器不支援 Range 標頭。 不支援範圍但可辨識Accept-Ranges標頭之伺服器Accept-Ranges標頭的範例如下：

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

從範圍要求接收回應時，只會剖析與整個要求相關聯的 HTTP 標頭，並透過 類別上的 HttpWebResponse 屬性提供使用。 與每個範圍相關聯的標頭會在回應中傳回。

另請參閱

適用於