WebClient.OpenRead メソッド

  • リファレンス

定義

名前空間:
System.Net
アセンブリ:
System.Net.WebClient.dll
アセンブリ:
System.dll
アセンブリ:
netstandard.dll

指定した URI を持つリソースからダウンロードしたデータの読み取り可能ストリームを開きます。

オーバーロード

OpenRead(String)

String として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。
OpenRead(Uri)

Uri として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。

OpenRead(String)

String として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。

public:
 System::IO::Stream ^ OpenRead(System::String ^ address);
public System.IO.Stream OpenRead (string address);
member this.OpenRead : string -> System.IO.Stream
Public Function OpenRead (address As String) As Stream

パラメーター

address
String

String として指定した、データのダウンロード元の URI。

戻り値

Stream

リソースからデータを読み取るために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

  • または -

データのダウンロード中にエラーが発生しました。

例

次のコード例では、識別された uriString リソースを開き、システム コンソールに結果を表示します。 返されるOpenRead値はStream、データの読み取り時に閉じられます。

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
// Download home page data.
Console::WriteLine( "Accessing {0} ...", uriString );
// Open a stream to point to the data stream coming from the Web resource.
Stream^ myStream = myWebClient->OpenRead( uriString );

Console::WriteLine( "\nDisplaying Data :\n" );
StreamReader^ sr = gcnew StreamReader( myStream );
Console::WriteLine( sr->ReadToEnd() );

// Close the stream.
myStream->Close();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();
// Download home page data. 
Console.WriteLine("Accessing {0} ...",  uriString);						
// Open a stream to point to the data stream coming from the Web resource.
Stream myStream = myWebClient.OpenRead(uriString);

Console.WriteLine("\nDisplaying Data :\n");
StreamReader sr = new StreamReader(myStream);
Console.WriteLine(sr.ReadToEnd());

// Close the stream. 
myStream.Close();

    ' Create a new WebClient instance.
    Dim myWebClient As New WebClient()

    ' Download home page data. 
    Console.WriteLine("Accessing {0} ...", uriString)

    ' Open a stream to point to the data stream coming from the Web resource.
    Dim myStream As Stream = myWebClient.OpenRead(uriString)

    Console.WriteLine(ControlChars.Cr + "Displaying Data :" + ControlChars.Cr)
Dim sr As New StreamReader(myStream)
Console.WriteLine(sr.ReadToEnd())


    ' Close the stream.
    myStream.Close()

注釈

このメソッドは OpenRead 、パラメーターで Stream 指定されたリソースの内容を読み取るために使用されるインスタンスを address 作成します。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenReadAsync 使用します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address 要求されたデータの絶対 URI を形成するために組み合わ BaseAddress される相対 URI である必要があります。 プロパティが QueryString 指定されていない null場合は、次の値に address追加されます。

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合、GET メソッドが使用されます。

注意

システム リソースが不足しないようにするには、Stream終了したら呼び出すStream.Close必要があります。

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

適用対象

OpenRead(Uri)

Uri として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。

public:
 System::IO::Stream ^ OpenRead(Uri ^ address);
public System.IO.Stream OpenRead (Uri address);
member this.OpenRead : Uri -> System.IO.Stream
Public Function OpenRead (address As Uri) As Stream

パラメーター

address
Uri

Uri として指定した、データのダウンロード元の URI。

戻り値

Stream

リソースからデータを読み取るために使用する Stream。

例外

ArgumentNullException

address パラメーターが null です。

WebException

BaseAddress および address を組み合わせて形成された URI が無効です。

  • または -

データのダウンロード中にエラーが発生しました。

注釈

このメソッドは OpenRead 、パラメーターで Stream 指定されたリソースの内容を読み取るために使用されるインスタンスを address 作成します。 このメソッドは、ストリームを開くときにブロックします。 ストリームの待機中に実行を続行するには、いずれかのメソッドを OpenReadAsync 使用します。

プロパティが BaseAddress 空の文字列 ("") address ではなく、絶対 URI を含まない場合は、 address 要求されたデータの絶対 URI を形成するために組み合わ BaseAddress される相対 URI である必要があります。 プロパティが QueryString 指定されていない null場合は、次の値に address追加されます。

このメソッドは、RETR コマンドを使用して FTP リソースをダウンロードします。 HTTP リソースの場合、GET メソッドが使用されます。

注意

システム リソースが不足しないように、終了Streamしたら呼び出すStream.Close必要があります。

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。 詳細については、「.NET Frameworkのネットワーク トレース」を参照してください。

適用対象