Método My.Computer.Network.UploadFile

Artigo
08/25/2010

Envia o arquivo especificado para o endereço do host especificado.

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

Parâmetros

sourceFileName
String.Caminho e nome do arquivo a ser carregado.Obrigatório.
address
String ou Uri. URL, IP endereço ou o URI do servidor de destino.Obrigatório.
userName
String.Nome de usuário para autenticar.Padrão é uma seqüência de caracteres vazia: "".
password
String.Senha para autenticar.Padrão é uma seqüência de caracteres vazia: "".
showUI
Boolean.Se deseja exibir o progresso da operação.O padrão é False.
connectionTimeout
Int32.Intervalo de tempo limite em milissegundos.Padrão é 100 segundos.
onUserCancel
UICancelOption.Ação a ser tomada quando o usuário clica em Cancelar.O padrão é ThrowException.
networkCredentials
ICredentials.Credenciais de autenticação.

Exceções

As seguintes condições podem causar uma exceção:

O caminho do arquivo local é inválido (ArgumentException).
connectionTimeout é menor ou igual a zero (ArgumentException).
address não inclui um nome de arquivo (InvalidOperationException).
Falha de autenticação (SecurityException).
O usuário não possui as permissões necessárias (SecurityException).
A conexão expirou (TimeoutException).
O site nega a solicitação (WebException).

Comentários

Se showUI é definida como True,uma caixa de diálogo mostra o andamento da operação e inclui um botão Cancelar que o usuário pode clicar para cancelar a operação.Porque o caixa de diálogo não é restrita (modal), ela não bloqueia a entrada do usuário em outras janelas no programa.

Se o servidor não responder dentro do intervalo especificado em connectionTimeout,a operação será cancelada e será lançada uma exceção.

My.Computer.Network.UploadFile tem como saída o rastreamento de informações quando você ativa o rastreamento de rede em seu aplicativo.Para obter mais informações, consulte Habilitando o rastreamento de rede.

Observação de segurança:
O protocolo FTP envia informações, incluindo senhas, em texto sem-formatação e não deve ser usado para transmissão de informações sigilosas.

Tarefas

A tabela seguinte lista um exemplo de tarefa envolvendo o método My.Computer.Network.UploadFile.

Para	Consulte
Carregar um arquivo	Como: Carregar um arquivo no Visual Basic

Exemplo

Este exemplo faz o upload do arquivo Order.txt para http://www.cohowinery.com/uploads.

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

Este exemplo carrega o arquivo Order.txt para http://www.cohowinery.com/uploads sem fornecer um nome de usuário ou senha, mostra o andamento do carregamento e tem um intervalo de tempo limite de 500 milissegundos.

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

Requisitos

Namespace:Microsoft.VisualBasic.Devices

Classe:Network

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Disponibilidade por Tipo de Projeto

Tipo de Projeto	Disponível
Aplicativo do Windows	Sim
Biblioteca de Classe	Sim
Aplicativo de Console	Sim
Biblioteca de Controle do Windows	Sim
Biblioteca de Controle da Web	Sim
Serviço do Windows	Sim
Site	Sim

Permissões

As seguintes permissões podem ser necessárias:

Permissão	Descrição
FileIOPermission	Controla a habilidade de acesso a arquivos e pastas.Enumeração associada: Unrestricted.
UIPermission	Controla as permissões relacionadas às interfaces com o usuário e área de transferência.Enumeração associada: AllWindows.
WebPermission	Controla os direitos de acesso aos recursos de internet HTTP.Enumeração associada: Unrestricted.