WebClient.UploadFile Méthode

  • Référence

Définition

Espace de noms:
System.Net
Assembly:
System.Net.WebClient.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Charge un fichier local dans une ressource avec l’URI spécifié.

Surcharges

UploadFile(String, String)

Charge le fichier local spécifié dans une ressource avec l’URI spécifié.
UploadFile(Uri, String)

Charge le fichier local spécifié dans une ressource avec l’URI spécifié.
UploadFile(String, String, String)

Charge le fichier local spécifié dans la ressource spécifiée, à l’aide de la méthode spécifiée.
UploadFile(Uri, String, String)

Charge le fichier local spécifié dans la ressource spécifiée, à l’aide de la méthode spécifiée.

UploadFile(String, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge le fichier local spécifié dans une ressource avec l’URI spécifié.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ fileName);
public byte[] UploadFile (string address, string fileName);
member this.UploadFile : string * string -> byte[]
Public Function UploadFile (address As String, fileName As String) As Byte()

Paramètres

address
String

URI de la ressource à recevoir. Par exemple, ftp://localhost/samplefile.txt.

fileName
String

Fichier à envoyer à la ressource. Par exemple, «samplefile.txt».

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre fileName est null.

WebException

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

-ou-

fileName est null, est Empty, contient des caractères non valides ou n’existe pas.

-ou-

Une erreur s’est produite lors du chargement du fichier.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

L’en-tête Content-type commence par multipart.

Exemples

L’exemple de code suivant charge le fichier spécifié dans l’URI spécifié à l’aide de UploadFile. Toute réponse retournée par le serveur s’affiche sur la console.

Console::Write( "\nPlease enter the URI to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine( "\nPlease enter the fully qualified path of the file to be uploaded to the URI" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URI.
// The 'UploadFile(uriString, fileName)' method implicitly uses HTTP POST method.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ) );

Console.Write("\nPlease enter the URI to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URI");
string fileName = Console.ReadLine();
Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);

// Upload the file to the URI.
// The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method.
byte[] responseArray = myWebClient.UploadFile(uriString,fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}", 
    System.Text.Encoding.ASCII.GetString(responseArray));


Console.Write(ControlChars.Cr + "Please enter the URI to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()

Console.WriteLine(ControlChars.Cr & _
    "Please enter the fully qualified path of the file to be uploaded to the URI")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the URI.
' The 'UploadFile(uriString,fileName)' method implicitly uses HTTP POST method. 
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr & "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

L’exemple de code suivant montre une page ASP.NET qui peut accepter les fichiers publiés et convient à une utilisation avec la méthode UploadFile. La page doit résider sur un serveur web. Son adresse fournit la valeur du paramètre address de la méthode UploadFile.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

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 UploadFile envoie un fichier local à une ressource. Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée.

Cette méthode bloque lors du chargement du fichier. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadFileAsync.

La méthode POST est définie par HTTP. Si la requête sous-jacente n’utilise pas HTTP et POST n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

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 une chaîne vide, elle est ajoutée à address.

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.

S’applique à

UploadFile(Uri, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge le fichier local spécifié dans une ressource avec l’URI spécifié.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ fileName);
public byte[] UploadFile (Uri address, string fileName);
member this.UploadFile : Uri * string -> byte[]
Public Function UploadFile (address As Uri, fileName As String) As Byte()

Paramètres

address
Uri

URI de la ressource à recevoir. Par exemple, ftp://localhost/samplefile.txt.

fileName
String

Fichier à envoyer à la ressource. Par exemple, «samplefile.txt».

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre fileName est null.

WebException

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

-ou-

fileName est null, est Empty, contient des caractères non valides ou n’existe pas.

-ou-

Une erreur s’est produite lors du chargement du fichier.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

L’en-tête Content-type commence par multipart.

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 UploadFile envoie un fichier local à une ressource. Cette méthode utilise la commande STOR pour charger une ressource FTP. Pour une ressource HTTP, la méthode POST est utilisée.

Cette méthode bloque lors du chargement du fichier. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadFileAsync.

La méthode POST est définie par HTTP. Si la requête sous-jacente n’utilise pas HTTP et POST n’est pas comprise par le serveur, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

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 une chaîne vide, elle est ajoutée à address.

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.

S’applique à

UploadFile(String, String, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge le fichier local spécifié dans la ressource spécifiée, à l’aide de la méthode spécifiée.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::String ^ fileName);
public byte[] UploadFile (string address, string? method, string fileName);
public byte[] UploadFile (string address, string method, string fileName);
member this.UploadFile : string * string * string -> byte[]
Public Function UploadFile (address As String, method As String, fileName As String) As Byte()

Paramètres

address
String

URI de la ressource à recevoir.

method
String

Méthode utilisée pour envoyer le fichier à la ressource. Si null, la valeur par défaut est POST pour http et STOR pour ftp.

fileName
String

Fichier à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre fileName est null.

WebException

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

-ou-

fileName est null, est Empty, contient des caractères non valides ou n’existe pas.

-ou-

Une erreur s’est produite lors du chargement du fichier.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

L’en-tête Content-type commence par multipart.

Exemples

L’exemple de code suivant charge le fichier spécifié dans l’URI spécifié à l’aide de UploadFile. Toute réponse retournée par le serveur s’affiche sur la console.

Console::Write( "\nPlease enter the URL to post data to : " );
String^ uriString = Console::ReadLine();

// Create a new WebClient instance.
WebClient^ myWebClient = gcnew WebClient;
Console::WriteLine
    ("\nPlease enter the fully qualified path of the file to be uploaded to the URL" );
String^ fileName = Console::ReadLine();
Console::WriteLine( "Uploading {0} to {1} ...", fileName, uriString );

// Upload the file to the URL using the HTTP 1.0 POST.
array<Byte>^responseArray = myWebClient->UploadFile( uriString, "POST", fileName );

// Decode and display the response.
Console::WriteLine( "\nResponse Received::The contents of the file uploaded are: \n {0}", 
    System::Text::Encoding::ASCII->GetString( responseArray ));

Console.Write("\nPlease enter the URL to post data to : ");
String uriString = Console.ReadLine();

// Create a new WebClient instance.
WebClient myWebClient = new WebClient();

Console.WriteLine("\nPlease enter the fully qualified path of the file to be uploaded to the URL");
string fileName = Console.ReadLine();

Console.WriteLine("Uploading {0} to {1} ...",fileName,uriString);						
// Upload the file to the URL using the HTTP 1.0 POST.
byte[] responseArray = myWebClient.UploadFile(uriString,"POST",fileName);

// Decode and display the response.
Console.WriteLine("\nResponse Received. The contents of the file uploaded are:\n{0}",
    System.Text.Encoding.ASCII.GetString(responseArray));



Console.Write(ControlChars.Cr + "Please enter the URL to post data to : ")
Dim uriString As String = Console.ReadLine()

' Create a new WebClient instance.
Dim myWebClient As New WebClient()
Console.WriteLine(ControlChars.Cr & _
    "Please enter the fully qualified path of the file to be uploaded to the URL")

Dim fileName As String = Console.ReadLine()
Console.WriteLine("Uploading {0} to {1} ...", fileName, uriString)

' Upload the file to the Url using the HTTP 1.0 POST.
Dim responseArray As Byte() = myWebClient.UploadFile(uriString, "POST", fileName)

' Decode and display the response.
Console.WriteLine(ControlChars.Cr + "Response Received. The contents of the file uploaded are: " & _
    ControlChars.Cr & "{0}", System.Text.Encoding.ASCII.GetString(responseArray))

L’exemple de code suivant montre une page ASP.NET qui peut accepter les fichiers publiés et convient à une utilisation avec la méthode UploadFile. La page doit résider sur un serveur web. Son adresse fournit la valeur du paramètre address de la méthode UploadFile.

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="C#" runat=server>
void Page_Load(object sender, EventArgs e) {
    
    foreach(string f in Request.Files.AllKeys) {
        HttpPostedFile file = Request.Files[f];
        file.SaveAs("c:\\inetpub\\test\\UploadedFiles\\" + file.FileName);
    }	
}

</Script>
<html>
<body>
<p> Upload complete.  </p>
</body>
</html>

<%@ Import Namespace="System"%>
<%@ Import Namespace="System.IO"%>
<%@ Import Namespace="System.Net"%>
<%@ Import NameSpace="System.Web"%>

<Script language="VB" runat=server>
    Sub Page_Load(ByVal sender As Object, ByVal e As EventArgs)
        
        Dim f As String
        Dim file
        For Each f In Request.Files.AllKeys
            file = Request.Files(f)
            file.SaveAs("c:\inetpub\test\UploadedFiles\" & file.FileName)
        Next f
        
    End Sub

</Script>
<html>
<body>
<p> Upload complete. </p>
</body>
</html>

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.

Lorsque l’adresse spécifie une ressource HTTP, la méthode UploadFile envoie un fichier local à une ressource à l’aide de la méthode HTTP spécifiée dans le paramètre method et retourne toute réponse du serveur. Cette méthode bloque lors du chargement du fichier. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadFileAsync.

Si le paramètre method spécifie un verbe qui n’est pas compris par le serveur ou la ressource address, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

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 une chaîne vide, elle est ajoutée à address.

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.

S’applique à

UploadFile(Uri, String, String)

Source:
WebClient.cs
Source:
WebClient.cs
Source:
WebClient.cs

Charge le fichier local spécifié dans la ressource spécifiée, à l’aide de la méthode spécifiée.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::String ^ fileName);
public byte[] UploadFile (Uri address, string? method, string fileName);
public byte[] UploadFile (Uri address, string method, string fileName);
member this.UploadFile : Uri * string * string -> byte[]
Public Function UploadFile (address As Uri, method As String, fileName As String) As Byte()

Paramètres

address
Uri

URI de la ressource à recevoir.

method
String

Méthode utilisée pour envoyer le fichier à la ressource. Si null, la valeur par défaut est POST pour http et STOR pour ftp.

fileName
String

Fichier à envoyer à la ressource.

Retours

Byte[]

Tableau Byte contenant le corps de la réponse de la ressource.

Exceptions

ArgumentNullException

Le paramètre address est null.

-ou-

Le paramètre fileName est null.

WebException

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

-ou-

fileName est null, est Empty, contient des caractères non valides ou n’existe pas.

-ou-

Une erreur s’est produite lors du chargement du fichier.

-ou-

Il n’y a pas eu de réponse du serveur hébergeant la ressource.

-ou-

L’en-tête Content-type commence par multipart.

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.

Lorsque l’adresse spécifie une ressource HTTP, la méthode UploadFile envoie un fichier local à une ressource à l’aide de la méthode HTTP spécifiée dans le paramètre method et retourne toute réponse du serveur. Cette méthode bloque lors du chargement du fichier. Pour continuer à s’exécuter en attendant la réponse du serveur, utilisez l’une des méthodes UploadFileAsync.

Si le paramètre method spécifie un verbe qui n’est pas compris par le serveur ou la ressource address, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, une WebException est levée avec la propriété Status définie pour indiquer l’erreur.

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 une chaîne vide, elle est ajoutée à address.

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.

S’applique à