WebClient.OpenRead Méthode

Définition

Espace de noms:

System.Net

Assemblys:

netstandard.dll, 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

Nom	Description
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 qu’URI String à partir duquel télécharger des données.

Retours

Stream

Utilisé Stream pour lire des données à partir d’une ressource.

Exceptions

ArgumentNullException

Le address paramètre 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 et uriString affiche les résultats sur la console système. Le Stream retour est OpenRead 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

Prudence

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

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

Note

Lorsque vous avez terminé, Stream vous devez appeler Stream.Close 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 qu’URI Uri à partir duquel télécharger des données.

Retours

Stream

Utilisé Stream pour lire des données à partir d’une ressource.

Exceptions

ArgumentNullException

Le address paramètre 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, , HttpWebRequestServicePointet sont obsolètes, et WebClient vous ne devez pas les utiliser pour le nouveau développement. Utilisez HttpClient à la place.

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

Note

Lorsque vous avez terminé, Stream vous devez appeler Stream.Close 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.