Metodo My.Computer.Network.UploadFile
Aggiornamento: novembre 2007
Invia il file specificato all'indirizzo host specificato.
' Usage
My.Computer.Network.UploadFile(sourceFileName ,address)
My.Computer.Network.UploadFile(sourceFileName ,address)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout ,onUserCancel)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout ,onUserCancel)
My.Computer.Network.UploadFile(sourceFileName ,address ,networkCredentials ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,networkCredentials ,showUI ,connectionTimeout ,onUserCancel)
' Declaration
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As String _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As String, _
ByVal userName As String, _
ByVal password As String _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri, _
ByVal userName As String, _
ByVal password As String _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As String, _
ByVal userName As String, _
ByVal password As String, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As String, _
ByVal userName As String, _
ByVal password As String, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer, _
ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri, _
ByVal userName As String, _
ByVal password As String, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri, _
ByVal userName As String, _
ByVal password As String, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer, _
ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri, _
ByVal networkCredentials As System.Net.ICredentials, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
ByVal sourceFileName As String, _
ByVal address As System.Uri, _
ByVal networkCredentials As System.Net.ICredentials, _
ByVal showUI As Boolean, _
ByVal connectionTimeout As Integer, _
ByVal onUserCancel As UICancelOption _
)
Parametri
sourceFileName
String. Percorso e nome del file da caricare. Obbligatorio.address
String o Uri. URL, indirizzo IP o URI del server di destinazione. Obbligatorio.userName
String. Nome utente da autenticare. Il valore predefinito è una stringa vuota: "".password
String. Password da autenticare. Il valore predefinito è una stringa vuota: "".showUI
Boolean. Consente di specificare se visualizzare l'avanzamento dell'operazione. Il valore predefinito è False.connectionTimeout
Int32. Intervallo di timeout in millisecondi. Il valore predefinito è 100 secondi.onUserCancel
UICancelOption. Azione da intraprendere quando l'utente fa clic su Annulla. Il valore predefinito è ThrowException.networkCredentials
ICredentials. Credenziali per l'autenticazione.
Eccezioni
Le seguenti condizioni possono generare un'eccezione:
Il percorso del file locale non è valido (ArgumentException).
connectionTimeout è minore o uguale a zero (ArgumentException).
address non include un nome file (InvalidOperationException).
Autenticazione non riuscita (SecurityException).
L'utente non dispone delle autorizzazioni necessarie (SecurityException).
Si è verificato il time out della connessione (TimeoutException).
Richiesta negata dal sito Web (WebException).
Note
Se l'oggetto showUI è impostato su True, viene visualizzata una finestra di dialogo che mostra l'avanzamento dell'operazione e include un pulsante Annulla che consente di annullare l'operazione. Poiché la finestra di dialogo non è modale, non blocca l'input dell'utente in altre finestre del programma.
Se il server non risponde entro l'intervallo specificato in connectionTimeout, l'operazione viene annullata e viene generata un'eccezione.
My.Computer.Network.UploadFile genera informazioni di analisi quando si attiva l'analisi della rete nell'applicazione. Per ulteriori informazioni, vedere Enabling Network Tracing.
Nota sulla sicurezza: |
---|
Il protocollo FTP invia informazioni, comprese le password, in testo normale e non deve essere utilizzato per la trasmissione di informazioni riservate. |
Attività
Nella tabella riportata di seguito sono elencati esempi di attività che richiedono l'utilizzo del metodo My.Computer.Network.UploadFile.
Per |
Vedere |
---|---|
Caricare un file |
Esempio
Nell'esempio il file Order.txt viene caricato in http://www.cohowinery.com/uploads.
My.Computer.Network.UploadFile ( "C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx")
In questo esempio, il file Order.txt viene caricato in http://www.cohowinery.com/uploads senza fornire il nome utente o la password e l'avanzamento dell'operazione viene visualizzato con un intervallo di time out di 500 millisecondi.
My.Computer.Network.UploadFile ("C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx","","",True,500)
Requisiti
Spazio dei nomi:Microsoft.VisualBasic.Devices
Classe:Network
Assembly: libreria di runtime di Visual Basic (in Microsoft.VisualBasic.dll)
Disponibilità in base al tipo di progetto
Tipo di progetto |
Disponibile |
---|---|
Applicazione Windows |
Sì |
Libreria di classi |
Sì |
Applicazione di console |
Sì |
Libreria di controlli Windows |
Sì |
Libreria di controllo Web |
Sì |
Servizio Windows |
Sì |
Sito Web |
Sì |
Autorizzazioni
Possono essere necessarie le autorizzazioni seguenti:
Autorizzazione |
Descrizione |
---|---|
Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted. |
|
Controlla le autorizzazioni correlate alle interfacce utente e agli Appunti. Enumerazione associata: AllWindows. |
|
Controlla i diritti di accesso alle risorse Internet HTTP. Enumerazione associata: Unrestricted. |
Per ulteriori informazioni, vedere Protezione dall'accesso di codice e Richiesta di autorizzazioni.
Vedere anche
Attività
Procedura: scaricare file in Visual Basic
Procedura: analizzare percorsi di file in Visual Basic