Network.DownloadFile Méthode

Définition

Espace de noms:

Microsoft.VisualBasic.Devices

Assembly:

Microsoft.VisualBasic.Forms.dll

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic

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

ArgumentException

destinationFileName se termine par une barre oblique finale.

IOException

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

TimeoutException

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

SecurityException

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

WebException

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

• Uri
• ICredentials
• Objets (Visual Basic)
• Guide pratique pour télécharger un fichier en Visual Basic
• Comment : analyser des chemins d'accès dans Visual Basic