Partager via


Network.DownloadFile Méthode

Définition

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

Surcharges

DownloadFile(String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(String, String, String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String, String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

DownloadFile(String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName);
public void DownloadFile (string address, string destinationFileName);
member this.DownloadFile : string * string -> unit
Public Sub DownloadFile (address As String, destinationFileName As String)

Paramètres

address
String

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

Exceptions

destinationFileName se termine par une barre oblique finale.

Le serveur ne répond pas dans le délai d'attente par défaut (100 secondes).

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si le fichier de destination existe déjà, la DownloadFile méthode ne remplace pas le fichier existant. Vous pouvez utiliser l’une des autres surcharges de la DownloadFile méthode pour lui demander de remplacer les fichiers existants, de fournir des informations d’identification utilisateur ou de spécifier une valeur de délai d’expiration spécifique.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);
public void DownloadFile (Uri address, string destinationFileName);
member this.DownloadFile : Uri * string -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String)

Paramètres

address
Uri

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

Exceptions

destinationFileName se termine par une barre oblique finale.

Le serveur ne répond pas dans le délai d'attente par défaut (100 secondes).

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si le fichier de destination existe déjà, la DownloadFile méthode ne remplace pas le fichier existant. Vous pouvez utiliser l’une des autres surcharges de la DownloadFile méthode pour lui demander de remplacer les fichiers existants, de fournir des informations d’identification utilisateur ou de spécifier une valeur de délai d’expiration spécifique. DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(String, String, String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);
public void DownloadFile (string address, string destinationFileName, string userName, string password);
member this.DownloadFile : string * string * string * string -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

Paramètres

address
String

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

Exceptions

destinationFileName se termine par une barre oblique finale.

Le serveur ne répond pas dans le délai d'attente par défaut (100 secondes).

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si le fichier de destination existe déjà, la DownloadFile méthode ne remplace pas le fichier existant. Vous pouvez utiliser l’une des autres surcharges de la DownloadFile méthode pour lui demander de remplacer les fichiers existants ou de spécifier une valeur de délai d’expiration spécifique.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String, String, String)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password);
member this.DownloadFile : Uri * string * string * string -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

Paramètres

address
Uri

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

Exceptions

destinationFileName se termine par une barre oblique finale.

Le serveur ne répond pas dans le délai d'attente par défaut (100 secondes).

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si le fichier de destination existe déjà, la DownloadFile méthode ne remplace pas le fichier existant. Vous pouvez utiliser l’une des autres surcharges de la DownloadFile méthode pour lui demander de remplacer les fichiers existants ou de spécifier une valeur de délai d’expiration spécifique.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Paramètres

address
Uri

String ou Uri. Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

String. Nom et chemin d'accès du fichier téléchargé.

networkCredentials
ICredentials

ICredentials. Informations d'identification à fournir.

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI a la valeur True, une boîte de dialogue s’affiche pour afficher la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : string * string * string * string * bool * int * bool -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Paramètres

address
String

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Int32. Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI a la valeur True, une boîte de dialogue s’affiche pour afficher la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Paramètres

address
Uri

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

networkCredentials
ICredentials

Informations d'identification à fournir.

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

onUserCancel
UICancelOption

Spécifie le comportement lorsque l’utilisateur clique sur Annuler ou Non dans la boîte de dialogue qui s’affiche après l’affectation de la valeur showUI à True. La valeur par défaut est ThrowException.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI a la valeur True, une boîte de dialogue s’affiche pour afficher la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Paramètres

address
Uri

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI a la valeur True, une boîte de dialogue s’affiche pour afficher la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur de serveur interne) si l’en-tête d’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour transmettre des informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Paramètres

address
String

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

onUserCancel
UICancelOption

Spécifie le comportement lorsque l’utilisateur clique sur Annuler ou Non dans la boîte de dialogue qui s’affiche après l’affectation de la valeur ShowUI à True. La valeur par défaut est ThrowException.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre C:\Documents and Settings\All Users\Documentsdans , en spécifiant un intervalle de délai d’expiration de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI est défini sur True, une boîte de dialogue s’affiche qui indique la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur interne du serveur) si l’en-tête de l’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour la transmission d’informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Télécharge le fichier distant spécifié et l'enregistre à l'emplacement spécifié.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Paramètres

address
Uri

Chemin d'accès au fichier à télécharger, y compris nom de fichier et adresse d'hôte.

destinationFileName
String

Nom et chemin d'accès du fichier téléchargé.

userName
String

Nom d'utilisateur à authentifier. La valeur par défaut est une chaîne vide, "".

password
String

Mot de passe à authentifier. La valeur par défaut est une chaîne vide, "".

showUI
Boolean

,True pour afficher l'avancement de l'opération ; sinon, False. La valeur par défaut est False.

connectionTimeout
Int32

Intervalle de délai en millisecondes. La valeur par défaut est de 100 secondes.

overwrite
Boolean

True pour remplacer les fichiers existants ; sinon, False. La valeur par défaut est False.

onUserCancel
UICancelOption

Spécifie le comportement lorsque l’utilisateur clique sur Annuler ou Non dans la boîte de dialogue qui s’affiche après l’affectation de la valeur ShowUI à True. La valeur par défaut est ThrowException.

Exceptions

destinationFileName se termine par une barre oblique finale.

overwrite a la valeur False et le fichier de destination existe déjà.

Le serveur ne répond pas dans le connectionTimeout spécifié.

L'utilisateur ne dispose pas des autorisations nécessaires pour réaliser une opération réseau.

La demande est refusée par le serveur Web cible.

Exemples

Cet exemple montre comment télécharger le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistrer dans C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Cet exemple télécharge le fichier WineList.txt à partir de http://www.cohowinery.com/downloads et l’enregistre dans C:\Documents and Settings\All Users\Documents, en spécifiant un intervalle de délai d’attente de 500 millisecondes.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Remarques

Si showUI est défini sur True, une boîte de dialogue s’affiche qui indique la progression de l’opération ; la boîte de dialogue contient un bouton Annuler qui peut être utilisé pour annuler l’opération. La boîte de dialogue n’est pas modale et ne bloque donc pas l’entrée utilisateur dans d’autres fenêtres du programme.

Si le serveur ne répond pas dans le spécifié connectionTimeout, l’opération est annulée et une exception est levée.

DownloadFile génère des informations de trace lorsque vous activez le suivi réseau dans votre application. Pour plus d’informations, consultez Activation du suivi réseau.

Notes

La DownloadFile méthode n’envoie pas d’en-têtes HTTP facultatifs. Certains serveurs peuvent retourner 500 (erreur interne du serveur) si l’en-tête de l’agent utilisateur facultatif est manquant. Pour envoyer des en-têtes facultatifs, vous devez construire une requête à l’aide de la WebClient classe .

Notes

Le protocole FTP envoie des informations, y compris des mots de passe, en texte brut et ne doit pas être utilisé pour la transmission d’informations sensibles.

Le tableau suivant répertorie un exemple de tâche impliquant la My.Computer.Network.DownloadFile méthode .

À Consultez
Téléchargement d’un fichier Procédure : télécharger un fichier

Voir aussi

S’applique à