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は、 addressパラメーター Streamによって指定されたリソースの内容を読み取るために使用されるインスタンスを作成します。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.

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティがでないnull場合は、にaddress追加されます。 QueryStringIf 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は、 addressパラメーター Streamによって指定されたリソースの内容を読み取るために使用されるインスタンスを作成します。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.

プロパティが空の文字列 ("" address ) ではなく、絶対 uri も含まれていaddressない場合、は、要求されたBaseAddressデータの絶対 uri を形成するためにと組み合わせた相対 uri である必要があります。 BaseAddressIf 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. プロパティがでないnull場合は、にaddress追加されます。 QueryStringIf 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.

適用対象