My.Computer.Network.UploadFile (Método)

Actualización: noviembre 2007

Envía el archivo especificado a la dirección del host especificada.

' 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. Ruta de acceso y nombre del archivo que se va a cargar. Obligatorio.

• address
  String o Uri Dirección URL, dirección IP o identificador URI del servidor de destino. Obligatorio.

• userName
  String. Nombre de usuario que se va a autenticar. El valor predeterminado es una cadena vacía: "".

• password
  String. Contraseña que se va a autenticar. El valor predeterminado es una cadena vacía: "".

• showUI
  Boolean. Si se va a mostrar el progreso de la operación. El valor predeterminado es False.

• connectionTimeout
  Int32. Intervalo de tiempo de espera en milisegundos. El valor predeterminado es 100 segundos.

• onUserCancel
  UICancelOption. Acción que se debe realizar cuando el usuario hace clic en Cancelar. El valor predeterminado es ThrowException.

• networkCredentials
  ICredentials. Credenciales de autenticación.

Excepciones

Las condiciones siguientes pueden producir una excepción:

• La ruta de acceso local no es válida (ArgumentException).

• connectionTimeout es menor o igual que cero (ArgumentException).

• address no incluye un nombre de archivo (InvalidOperationException).

• Se produjo un error en la autenticación (SecurityException).

• El usuario no tiene los permisos necesarios (SecurityException).

• Se ha agotado el tiempo de espera de conexión (TimeoutException).

• El sitio Web deniega la solicitud (WebException).

Comentarios

Si showUI está establecido en True, un cuadro de diálogo mostrará el progreso de la operación; en él se incluye un botón Cancelar en el que puede hacer clic el usuario para cancelar la operación. Dado que el cuadro de diálogo no es modal, no bloquea los datos proporcionados por el usuario a las otras ventanas del programa.

Si el servidor no responde dentro del intervalo especificado en connectionTimeout, se cancelará la operación y se producirá una excepción.

My.Computer.Network.UploadFile genera información de seguimiento al habilitar el seguimiento de la red en su aplicación. Para obtener más información, vea Enabling Network Tracing.

Nota de seguridad:
El protocolo FTP envía información, incluidas las contraseñas, en texto sin formato y no se debería utilizar para transmitir información confidencial.

Tareas

En la tabla siguiente se incluye un ejemplo de una tarea en la que interviene el método My.Computer.Network.UploadFile.

Ejemplo

En este ejemplo se carga el archivo Order.txt en http://www.cohowinery.com/uploads.

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

Este ejemplo carga el archivo Order.txt en http://www.cohowinery.com/uploads sin proporcionar ningún nombre de usuario ni contraseña, muestra el progreso de la carga y tiene un tiempo de espera de 500 milisegundos.

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

Requisitos

Espacio de nombres:Microsoft.VisualBasic.Devices

Clase:Network

Ensamblado: biblioteca en tiempo de ejecución de Visual Basic (en Microsoft.VisualBasic.dll)

Disponibilidad por tipo de proyecto

Permisos

Los permisos siguientes pueden ser necesarios:

Para obtener más información, vea Seguridad de acceso a código y Solicitar permisos.

Vea también

Tareas

Cómo: Descargar un archivo en Visual Basic

Cómo: Analizar rutas de acceso a archivos en Visual Basic

Referencia

My.Computer.Network (Objeto)

System.Uri

System.Net.ICredentials

Microsoft.VisualBasic.FileIO.UICancelOption

Network.UploadFile