HttpWebRequest.AddRange メソッド

リファレンス

定義

名前空間:: System.Net

アセンブリ:: System.Net.Requests.dll

アセンブリ:: System.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

オーバーロード

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)	指定した範囲の要求に範囲ヘッダーを追加します。

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

すべての 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())

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

range が負の値の場合、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

適用対象

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

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

サーバーが最初の 100 バイト (開始位置からバイト位置 99) を送信するように要求する HTTP プロトコル要求の Range ヘッダーの例を次に示します。

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

この例では、range パラメーターは -99 になります。

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

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

こちらもご覧ください

AddRange

適用対象

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

この例では、from パラメーターは 0 として指定され、to パラメーターは 99 として指定されます。範囲指定子は、このメソッドによって自動的に "バイト" として設定されます。

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

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

こちらもご覧ください

AddRange

適用対象

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

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

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

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

こちらもご覧ください

AddRange

適用対象

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

範囲の始点または終点。

例外

ArgumentNullException

rangeSpecifier は nullです。

ArgumentException

rangeSpecifier が無効です。

InvalidOperationException

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

HttpWebRequest.AddRange メソッドは、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: none\r\n\r\n

こちらもご覧ください

AddRange

適用対象

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

範囲の始点または終点。

例外

ArgumentNullException

rangeSpecifier は nullです。

ArgumentException

rangeSpecifier が無効です。

InvalidOperationException

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

この例では、rangeSpecifier パラメーターは "bytes" として指定され、range パラメーターは -99 になります。

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

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

こちらもご覧ください

AddRange

適用対象

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

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

この例では、rangeSpecifier パラメーターは "bytes" として指定され、from パラメーターは 0、to パラメーターは 99 になります。

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

Accept-Ranges ヘッダーで指定された文字列は、このメソッドの rangeSpecifier パラメーターで指定される範囲指定子です。

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

こちらもご覧ください

AddRange

適用対象

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

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

注釈

注意

WebRequest、HttpWebRequest、ServicePoint、WebClient は廃止されており、新しい開発には使用しないでください。代わりに HttpClient を使用してください。

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

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

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

この例では、rangeSpecifier パラメーターは "bytes" として指定され、from パラメーターは 0、to パラメーターは 99 になります。

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

Accept-Ranges ヘッダーで指定された文字列は、このメソッドの rangeSpecifier パラメーターで指定される範囲指定子です。

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

こちらもご覧ください

AddRange

適用対象

次の方法で共有

HttpWebRequest.AddRange メソッド

定義

オーバーロード

注釈

AddRange(Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

AddRange(Int64)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

AddRange(Int32, Int32)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

AddRange(Int64, Int64)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

AddRange(String, Int32)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

AddRange(String, Int64)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

AddRange(String, Int32, Int32)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

AddRange(String, Int64, Int64)

パラメーター

例外

注釈

こちらもご覧ください

適用対象

その他のリソース