WebClient.UploadFile Methode

Definitie

Naamruimte:
System.Net
Assembly:
System.dll
Assembly:
netstandard.dll

Uploadt een lokaal bestand naar een resource met de opgegeven URI.

Overloads

Name Description
UploadFile(String, String)

Uploadt het opgegeven lokale bestand naar een resource met de opgegeven URI.
UploadFile(Uri, String)

Uploadt het opgegeven lokale bestand naar een resource met de opgegeven URI.
UploadFile(String, String, String)

Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de opgegeven methode.
UploadFile(Uri, String, String)

Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de opgegeven methode.

UploadFile(String, String)

Uploadt het opgegeven lokale bestand naar een resource met de opgegeven URI.

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()

Parameters

address
String

De URI van de resource om het bestand te ontvangen. Bijvoorbeeld ftp://localhost/samplefile.txt.

fileName
String

Het bestand dat naar de resource moet worden verzonden. Bijvoorbeeld'samplefile.txt'.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De fileName parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

fileName is null, is Empty, bevat ongeldige tekens of bestaat niet.

– of –

Er is een fout opgetreden tijdens het uploaden van het bestand.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type header begint met multipart.

Voorbeelden

In het volgende codevoorbeeld wordt het opgegeven bestand geüpload naar de opgegeven URI met behulp van UploadFile. Elk antwoord dat door de server wordt geretourneerd, wordt weergegeven op de 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))

In het volgende codevoorbeeld ziet u een ASP.NET pagina die geplaatste bestanden kan accepteren en geschikt is voor gebruik met de methode UploadFile. De pagina moet zich op een webserver bevinden. Het adres geeft de waarde voor de address parameter van de UploadFile methode.

<%@ 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>

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadFile methode verzendt een lokaal bestand naar een resource. Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Deze methode blokkeert tijdens het uploaden van het bestand. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadFileAsync server.

De POST methode wordt gedefinieerd door HTTP. Als de onderliggende aanvraag geen HTTP gebruikt en POST niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadFile(Uri, String)

Uploadt het opgegeven lokale bestand naar een resource met de opgegeven URI.

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()

Parameters

address
Uri

De URI van de resource om het bestand te ontvangen. Bijvoorbeeld ftp://localhost/samplefile.txt.

fileName
String

Het bestand dat naar de resource moet worden verzonden. Bijvoorbeeld'samplefile.txt'.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De fileName parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

fileName is null, is Empty, bevat ongeldige tekens of bestaat niet.

– of –

Er is een fout opgetreden tijdens het uploaden van het bestand.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type header begint met multipart.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

De UploadFile methode verzendt een lokaal bestand naar een resource. Deze methode gebruikt de STOR-opdracht om een FTP-resource te uploaden. Voor een HTTP-resource wordt de POST-methode gebruikt.

Deze methode blokkeert tijdens het uploaden van het bestand. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadFileAsync server.

De POST methode wordt gedefinieerd door HTTP. Als de onderliggende aanvraag geen HTTP gebruikt en POST niet wordt begrepen door de server, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadFile(String, String, String)

Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de opgegeven methode.

public:
 cli::array <System::Byte> ^ UploadFile(System::String ^ address, System::String ^ method, System::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()

Parameters

address
String

De URI van de resource om het bestand te ontvangen.

method
String

De methode die wordt gebruikt om het bestand naar de resource te verzenden. Als null, de standaard is POST voor http en STOR voor FTP.

fileName
String

Het bestand dat naar de resource moet worden verzonden.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De fileName parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

fileName is null, is Empty, bevat ongeldige tekens of bestaat niet.

– of –

Er is een fout opgetreden tijdens het uploaden van het bestand.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type header begint met multipart.

Voorbeelden

In het volgende codevoorbeeld wordt het opgegeven bestand geüpload naar de opgegeven URI met behulp van UploadFile. Elk antwoord dat door de server wordt geretourneerd, wordt weergegeven op de 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))

In het volgende codevoorbeeld ziet u een ASP.NET pagina die geplaatste bestanden kan accepteren en geschikt is voor gebruik met de methode UploadFile. De pagina moet zich op een webserver bevinden. Het adres geeft de waarde voor de address parameter van de UploadFile methode.

<%@ 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>

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Wanneer het adres een HTTP-resource opgeeft, verzendt de UploadFile methode een lokaal bestand naar een resource met behulp van de HTTP-methode die is opgegeven in de method parameter en retourneert een antwoord van de server. Deze methode blokkeert tijdens het uploaden van het bestand. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadFileAsync server.

Als de method parameter een werkwoord opgeeft dat niet wordt begrepen door de server of de address resource, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op

UploadFile(Uri, String, String)

Uploadt het opgegeven lokale bestand naar de opgegeven resource met behulp van de opgegeven methode.

public:
 cli::array <System::Byte> ^ UploadFile(Uri ^ address, System::String ^ method, System::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()

Parameters

address
Uri

De URI van de resource om het bestand te ontvangen.

method
String

De methode die wordt gebruikt om het bestand naar de resource te verzenden. Als null, de standaard is POST voor http en STOR voor FTP.

fileName
String

Het bestand dat naar de resource moet worden verzonden.

Retouren

Byte[]

Een Byte matrix met de hoofdtekst van het antwoord van de resource.

Uitzonderingen

ArgumentNullException

De address parameter is null.

– of –

De fileName parameter is null.

WebException

De URI gevormd door combinatie BaseAddressen address is ongeldig.

– of –

fileName is null, is Empty, bevat ongeldige tekens of bestaat niet.

– of –

Er is een fout opgetreden tijdens het uploaden van het bestand.

– of –

Er is geen reactie van de server die als host fungeert voor de resource.

– of –

De Content-type header begint met multipart.

Opmerkingen

Caution

WebRequest, HttpWebRequest, ServicePointen WebClient zijn verouderd en u moet ze niet gebruiken voor nieuwe ontwikkeling. Gebruik in plaats daarvan HttpClient.

Wanneer het adres een HTTP-resource opgeeft, verzendt de UploadFile methode een lokaal bestand naar een resource met behulp van de HTTP-methode die is opgegeven in de method parameter en retourneert een antwoord van de server. Deze methode blokkeert tijdens het uploaden van het bestand. Gebruik een van de methoden om door te gaan terwijl u wacht op het antwoord van de UploadFileAsync server.

Als de method parameter een werkwoord opgeeft dat niet wordt begrepen door de server of de address resource, bepalen de onderliggende protocolklassen wat er gebeurt. Normaal gesproken wordt er een WebException gegenereerd met de Status eigenschap ingesteld om de fout aan te geven.

Als de BaseAddress eigenschap geen lege tekenreeks ("") is en address geen absolute URI bevat, address moet dit een relatieve URI zijn die wordt gecombineerd met BaseAddress de absolute URI van de aangevraagde gegevens. Als de QueryString eigenschap geen lege tekenreeks is, wordt deze toegevoegd aan address.

Note

Dit lid voert traceringsgegevens uit wanneer u netwerktracering inschakelt in uw toepassing. Zie Network Tracing in .NET Framework voor meer informatie.

Van toepassing op