共用方式為

My.Computer.Network.UploadFile 方法

  • 發行項

更新：2007 年 11 月

將指定的檔案傳送到指定的主機位址。

 ' 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 _ )

參數

  • sourceFileName
    String。要上載的檔案路徑和名稱。必要項。

  • address
    String 或 Uri。目的伺服器的 URL、IP 位址或 URI。必要項。

  • userName
    String。要驗證的使用者名稱。預設為空字串：""。

  • password
    String。要驗證的密碼。預設為空字串：""。

  • showUI
    Boolean。是否顯示作業的進度。預設值為 False。

  • connectionTimeout
    Int32。逾時間隔 (以毫秒為單位)。預設值為 100 秒。

  • onUserCancel
    UICancelOption。當使用者按一下 [取消] 時要採取的動作。預設值為 ThrowException。

  • networkCredentials
    ICredentials。驗證的認證。

例外狀況

下列情形可能會造成例外狀況：

備註

如果 showUI 設為 True，則會出現一個對話方塊，顯示出作業的進度並包括 [取消] 按鈕，使用者可以按一下這個按鈕取消作業。因為對話方塊不是強制回應 (Modal) 的，所以它不會封鎖使用者對程式中其他視窗的輸入。

如果伺服器在 connectionTimeout 指定的間隔內沒有回應，作業將會取消，並擲回例外狀況。

當您在應用程式中啟用網路追蹤時，My.Computer.Network.UploadFile 會輸出追蹤資訊。如需詳細資訊，請參閱啟用網路追蹤。

安全性注意事項：

FTP 通訊協定 (Protocol) 會以純文字傳送資訊 (包括密碼)，因此不應該用於傳輸機密資訊。

工作

下表列出包含 My.Computer.Network.UploadFile 方法的工作範例。

若要

請參閱

上載檔案

HOW TO：在 Visual Basic 中上載檔案

範例

這個範例會將檔案 Order.txt 上載到 http://www.cohowinery.com/uploads。

My.Computer.Network.UploadFile ( "C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx")

這個範例會在不提供使用者名稱或密碼的情況下，將檔案 Order.txt 上載到 http://www.cohowinery.com/uploads，同時顯示上載進度，並具有 500 毫秒的逾時間隔。

My.Computer.Network.UploadFile ("C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx","","",True,500)

需求

命名空間：Microsoft.VisualBasic.Devices

類別︰Network

組件：Visual Basic 執行階段程式庫 (在 Microsoft.VisualBasic.dll 中)

依專案類型的可用性

專案類型

是否可用

Windows 應用程式

是

類別庫

是

主控台應用程式

是

Windows 控制項程式庫

是

Web 控制項程式庫

是

Windows 服務

是

網站

是

使用權限

下列使用權限可能為必要：

使用權限

描述

FileIOPermission

控制存取檔案和資料夾的功能。關聯的列舉型別：Unrestricted。

UIPermission

控制與使用者介面和剪貼簿相關的使用權限。關聯的列舉型別：AllWindows。

WebPermission

控制存取 HTTP 網際網路資源的權限。關聯的列舉型別：Unrestricted。

如需詳細資訊，請參閱程式碼存取安全性和要求使用權限。

請參閱

工作

HOW TO：在 Visual Basic 中下載檔案

HOW TO：在 Visual Basic 中剖析檔案路徑

參考

My.Computer.Network 物件

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile