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 avec l’URI spécifié.

Surcharges

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

OpenRead(String)

Source:

WebClient.cs

Ouvre un flux lisible pour les données téléchargées à partir d’une ressource avec 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

Une Stream utilisée pour lire des données à partir d’une ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddress, address n’est pas valide.

-ou-

Une erreur s’est produite lors du téléchargement des 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. La Stream retournée par OpenRead est fermée 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

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

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

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString 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.

Note

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

Note

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

OpenRead(Uri)

Source:

WebClient.cs

Ouvre un flux lisible pour les données téléchargées à partir d’une ressource avec 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

Une Stream utilisée pour lire des données à partir d’une ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

WebException

L’URI formé en combinant BaseAddress, address n’est pas valide.

-ou-

Une erreur s’est produite lors du téléchargement des données.

Remarques

Prudence

WebRequest, HttpWebRequest, ServicePointet WebClient sont obsolètes et vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

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

Si la propriété BaseAddress n’est pas une chaîne vide («  ») et address ne contient pas d’URI absolu, address doit être un URI relatif combiné à BaseAddress pour former l’URI absolu des données demandées. Si la propriété QueryString 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.

Note

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

Note

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