WebClient.OpenRead メソッド

定義

名前空間:

System.Net

アセンブリ:

System.Net.WebClient.dll

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

オーバーロード

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

OpenRead(String)

ソース:

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

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

注釈

注意

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

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

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

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

手記

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

手記

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

OpenRead(Uri)

ソース:

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

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

例外

ArgumentNullException

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

WebException

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

-又は-

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

注釈

注意

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

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

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

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

手記

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

手記

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