WebClient.OpenRead Méthode

Définition

Espace de noms:

System.Net

Assembly:

System.Net.WebClient.dll

Ouvre un flux lisible pour les données téléchargées à partir d'une ressource ayant l'URI spécifié.

Surcharges

OpenRead(String)	Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que String.
OpenRead(Uri)	Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que Uri.

OpenRead(String)

Source:

WebClient.cs

Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que 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

Paramètres

address

String

URI spécifié en tant que String, à partir duquel télécharger des données.

Retours

Stream

Stream utilisé pour lire des données d'une ressource.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address est non valide.

- ou -

Une erreur s'est produite lors du téléchargement de données.

Exemples

L’exemple de code suivant ouvre la ressource identifiée par uriString et affiche les résultats sur la console système. Le Stream retourné par OpenRead est fermé lorsque les données ont été lues.

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

Remarques

La OpenRead méthode crée un Stream instance utilisé pour lire le contenu de la ressource spécifiée par le address paramètre . Cette méthode se bloque lors de l’ouverture du flux. Pour poursuivre l’exécution en attendant le flux, utilisez l’une OpenReadAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas null, elle est ajoutée à address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP. Pour une ressource HTTP, la méthode GET est utilisée.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec pour Stream éviter de manquer de ressources système.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.

OpenRead(Uri)

Source:

WebClient.cs

Ouvre un flux accessible en lecture pour les données téléchargées à partir d'une ressource ayant l'URI spécifié en tant que 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

Paramètres

address

Uri

URI spécifié en tant que Uri, à partir duquel télécharger des données.

Retours

Stream

Stream utilisé pour lire des données d'une ressource.

Exceptions

ArgumentNullException

Le paramètre address a la valeur null.

WebException

L'URI formé en combinant la propriété BaseAddress et address est non valide.

- ou -

Une erreur s'est produite lors du téléchargement de données.

Remarques

La OpenRead méthode crée un Stream instance utilisé pour lire le contenu de la ressource spécifiée par le address paramètre . Cette méthode se bloque lors de l’ouverture du flux. Pour poursuivre l’exécution en attendant le flux, utilisez l’une OpenReadAsync des méthodes .

Si la BaseAddress propriété n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas null, elle est ajoutée à address.

Cette méthode utilise la commande RETR pour télécharger une ressource FTP. Pour une ressource HTTP, la méthode GET est utilisée.

Notes

Vous devez appeler Stream.Close lorsque vous avez terminé avec pour Stream éviter de manquer de ressources système.

Notes

Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.