WebClient.UploadFile Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Transfère un fichier local à une ressource ayant l'URI spécifié.
Surcharges
UploadFile(String, String) |
Transfère le fichier local spécifié à une ressource ayant l'URI spécifié. |
UploadFile(Uri, String) |
Transfère le fichier local spécifié à une ressource ayant l'URI spécifié. |
UploadFile(String, String, String) |
Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode spécifiée. |
UploadFile(Uri, String, String) |
Transfère le fichier local spécifié vers la ressource spécifiée en utilisant la méthode spécifiée. |
UploadFile(String, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère le fichier local spécifié à une ressource ayant 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 devant recevoir le fichier. Par exemple, ftp://localhost/samplefile.txt.
- fileName
- String
Fichier à envoyer à la ressource. Par exemple, "samplefile.txt".
Retours
Tableau de Byte contenant le corps de la réponse de la ressource.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre fileName
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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 transfert du fichier.
- ou -
Il n'y avait pas 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 UploadFilede . 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 des fichiers publiés et qui peut être utilisée avec la UploadFile méthode . La page doit résider sur un serveur Web. Son adresse fournit la valeur du address
paramètre de la UploadFile méthode .
<%@ 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
La UploadFile méthode 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 se bloque lors du chargement du fichier. Pour poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une UploadFileAsync des méthodes .
La POST
méthode 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, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.
S’applique à
UploadFile(Uri, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère le fichier local spécifié à une ressource ayant 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 devant recevoir le fichier. Par exemple, ftp://localhost/samplefile.txt.
- fileName
- String
Fichier à envoyer à la ressource. Par exemple, "samplefile.txt".
Retours
Tableau de Byte contenant le corps de la réponse de la ressource.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre fileName
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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 transfert du fichier.
- ou -
Il n'y avait pas de réponse du serveur hébergeant la ressource.
- ou -
L'en-tête Content-type
commence par multipart
.
Remarques
La UploadFile méthode 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 se bloque lors du chargement du fichier. Pour poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une UploadFileAsync des méthodes .
La POST
méthode 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, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.
S’applique à
UploadFile(String, String, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère le fichier local spécifié vers la ressource spécifiée en utilisant 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 devant recevoir le fichier.
- method
- String
Méthode utilisée pour envoyer le fichier à la ressource. Si la valeur est null
, la valeur par défaut est POST pour http et STOR pour ftp.
- fileName
- String
Fichier à envoyer à la ressource.
Retours
Tableau de Byte contenant le corps de la réponse de la ressource.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre fileName
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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 transfert du fichier.
- ou -
Il n'y avait pas 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 UploadFilede . 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 des fichiers publiés et qui peut être utilisée avec la UploadFile méthode . La page doit résider sur un serveur Web. Son adresse fournit la valeur du address
paramètre de la UploadFile méthode .
<%@ 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
Lorsque address spécifie une ressource HTTP, la UploadFile méthode envoie un fichier local à une ressource à l’aide de la méthode HTTP spécifiée dans le method
paramètre et retourne toute réponse du serveur. Cette méthode se bloque lors du chargement du fichier. Pour poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une UploadFileAsync des méthodes .
Si le method
paramètre spécifie un verbe qui n’est pas compris par le serveur ou la address
ressource, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.
S’applique à
UploadFile(Uri, String, String)
- Source:
- WebClient.cs
- Source:
- WebClient.cs
- Source:
- WebClient.cs
Transfère le fichier local spécifié vers la ressource spécifiée en utilisant 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 devant recevoir le fichier.
- method
- String
Méthode utilisée pour envoyer le fichier à la ressource. Si la valeur est null
, la valeur par défaut est POST pour http et STOR pour ftp.
- fileName
- String
Fichier à envoyer à la ressource.
Retours
Tableau de Byte contenant le corps de la réponse de la ressource.
Exceptions
Le paramètre address
a la valeur null
.
- ou -
Le paramètre fileName
a la valeur null
.
L'URI formé en combinant la propriété BaseAddress et address
est non 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 transfert du fichier.
- ou -
Il n'y avait pas de réponse du serveur hébergeant la ressource.
- ou -
L'en-tête Content-type
commence par multipart
.
Remarques
Lorsque address spécifie une ressource HTTP, la UploadFile méthode envoie un fichier local à une ressource à l’aide de la méthode HTTP spécifiée dans le method
paramètre et retourne toute réponse du serveur. Cette méthode se bloque lors du chargement du fichier. Pour poursuivre l’exécution en attendant la réponse du serveur, utilisez l’une UploadFileAsync des méthodes .
Si le method
paramètre spécifie un verbe qui n’est pas compris par le serveur ou la address
ressource, les classes de protocole sous-jacentes déterminent ce qui se produit. En règle générale, un WebException est levée avec la Status propriété définie pour indiquer l’erreur.
Si la BaseAddress propriété n’est pas une chaîne vide (« ») et address
ne contient pas d’URI absolu, address
doit être un URI relatif qui est combiné avec BaseAddress pour former l’URI absolu des données demandées. Si la QueryString propriété n’est pas une chaîne vide, elle est ajoutée à address
.
Notes
Ce membre génère des informations de traçage lorsque vous activez le traçage réseau dans votre application. Pour plus d’informations, consultez Suivi réseau dans .NET Framework.
S’applique à
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez :Soumettre et afficher des commentaires pour