WebClient.OpenRead 메서드

정의

네임스페이스:

System.Net

어셈블리:

System.Net.WebClient.dll

지정된 URI를 사용하여 리소스에서 다운로드한 데이터에 대해 읽을 수 있는 스트림을 엽니다.

오버로드

OpenRead(String)	String지정된 URI를 사용하여 리소스에서 다운로드한 데이터에 대해 읽을 수 있는 스트림을 엽니다.
OpenRead(Uri)	Uri지정된 URI를 사용하여 리소스에서 다운로드한 데이터에 대해 읽을 수 있는 스트림을 엽니다.

OpenRead(String)

Source:

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)

Source:

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네트워크 추적을 참조하세요.