My.Computer.Network.UploadFile 메서드

아티클
08/20/2008

업데이트: 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 형식이며 인증 자격 증명입니다.

예외

다음 조건에서 예외가 발생합니다.

로컬 파일 경로가 잘못된 경우(ArgumentException)
connectionTimeout이 0보다 작거나 같은 경우(ArgumentException)
address에 파일 이름이 포함되지 않은 경우(InvalidOperationException)
인증에 실패한 경우(SecurityException)
사용자에게 필요한 권한이 없는 경우(SecurityException)
연결 시간이 초과된 경우(TimeoutException)
웹 사이트에서 요청을 거부한 경우(WebException)

설명

showUI가 True로 설정된 경우 대화 상자에 작업 진행률이 표시되고 사용자가 작업을 취소하기 위해 클릭할 수 있는 취소 단추가 표시됩니다. 대화 상자가 모달이 아니므로 프로그램에서 다른 창에 대한 사용자 입력을 차단하지 않습니다.

서버가 connectionTimeout에 지정된 간격 내에 응답하지 않으면 작업이 취소되고 예외가 throw됩니다.

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 컨트롤 라이브러리	예
웹 컨트롤 라이브러리	예
Windows 서비스	예
웹 사이트	예

권한

다음과 같은 사용 권한이 필요합니다.

권한	설명
FileIOPermission	파일 및 폴더에 대한 액세스 가능성을 제어합니다. 연관된 열거형: Unrestricted
UIPermission	사용자 인터페이스 및 클립보드와 관련된 권한을 제어합니다. 연관된 열거형: AllWindows
WebPermission	HTTP 인터넷 리소스에 액세스할 수 있는 권한을 제어합니다. 연관된 열거형: Unrestricted