次の方法で共有


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です。

BaseAddressaddress を組み合わせて形成された 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()

注釈

注意

WebRequestHttpWebRequestServicePointWebClient は廃止されており、新しい開発には使用しないでください。 代わりに 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
ソース:
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です。

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

-又は-

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

注釈

注意

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

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

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

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

手記

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

手記

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

適用対象