WebClient.OpenRead Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
- Source:
- WebClient.cs
- 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
Retours
Stream utilisé pour lire des données d'une ressource.
Exceptions
Le paramètre address
a la valeur null
.
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. L’objet 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 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 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
il doit s’agir d’un URI relatif 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 éviter de Stream 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.
S’applique à
OpenRead(Uri)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- 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
Retours
Stream utilisé pour lire des données d'une ressource.
Exceptions
Le paramètre address
a la valeur null
.
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 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 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
il doit s’agir d’un URI relatif 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 éviter de Stream 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.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour