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 を設定すると、処理の進行状況を示すダイアログ ボックスが表示されます。ここにはユーザーが処理をキャンセルするときにクリックする [キャンセル] ボタンも表示されます。このダイアログ ボックスはモーダルではないため、ユーザーがプログラム内の他のウィンドウに入力できなくなることはありません。

connectionTimeout で指定された時間内にサーバーが応答しない場合は、処理がキャンセルされ、例外がスローされます。

My.Computer.Network.UploadFile は、アプリケーションのネットワーク トレースが可能になっている場合に、トレース情報を出力します。詳細については、「ネットワーク トレースの有効化」を参照してください。

セキュリティに関するメモ :

FTP プロトコルは、情報を (パスワードを含めて) プレーンテキストで送信します。このため、機密情報を転送する際には使用しないでください。

処理手順

My.Computer.Network.UploadFile メソッドに関連するタスクの例を次の表に示します。

目的

参照項目

ファイルのアップロード

方法 : 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 サービス

あり

Web サイト

あり

アクセス許可

次のアクセス許可が必要になる可能性があります。

アクセス許可

説明

FileIOPermission

ファイルとフォルダへのアクセス許可を制御します。関連する列挙値 : Unrestricted。

UIPermission

ユーザー インターフェイスとクリップボードに関連するアクセス許可を制御します。関連する列挙値 : AllWindows。

WebPermission

HTTP インターネット リソースにアクセスするための権限を制御します。関連する列挙値 : Unrestricted。

詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。

参照

処理手順

方法 : Visual Basic でファイルをダウンロードする

方法 : Visual Basic でファイル パスを解析する

参照

My.Computer.Network オブジェクト

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile