Network.UploadFile 方法

定義

命名空間:

Microsoft.VisualBasic.Devices

組件:

Microsoft.VisualBasic.Forms.dll

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

多載

UploadFile(String, String, String, String, Boolean, Int32, UICancelOption)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, String)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, String, String, String)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri, String, String)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri, ICredentials, Boolean, Int32)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, String, String, String, Boolean, Int32)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri, ICredentials, Boolean, Int32, UICancelOption)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri, String, String, Boolean, Int32)	將指定的檔案傳送到指定的主機位址。
UploadFile(String, Uri, String, String, Boolean, Int32, UICancelOption)	將指定的檔案傳送到指定的主機位址。

UploadFile(String, String, String, String, Boolean, Int32, UICancelOption)

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

public:
 void UploadFile(System::String ^ sourceFileName, System::String ^ address, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void UploadFile (string sourceFileName, string address, string userName, string password, bool showUI, int connectionTimeout, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.UploadFile : string * string * string * string * bool * int * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub UploadFile (sourceFileName As String, address As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, onUserCancel As UICancelOption)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

String

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

showUI

Boolean

是否顯示作業的進度。 預設為 False。

connectionTimeout

Int32

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

onUserCancel

UICancelOption

使用者按一下 [取消] 時所要採取的動作。 預設為 ThrowException。

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含 [ 取消 ] 按鈕，使用者可以按下以取消作業。 因為對話框不是強制回應，所以不會封鎖使用者輸入程式中的其他視窗。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, String)

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

public:
 void UploadFile(System::String ^ sourceFileName, System::String ^ address);

public void UploadFile (string sourceFileName, string address);

member this.UploadFile : string * string -> unit

Public Sub UploadFile (sourceFileName As String, address As String)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

String

目的伺服器的 URL、IP 位址或 URI。

例外狀況

ArgumentException

來源檔案路徑不是有效的。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在預設的逾時 (100 秒) 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

您可以使用 方法的其中一個其他多載 UploadFile 來提供使用者認證或指定特定的逾時值。

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

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address);

public void UploadFile (string sourceFileName, Uri address);

member this.UploadFile : string * Uri -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

例外狀況

ArgumentException

來源檔案路徑不是有效的。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在預設的逾時 (100 秒) 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

您可以使用 方法的其中一個其他多載 UploadFile 來提供使用者認證或指定特定的逾時值。

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

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, String, String, String)

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

public:
 void UploadFile(System::String ^ sourceFileName, System::String ^ address, System::String ^ userName, System::String ^ password);

public void UploadFile (string sourceFileName, string address, string userName, string password);

member this.UploadFile : string * string * string * string -> unit

Public Sub UploadFile (sourceFileName As String, address As String, userName As String, password As String)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

String

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在預設的逾時 (100 秒) 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

您可以使用 方法的其中一個其他多載 UploadFile 來指定特定的逾時值。

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri, String, String)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address, System::String ^ userName, System::String ^ password);

public void UploadFile (string sourceFileName, Uri address, string userName, string password);

member this.UploadFile : string * Uri * string * string -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri, userName As String, password As String)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在預設的逾時 (100 秒) 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

您可以使用 方法的其中一個其他多載 UploadFile 來指定特定的逾時值。

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri, ICredentials, Boolean, Int32)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout);

public void UploadFile (string sourceFileName, Uri address, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout);

member this.UploadFile : string * Uri * System.Net.ICredentials * bool * int -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

networkCredentials

ICredentials

用於驗證的認證。

showUI

Boolean

若要顯示作業進度，則為 True，否則為 False。 預設為 False。

connectionTimeout

Int32

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

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含使用者可以按下以取消作業的 [ 取消 ] 按鈕。 因為對話框不是強制回應，所以不會封鎖程式內其他視窗的用戶輸入。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, String, String, String, Boolean, Int32)

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

public:
 void UploadFile(System::String ^ sourceFileName, System::String ^ address, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout);

public void UploadFile (string sourceFileName, string address, string userName, string password, bool showUI, int connectionTimeout);

member this.UploadFile : string * string * string * string * bool * int -> unit

Public Sub UploadFile (sourceFileName As String, address As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

String

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

showUI

Boolean

若要顯示作業進度，則為 True，否則為 False。 預設為 False。

connectionTimeout

Int32

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

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含使用者可以按下以取消作業的 [ 取消 ] 按鈕。 因為對話框不是強制回應，所以不會封鎖程式內其他視窗的用戶輸入。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri, ICredentials, Boolean, Int32, UICancelOption)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void UploadFile (string sourceFileName, Uri address, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.UploadFile : string * Uri * System.Net.ICredentials * bool * int * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, onUserCancel As UICancelOption)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

networkCredentials

ICredentials

用於驗證的認證。

showUI

Boolean

若要顯示作業進度，則為 True，否則為 False。 預設為 False。

connectionTimeout

Int32

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

onUserCancel

UICancelOption

使用者按一下 [取消] 時所要採取的動作。 預設為 ThrowException。

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含使用者可以按下以取消作業的 [ 取消 ] 按鈕。 因為對話框不是強制回應，所以不會封鎖程式內其他視窗的用戶輸入。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri, String, String, Boolean, Int32)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout);

public void UploadFile (string sourceFileName, Uri address, string userName, string password, bool showUI, int connectionTimeout);

member this.UploadFile : string * Uri * string * string * bool * int -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

showUI

Boolean

若要顯示作業進度，則為 True，否則為 False。 預設為 False。

connectionTimeout

Int32

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

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含使用者可以按下以取消作業的 [ 取消 ] 按鈕。 因為對話框不是強制回應，所以不會封鎖程式內其他視窗的用戶輸入。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑

UploadFile(String, Uri, String, String, Boolean, Int32, UICancelOption)

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

public:
 void UploadFile(System::String ^ sourceFileName, Uri ^ address, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void UploadFile (string sourceFileName, Uri address, string userName, string password, bool showUI, int connectionTimeout, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.UploadFile : string * Uri * string * string * bool * int * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub UploadFile (sourceFileName As String, address As Uri, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, onUserCancel As UICancelOption)

參數

sourceFileName

String

要上載的檔案其路徑和名稱。

address

Uri

目的伺服器的 URL、IP 位址或 URI。

userName

String

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

password

String

要驗證的密碼。 預設值為空字串：""。

showUI

Boolean

是否顯示作業的進度。 預設為 False。

connectionTimeout

Int32

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

onUserCancel

UICancelOption

使用者按一下 [取消] 時所要採取的動作。 預設為 ThrowException。

例外狀況

ArgumentException

connectionTimeout 小於或等於零。

InvalidOperationException

address 不含檔案名稱。

SecurityException

使用者缺乏執行網路作業的必要權限。

TimeoutException

伺服器沒有在指定的 connectionTimeout 內回應。

WebException

目標 Web 伺服器拒絕該要求。

範例

這個範例會將檔案 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)

備註

如果 showUI 設定為 True，則對話框會顯示作業的進度，並包含 [ 取消 ] 按鈕，使用者可以按下以取消作業。 因為對話框不是強制回應，所以不會封鎖使用者輸入程式中的其他視窗。

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

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

注意

FTP 通訊協定會以純文本傳送資訊，包括密碼，不應用於傳輸敏感性資訊。

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

收件者	請參閱
上傳檔案	作法：上傳檔案

另請參閱

• Uri
• ICredentials
• UICancelOption
• 物件 (Visual Basic)
• 如何：在 Visual Basic 中下載檔案
• 如何：在 Visual Basic 中剖析檔案路徑