WebClient.UploadFile WebClient.UploadFile WebClient.UploadFile WebClient.UploadFile Method

Definizione

Carica un file locale su una risorsa con l'URI specificato.Uploads a local file to a resource with the specified URI.

Overload

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

Carica il file locale specificato in una risorsa con l'URI specificato.Uploads the specified local file to a resource with the specified URI.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

Carica il file locale specificato in una risorsa con l'URI specificato.Uploads the specified local file to a resource with the specified URI.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

Carica il file locale specificato sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified local file to the specified resource, using the specified method.

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

Carica il file locale specificato sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified local file to the specified resource, using the specified method.

UploadFile(String, String) UploadFile(String, String) UploadFile(String, String) UploadFile(String, String)

Carica il file locale specificato in una risorsa con l'URI specificato.Uploads the specified local file to a resource with the specified 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()

Parametri

address
String String String String

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Ad esempio, ftp://localhost/samplefile.txt.For example, ftp://localhost/samplefile.txt.

fileName
String String String String

Il file da inviare alla risorsa.The file to send to the resource. Ad esempio, "samplefile.txt".For example, "samplefile.txt".

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.A Byte array containing the body of the response from the resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi o non esiste.fileName is null, is Empty, contains invalid characters, or does not exist.

In alternativa-or- Si è verificato un errore durante l'upload del file.An error occurred while uploading the file.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Esempi

Esempio di codice seguente carica il file specificato per l'URI specificato utilizzando UploadFile.The following code example uploads the specified file to the specified URI using UploadFile. Qualsiasi risposta restituita dal server viene visualizzato nella console.Any response returned by the server is displayed on the 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))

Esempio di codice seguente mostra una pagina ASP.NET che può accettare file inseriti ed è adatto per l'uso con il UploadFile (metodo).The following code example shows an ASP.NET page that can accept posted files and is suitable for use with the UploadFile method. La pagina deve risiedere in un server Web.The page must reside on a Web server. Il relativo indirizzo fornisce il valore per il address parametro il UploadFile (metodo).Its address provides the value for the address parameter of the UploadFile method.

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

Commenti

Il UploadFile metodo invia un file locale a una risorsa.The UploadFile method sends a local file to a resource. Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Questo metodo si blocca durante il caricamento del file.This method blocks while uploading the file. Per continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadFileAsync metodi.To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

Il POST metodo è definito da HTTP.The POST method is defined by HTTP. Se la richiesta sottostante non Usa HTTP e POST non accettato dal server, le classi del protocollo sottostante è determineranno il risultato.If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicurezza

FileIOPermission
Per accedere al file locale.to access the local file. Enumerazione associata: Read.Associated enumeration: Read.

UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String) UploadFile(Uri, String)

Carica il file locale specificato in una risorsa con l'URI specificato.Uploads the specified local file to a resource with the specified 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()

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file. Ad esempio, ftp://localhost/samplefile.txt.For example, ftp://localhost/samplefile.txt.

fileName
String String String String

Il file da inviare alla risorsa.The file to send to the resource. Ad esempio, "samplefile.txt".For example, "samplefile.txt".

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.A Byte array containing the body of the response from the resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi o non esiste.fileName is null, is Empty, contains invalid characters, or does not exist.

In alternativa-or- Si è verificato un errore durante l'upload del file.An error occurred while uploading the file.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Il UploadFile metodo invia un file locale a una risorsa.The UploadFile method sends a local file to a resource. Questo metodo Usa il comando STOR per caricare una risorsa di FTP.This method uses the STOR command to upload an FTP resource. Per una risorsa HTTP, viene utilizzato il metodo POST.For an HTTP resource, the POST method is used.

Questo metodo si blocca durante il caricamento del file.This method blocks while uploading the file. Per continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadFileAsync metodi.To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

Il POST metodo è definito da HTTP.The POST method is defined by HTTP. Se la richiesta sottostante non Usa HTTP e POST non accettato dal server, le classi del protocollo sottostante è determineranno il risultato.If the underlying request does not use HTTP and POST is not understood by the server, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicurezza

FileIOPermission
Per accedere al file locale.to access the local file. Enumerazione associata: Read.Associated enumeration: Read.

UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String) UploadFile(String, String, String)

Carica il file locale specificato sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified local file to the specified resource, using the specified method.

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

Parametri

address
String String String String

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file.

method
String String String String

Il metodo utilizzato per inviare il file alla risorsa.The method used to send the file to the resource. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

fileName
String String String String

Il file da inviare alla risorsa.The file to send to the resource.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.A Byte array containing the body of the response from the resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi o non esiste.fileName is null, is Empty, contains invalid characters, or does not exist.

In alternativa-or- Si è verificato un errore durante l'upload del file.An error occurred while uploading the file.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Esempi

Esempio di codice seguente carica il file specificato per l'URI specificato utilizzando UploadFile.The following code example uploads the specified file to the specified URI using UploadFile. Qualsiasi risposta restituita dal server viene visualizzato nella console.Any response returned by the server is displayed on the 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))

Esempio di codice seguente mostra una pagina ASP.NET che può accettare file inseriti ed è adatto per l'uso con il UploadFile (metodo).The following code example shows an ASP.NET page that can accept posted files and is suitable for use with the UploadFile method. La pagina deve risiedere in un server Web.The page must reside on a Web server. Il relativo indirizzo fornisce il valore per il address parametro il UploadFile (metodo).Its address provides the value for the address parameter of the UploadFile method.

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

Commenti

Se l'indirizzo specifica una risorsa HTTP, il UploadFile metodo invia un file locale a una risorsa tramite il metodo HTTP specificato nella method parametro e restituisce una risposta dal server.When address specifies an HTTP resource, the UploadFile method sends a local file to a resource using the HTTP method specified in the method parameter and returns any response from the server. Questo metodo si blocca durante il caricamento del file.This method blocks while uploading the file. Per continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadFileAsync metodi.To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

Se il method parametro specifica un verbo non riconosciuto dal server o il address risorsa, le classi del protocollo sottostante è determineranno il risultato.If the method parameter specifies a verb that is not understood by the server or the address resource, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicurezza

FileIOPermission
Per accedere al file locale.to access the local file. Enumerazione associata: ReadAssociated enumeration: Read

UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String) UploadFile(Uri, String, String)

Carica il file locale specificato sulla risorsa specificata utilizzando il metodo specificato.Uploads the specified local file to the specified resource, using the specified method.

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

Parametri

address
Uri Uri Uri Uri

L'URI della risorsa per ricevere il file.The URI of the resource to receive the file.

method
String String String String

Il metodo utilizzato per inviare il file alla risorsa.The method used to send the file to the resource. Se null l'impostazione predefinita sarà POST per http e STOR per ftp.If null, the default is POST for http and STOR for ftp.

fileName
String String String String

Il file da inviare alla risorsa.The file to send to the resource.

Restituisce

Byte[]

Matrice Byte contenente il corpo della risposta dalla risorsa.A Byte array containing the body of the response from the resource.

Eccezioni

Il valore del parametro address è null.The address parameter is null.

In alternativa-or- Il valore del parametro fileName è null.The fileName parameter is null.

L'URI composto dalla combinazione di BaseAddress e address non è valido.The URI formed by combining BaseAddress, and address is invalid.

In alternativa-or- fileName è null, è Empty, contiene caratteri non validi o non esiste.fileName is null, is Empty, contains invalid characters, or does not exist.

In alternativa-or- Si è verificato un errore durante l'upload del file.An error occurred while uploading the file.

In alternativa-or- Nessuna risposta dal server che ospita la risorsa.There was no response from the server hosting the resource.

In alternativa-or- L'intestazione Content-type inizia con multipart.The Content-type header begins with multipart.

Commenti

Se l'indirizzo specifica una risorsa HTTP, il UploadFile metodo invia un file locale a una risorsa tramite il metodo HTTP specificato nella method parametro e restituisce una risposta dal server.When address specifies an HTTP resource, the UploadFile method sends a local file to a resource using the HTTP method specified in the method parameter and returns any response from the server. Questo metodo si blocca durante il caricamento del file.This method blocks while uploading the file. Per continuare l'esecuzione durante l'attesa di risposta del server, usare uno del UploadFileAsync metodi.To continue executing while waiting for the server's response, use one of the UploadFileAsync methods.

Se il method parametro specifica un verbo non riconosciuto dal server o il address risorsa, le classi del protocollo sottostante è determineranno il risultato.If the method parameter specifies a verb that is not understood by the server or the address resource, the underlying protocol classes determine what occurs. In genere, un WebException viene generata un'eccezione con il Status proprietà impostata per indicare l'errore.Typically, a WebException is thrown with the Status property set to indicate the error.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto address deve essere un URI relativo che viene combinato con BaseAddress in modo da formare l'URI assoluto dei dati richiesti.If the BaseAddress property is not an empty string ("") and address does not contain an absolute URI, address must be a relative URI that is combined with BaseAddress to form the absolute URI of the requested data. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.If the QueryString property is not an empty string, it is appended to address.

Nota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso.This member outputs trace information when you enable network tracing in your application. Per altre informazioni, vedere la traccia di rete in .NET Framework.For more information, see Network Tracing in the .NET Framework.

Sicurezza

FileIOPermission
Per accedere al file locale.to access the local file. Enumerazione associata: ReadAssociated enumeration: Read

Si applica a