Метод My.Computer.Network.UploadFile

Обновлен: Ноябрь 2007

Отправляет указанный файл на адрес указанного узла.

' 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 меньше или равен нулю (ArgumentException).

• address не содержит имя файла (InvalidOperationException).

• Проверка подлинности не пройдена (SecurityException).

• Пользователь не имеет необходимых разрешений (SecurityException).

• Время ожидания подключения истекло (TimeoutException).

• Веб-узел отклоняет запрос (WebException).

Заметки

Если showUI задано значение True, диалоговое окно показывает ход выполнения операции и содержит кнопку Отмена, которую пользователь может нажать, чтобы отменить операцию. Поскольку диалоговое окно не является модальным, оно не блокирует ввод данных в другие окна в программе.

Если сервер не отвечает в течение интервала, указанного в connectionTimeout, операция отменяется и создается исключение.

My.Computer.Network.UploadFile выводит сведения трассировки при включении функции трассировки сети в приложении. Дополнительные сведения см. в разделе Enabling Network Tracing.

Примечание о безопасности.
Протокол FTP отправляет данные, включая пароли, в формате обычного текста и не может использоваться для передачи важных сведений.

Задачи

В следующей таблице содержится пример задачи, в которой используется метод My.Computer.Network.UploadFile.

Пример

В этом примере файл 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)

Доступность по типу проекта

Разрешения

Могут потребоваться следующие разрешения.

Дополнительные сведения см. в разделах Управление доступом для кода и Запрос разрешений.

См. также

Задачи

Практическое руководство. Загрузка файла в Visual Basic

Практическое руководство. Анализ путей к файлам в Visual Basic

Ссылки

Объект My.Computer.Network

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile