WebClient.OpenRead メソッド

定義

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

オーバーロード

OpenRead(String)

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

OpenRead(Uri)

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

OpenRead(String)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

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

例外

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

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 と組み合わせて BaseAddress 要求されたデータの絶対 URI を形成する相対 URI である必要があります。 プロパティが QueryString でない null場合は、 に address追加されます。

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

注意

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

Note

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

適用対象

OpenRead(Uri)

ソース:
WebClient.cs
ソース:
WebClient.cs
ソース:
WebClient.cs

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

例外

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

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

- または -

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

注釈

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

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

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

注意

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

Note

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

適用対象