WebClient.OpenRead Yöntem

Tanım

Ad Alanı:

System.Net

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Net.WebClient.dll

Belirtilen URI'ye sahip bir kaynaktan indirilen veriler için okunabilir bir akış açar.

Aşırı Yüklemeler

Name	Description
OpenRead(String)	olarak belirtilen URI'ye sahip bir kaynaktan indirilen veriler için okunabilir bir Stringakış açar.
OpenRead(Uri)	olarak belirtilen URI'ye sahip bir kaynaktan indirilen veriler için okunabilir bir Uriakış açar.

OpenRead(String)

Kaynak:

WebClient.cs

olarak belirtilen URI'ye sahip bir kaynaktan indirilen veriler için okunabilir bir Stringakış açar.

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

Parametreler

address

String

Verilerin indirildiği URI.String

Döndürülenler

Stream

Kaynaktan Stream veri okumak için kullanılan.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

Veriler indirilirken bir hata oluştu.

Örnekler

Aşağıdaki kod örneği tarafından uriString tanımlanan kaynağı açar ve sonuçları sistem konsolunda görüntüler. tarafından Stream döndürülen OpenRead , veriler okunduğunda kapatılır.

// 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()

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi, OpenRead parametresi tarafından address belirtilen kaynağın içeriğini okumak için kullanılan bir Stream örnek oluşturur. Bu yöntem akışı açarken engeller. Akışı beklerken yürütmeye devam etmek için yöntemlerden birini OpenReadAsync kullanın.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString özelliği değilsenull, öğesine addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Sistem kaynaklarının tükenmesini önlemek için ile Stream bitirdiğinizde öğesini çağırmalısınızStream.Close.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.

OpenRead(Uri)

Kaynak:

WebClient.cs

olarak belirtilen URI'ye sahip bir kaynaktan indirilen veriler için okunabilir bir Uriakış açar.

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

Parametreler

address

Uri

Verilerin indirildiği URI.Uri

Döndürülenler

Stream

Kaynaktan Stream veri okumak için kullanılan.

Özel durumlar

ArgumentNullException

address parametresi null'dir.

WebException

birleştirilerek BaseAddressaddress oluşturulan URI geçersiz.

-veya-

Veriler indirilirken bir hata oluştu.

Açıklamalar

Dikkat

WebRequest, HttpWebRequest, ServicePointve WebClient kullanım dışıdır ve bunları yeni geliştirme için kullanmamalısınız. Bunun yerine HttpClient kullanın.

yöntemi, OpenRead parametresi tarafından address belirtilen kaynağın içeriğini okumak için kullanılan bir Stream örnek oluşturur. Bu yöntem akışı açarken engeller. Akışı beklerken yürütmeye devam etmek için yöntemlerden birini OpenReadAsync kullanın.

BaseAddress Özellik boş bir dize ("") değilse ve address mutlak URI içermiyorsa, address istenen verilerin mutlak URI'sini oluşturmak için ile BaseAddress birleştirilen göreli bir URI olmalıdır. QueryString özelliği değilsenull, öğesine addresseklenir.

Bu yöntem, FTP kaynağını indirmek için RETR komutunu kullanır. BIR HTTP kaynağı için GET yöntemi kullanılır.

Not

Sistem kaynaklarının tükenmesini önlemek için ile Stream bitirdiğinizde öğesini çağırmalısınızStream.Close.

Not

Bu üye, uygulamanızda ağ izlemeyi etkinleştirdiğinizde izleme bilgilerini döndürür. Daha fazla bilgi için bkz. .NET Framework'te Ağ İzleme.