Condividi tramite


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:

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

Procedura: caricare un file in Visual Basic

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

Libreria di classi

Applicazione di console

Libreria di controlli Windows

Libreria di controllo Web

Servizio Windows

Sito Web

Autorizzazioni

Possono essere necessarie le autorizzazioni seguenti:

Autorizzazione

Descrizione

FileIOPermission

Controlla la possibilità di accedere ai file e alle cartelle. Enumerazione associata: Unrestricted.

UIPermission

Controlla le autorizzazioni correlate alle interfacce utente e agli Appunti. Enumerazione associata: AllWindows.

WebPermission

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

Riferimenti

Oggetto My.Computer.Network

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile