Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Metodo WebClient.UploadFile (String, String, String)

 

Data di pubblicazione: ottobre 2016

Carica il file locale specificato per la risorsa specificata, utilizzando il metodo specificato.

Spazio dei nomi:   System.Net
Assembly:  System (in System.dll)

public byte[] UploadFile(
	string address,
	string method,
	string fileName
)

Parametri

address
Type: System.String

L'URI della risorsa per ricevere il file.

method
Type: System.String

Il metodo utilizzato per inviare il file della risorsa. Se null, il valore predefinito è POST per http e la archivia per ftp.

fileName
Type: System.String

File da inviare alla risorsa.

Valore restituito

Type: System.Byte[]

Oggetto Byte matrice contenente il corpo della risposta dalla risorsa.

Exception Condition
ArgumentNullException

Il valore del parametro address è null.

-oppure-

Il valore del parametro fileName è null.

WebException

L'URI formato dalla combinazione BaseAddress, e address non è valido.

-oppure-

fileName è null, è Empty, contiene caratteri non validi o non esiste.

-oppure-

Si è verificato un errore durante il caricamento del file.

-oppure-

Si è verificato alcuna risposta dal server che ospita la risorsa.

-oppure-

Il Content-type intestazione inizia con multipart.

Se l'indirizzo specifica una risorsa HTTP, il UploadFile metodo invia un file locale a una risorsa utilizzando il metodo HTTP specificato nella method parametro e restituisce una risposta dal server. Questo metodo si blocca durante il caricamento del file. Per continuare l'esecuzione in attesa di risposta del server, utilizzare uno del UploadFileAsync metodi.

Se il method parametro specifica un verbo non accettato dal server o address risorse, le classi del protocollo sottostante determineranno le conseguenze. In genere, un WebException viene generata un'eccezione con il Status impostata per indicare l'errore.

Se il BaseAddress proprietà non è una stringa vuota ("") e address non contiene un URI assoluto, address deve essere un URI relativo viene combinato con BaseAddress per formare l'URI assoluto dei dati richiesti. Se il QueryString proprietà non è una stringa vuota, questo viene aggiunto a address.

System_CAPS_noteNota

Questo membro genera informazioni di traccia quando viene abilitata la funzionalità di traccia di rete nell'applicazione in uso. Per altre informazioni, vedere Tracciatura di rete in .NET Framework.

Esempio di codice seguente carica il file specificato sull'URI specificato utilizzando UploadFile. Qualsiasi risposta restituita dal server viene visualizzato nella console.

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

Esempio di codice seguente viene illustrata una pagina ASP.NET che può accettare file inseriti ed è adatto per l'utilizzo con il UploadFile metodo. La pagina deve risiedere in un server Web. Il relativo indirizzo fornisce il valore per il address parametro il UploadFile metodo.

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

FileIOPermission

to access the local file. Associated enumeration: F:System.Security.Permissions.FileIOPermissionAccess.Read

.NET Framework
Disponibile da 1.1
Torna all'inizio
Mostra: