Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.OpenRead (String)

 

Data di pubblicazione: ottobre 2016

Apre un flusso leggibile per i dati scaricati da una risorsa con l'URI specificato come un String.

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public Stream OpenRead(
	string address
)

Parametri

address
Type: System.String

L'URI specificato come un String da cui scaricare i dati.

Valore restituito

Type: System.IO.Stream

Oggetto Stream utilizzato per leggere dati da una risorsa.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

WebException

L'URI formato dalla combinazione BaseAddress, address non è valido.

-oppure-

Si è verificato un errore durante il download dei dati.

Il OpenRead metodo crea un Stream utilizzato per leggere il contenuto della risorsa specificata dall'istanza di address parametro. Questo metodo si blocca durante l'apertura del flusso. Per continuare l'esecuzione durante l'attesa per il flusso, utilizzare uno del OpenReadAsync metodi.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo viene combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se il QueryString proprietà non è null, questo viene aggiunto a address.

Questo metodo utilizza il comando RETR per scaricare una risorsa FTP. Per una risorsa HTTP viene utilizzato il metodo GET.

System_CAPS_noteNota

È necessario chiamare Stream.Close dopo aver terminato con il Stream per evitare di esaurire le risorse di sistema.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

Esempio di codice seguente consente di aprire la risorsa identificata da uriString e visualizza i risultati nella console di sistema. Si noti che il Stream restituito da OpenRead viene chiuso quando i dati sono stati letti.

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

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: