WebClient.OpenRead メソッド

定義

名前空間:

System.Net

アセンブリ:

netstandard.dll, 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を組み合わせて形成された URI、addressは無効です。

-又は-

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

例

次のコード例では、 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を組み合わせて形成された URI、addressは無効です。

-又は-

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

注釈

注意

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 でのネットワーク トレース」を参照してください。