WebClient.OpenRead WebClient.OpenRead WebClient.OpenRead WebClient.OpenRead Method

定義

指定した URI を持つリソースからダウンロードしたデータの読み取り可能ストリームを開きます。Opens a readable stream for the data downloaded from a resource with the specified URI.

オーバーロード

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

String として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Uri として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。Opens a readable stream for the data downloaded from a resource with the URI specified as a Uri

OpenRead(String) OpenRead(String) OpenRead(String) OpenRead(String)

String として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。Opens a readable stream for the data downloaded from a resource with the URI specified as a String.

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 String String

String として指定した、データのダウンロード元の URI。The URI specified as a String from which to download data.

戻り値

リソースからデータを読み取るために使用する StreamA Stream used to read data from a resource.

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress, address is invalid.

または-or- データのダウンロード中にエラーが発生しました。An error occurred while downloading data.

次のコード例がで識別されるリソースを開きますuriStringシステム コンソールで、結果を表示します。The following code example opens the resource identified by uriString and displays the results on the system console. なお、Streamによって返されるOpenReadデータが読み取られたときに閉じられます。Note that the Stream returned by OpenRead is closed when the data has been read.

// 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パラメーター。The OpenRead method creates a Stream instance used to read the contents of the resource specified by the address parameter. ストリームを開くときに、このメソッドはブロックします。This method blocks while opening the stream. ストリームの待機中に実行を続行するには、いずれかを使用、OpenReadAsyncメソッド。To continue executing while waiting for the stream, use one of the OpenReadAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティはnullに追加されますaddressします。If the QueryString property is not null, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

呼び出す必要がありますStream.Close使用が終わったら、Streamシステム リソースの不足を回避します。You must call Stream.Close when finished with the Stream to avoid running out of system resources.

注意

このメンバーは、アプリケーションでネットワーク トレースが有効にされている場合にトレース情報を出力します。This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

OpenRead(Uri) OpenRead(Uri) OpenRead(Uri) OpenRead(Uri)

Uri として指定した URI を持つリソースからダウンロードしたデータの読み取り可能なストリームを開きます。Opens a readable stream for the data downloaded from a resource with the URI specified as a 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 Uri

Uri として指定した、データのダウンロード元の URI。The URI specified as a Uri from which to download data.

戻り値

リソースからデータを読み取るために使用する StreamA Stream used to read data from a resource.

例外

address パラメーターが null です。The address parameter is null.

BaseAddress および address を組み合わせて形成された URI が無効です。The URI formed by combining BaseAddress, address is invalid.

または-or- データのダウンロード中にエラーが発生しました。An error occurred while downloading data.

注釈

OpenReadメソッドを作成、Streamによって指定されるリソースの内容を読み取るために使用されるインスタンス、addressパラメーター。The OpenRead method creates a Stream instance used to read the contents of the resource specified by the address parameter. ストリームを開くときに、このメソッドはブロックします。This method blocks while opening the stream. ストリームの待機中に実行を続行するには、いずれかを使用、OpenReadAsyncメソッド。To continue executing while waiting for the stream, use one of the OpenReadAsync methods.

場合、BaseAddressプロパティは空の文字列ではありません ("") とaddress、絶対 URI が含まれていないaddressと組み合わせる相対 URI でなければなりませんBaseAddressを要求されたデータの絶対 URI を形成します。If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. 場合、QueryStringプロパティはnullに追加されますaddressします。If the QueryString property is not null, it is appended to address.

このメソッドでは、RETR コマンドを使用して、FTP リソースをダウンロードします。This method uses the RETR command to download an FTP resource. HTTP リソースでは、GET メソッドを使用します。For an HTTP resource, the GET method is used.

注意

呼び出す必要がありますStream.Close使用が終わったら、Streamシステム リソースの不足を回避します。You must call Stream.Close when finished with the Stream to avoid running out of system resources.

このメンバーが、アプリケーションでネットワークのトレースを有効にすると、トレース情報を出力します。Note This member outputs trace information when you enable network tracing in your application. 詳細については、次を参照してください。ネットワークのトレースを .NET Framework でします。For more information, see Network Tracing in the .NET Framework.

適用対象