HttpWebRequest.AddRange メソッド

定義

要求に範囲ヘッダーを追加します。

オーバーロード

AddRange(Int32)

要求されたデータの先頭または末尾からの特定の範囲の要求にバイト範囲ヘッダーを追加します。

AddRange(Int64)

要求されたデータの先頭または末尾からの特定の範囲の要求にバイト範囲ヘッダーを追加します。

AddRange(Int32, Int32)

指定した範囲の要求にバイト範囲ヘッダーを追加します。

AddRange(Int64, Int64)

指定した範囲の要求にバイト範囲ヘッダーを追加します。

AddRange(String, Int32)

要求されたデータの先頭または末尾からの特定の範囲の要求に Range ヘッダーを追加します。

AddRange(String, Int64)

要求されたデータの先頭または末尾からの特定の範囲の要求に Range ヘッダーを追加します。

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

範囲の先頭または末尾。

例外

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

次のコード例では、範囲ヘッダーを要求に追加します。

// 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 範囲の開始点を指定します。 サーバーは、HTTP エンティティ内のデータの range 末尾に指定されたパラメーターからデータの送信を開始する必要があります。

が負の場合 range 、 パラメーターは range 範囲の終了点を指定します。 サーバーは、HTTP エンティティ内のデータの先頭から指定されたパラメーターへのデータの送信を開始する range 必要があります。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

サーバーが最初の 100 バイト (開始位置からバイト位置 99 まで) を送信するように要求する HTTP プロトコル要求の 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

範囲の先頭または末尾。

例外

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、バイト範囲ヘッダーを要求に追加します。

が正の場合 range 、 パラメーターは range 範囲の開始点を指定します。 サーバーは、HTTP エンティティ内のデータの range 末尾に指定されたパラメーターからデータの送信を開始する必要があります。

が負の場合 range 、 パラメーターは range 範囲の終了点を指定します。 サーバーは、HTTP エンティティ内のデータの先頭から指定されたパラメーターへのデータの送信を開始する range 必要があります。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

サーバーが最初の 100 バイト (開始位置からバイト位置 99 まで) を送信するように要求する HTTP プロトコル要求の 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

データの送信を終了する位置。

例外

rangeSpecifier が無効です。

fromto より大きい

- または -

from または to が 0 未満です。

範囲ヘッダーを追加できませんでした。

次のコード例では、範囲ヘッダーを要求に追加します。

// 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 ヘッダー要求をサポートするためにサーバーは必要ありません。

最初の 100 バイトを要求する HTTP プロトコル要求の Range ヘッダーの例を次に示します。

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

この例では、パラメーターは from 0 として指定され、 to パラメーターは 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, 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

データの送信を終了する位置。

例外

rangeSpecifier が無効です。

fromto より大きい

- または -

from または to が 0 未満です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、バイト範囲ヘッダーを要求に追加します。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

最初の 100 バイトを要求する HTTP プロトコル要求の Range ヘッダーの例を次に示します。

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

この例では、パラメーターは from 0 として指定され、 to パラメーターは 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)

ソース:
HttpWebRequest.cs
ソース:
HttpWebRequest.cs
ソース:
HttpWebRequest.cs

要求されたデータの先頭または末尾からの特定の範囲の要求に Range ヘッダーを追加します。

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

範囲の先頭または末尾。

例外

rangeSpecifiernullです。

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、Range ヘッダーを要求に追加します。

が正の場合 range 、 パラメーターは range 範囲の開始点を指定します。 サーバーは、HTTP エンティティ内のデータの range 末尾に指定されたパラメーターからデータの送信を開始する必要があります。

が負の場合 range 、 パラメーターは range 範囲の終了点を指定します。 サーバーは、HTTP エンティティ内のデータの先頭から指定されたパラメーターへのデータの送信を開始する range 必要があります。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

パラメーターは rangeSpecifier 通常、ほとんどの HTTP サーバーで認識される唯一の範囲指定子であるため、"バイト" として指定されます。 パラメーターを rangeSpecifier 他の文字列に設定すると、バイト以外のカスタム範囲指定子 (IETF によって RFC 2616 で定義されたバイト範囲指定子) がサポートされます。

最初の 100 バイトを要求する HTTP プロトコル要求の 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

要求されたデータの先頭または末尾からの特定の範囲の要求に Range ヘッダーを追加します。

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

範囲の先頭または末尾。

例外

rangeSpecifiernullです。

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、Range ヘッダーを要求に追加します。

が正の場合 range 、 パラメーターは range 範囲の開始点を指定します。 サーバーは、HTTP エンティティ内のデータの range 末尾に指定されたパラメーターからデータの送信を開始する必要があります。

が負の場合 range 、 パラメーターは range 範囲の終了点を指定します。 サーバーは、HTTP エンティティ内のデータの先頭から指定されたパラメーターへのデータの送信を開始する range 必要があります。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

パラメーターは rangeSpecifier 通常、ほとんどの HTTP サーバーで認識される唯一の範囲指定子であるため、"バイト" として指定されます。 パラメーターを rangeSpecifier 他の文字列に設定すると、バイト以外のカスタム範囲指定子 (IETF によって RFC 2616 で定義されたバイト範囲指定子) がサポートされます。

最初の 100 バイトを要求する HTTP プロトコル要求の 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

データの送信を終了する位置。

例外

rangeSpecifiernullです。

fromto より大きい

- または -

from または to が 0 未満です。

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、Range ヘッダーを要求に追加します。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

パラメーターは rangeSpecifier 通常、ほとんどの HTTP サーバーで認識される唯一の範囲指定子であるため、"バイト" として指定されます。 パラメーターを rangeSpecifier 他の文字列に設定すると、バイト以外のカスタム範囲指定子 (IETF によって RFC 2616 で定義されたバイト範囲指定子) がサポートされます。

最初の 100 バイトを要求する HTTP プロトコル要求の Range ヘッダーの例を次に示します。

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

この例では、パラメーターは rangeSpecifier "バイト" として指定され、 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

データの送信を終了する位置。

例外

rangeSpecifiernullです。

fromto より大きい

- または -

from または to が 0 未満です。

rangeSpecifier が無効です。

範囲ヘッダーを追加できませんでした。

注釈

メソッドは HttpWebRequest.AddRange 、Range ヘッダーを要求に追加します。

すべての HTTP エンティティは HTTP メッセージでバイト シーケンスとして表されるため、バイト範囲の概念はすべての HTTP エンティティにとって意味があります。 ただし、すべてのクライアントとサーバーがバイト範囲操作をサポートする必要があるわけではありません。

要求の Range ヘッダーを使用すると、クライアントは HTTP エンティティ内の指定されたバイト範囲の一部のみを受信するように要求できます。 Range ヘッダー要求をサポートするためにサーバーは必要ありません。

パラメーターは rangeSpecifier 通常、ほとんどの HTTP サーバーで認識される唯一の範囲指定子であるため、"バイト" として指定されます。 パラメーターを rangeSpecifier 他の文字列に設定すると、バイト以外のカスタム範囲指定子 (IETF によって RFC 2616 で定義されたバイト範囲指定子) がサポートされます。

最初の 100 バイトを要求する HTTP プロトコル要求の Range ヘッダーの例を次に示します。

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

この例では、パラメーターは rangeSpecifier "バイト" として指定され、 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 プロパティを介して使用できるようになります。 各範囲に関連付けられているヘッダーは、応答で返されます。

こちらもご覧ください

適用対象