Compartir a través de


My.Computer.FileSystem.MoveFile (Método)

Actualización: noviembre 2007

Mueve un archivo a una nueva ubicación.

' Usage
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.MoveFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveFile( _
   ByVal sourceFileName As String, _
   ByVal destinationFileName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parámetros

  • sourceFileName
    String. Ruta de acceso del archivo que se va a mover. Obligatorio.

  • destinationFileName
    String. Ruta de acceso del directorio al que se debe mover el archivo. Obligatorio.

  • overwrite
    Boolean. Especifica si se van a sobrescribir los archivos existentes. El valor predeterminado es False. Obligatorio.

  • showUI
    UIOption (Enumeración). Indica si se debe hacer un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs. Obligatorio.

  • onUserCancel
    UICancelOption (Enumeración). Especifica si se produce o no una excepción cuando el usuario cancela la operación. El valor predeterminado es UICancelOption.ThrowException. Obligatorio.

Excepciones

Las condiciones siguientes pueden producir una excepción:

  • La ruta de acceso no es válida por una de las razones siguientes: es una cadena de longitud cero; sólo contiene un espacio en blanco; contiene caracteres no válidos; o es una ruta de acceso de dispositivo (empieza por \\.\) (ArgumentException).

  • El nombre de archivo finaliza con una barra diagonal inversa (\) (ArgumentException).

  • La ruta de acceso no es válida porque es Nothing (ArgumentNullException).

  • destinationFileName es Nothing o una cadena vacía (ArgumentNullException).

  • El archivo de código fuente no es válido o no existe (FileNotFoundException).

  • La ruta de acceso combinada apunta a un directorio existente, el archivo de destino existe y overwrite está establecido en False, un archivo del directorio de destino que tiene el mismo nombre está en uso oel usuario no tiene permisos suficientes para tener acceso al archivo (IOException).

  • Un nombre de archivo o de directorio de la ruta de acceso contiene un signo de dos puntos (:) o tiene un formato no válido (NotSupportedException).

  • El parámetro onUserCancel está establecido en ThrowException y el usuario ha cancelado la operación o se ha producido un error de E/S no especificado (OperationCanceledException).

  • La ruta de acceso supera la longitud máxima definida por el sistema (PathTooLongException).

  • El usuario no tiene los permisos necesarios para ver la ruta de acceso (SecurityException).

  • El usuario no ha necesitado permiso (UnauthorizedAccessException).

Comentarios

Si la estructura de destino no existe, se crea.

El método MoveFile sólo conserva las entradas de control de acceso (ACE) cuando el archivo se mueve dentro del mismo volumen. Esto incluye ACE heredadas, que se convierten en ACE directas cuando se mueven (las ACE directas tienen prioridad sobre las ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán las ACE.

Tareas

En la tabla siguiente se muestran ejemplos de tareas en las que interviene el método My.Computer.FileSystem.MoveFile.

Para

Vea

Mover un archivo

Cómo: Mover un archivo en Visual Basic

Mover una colección de archivos

Cómo: Mover una colección de archivos en Visual Basic

Mover el contenido de un directorio

Cómo: Mover el contenido de un directorio en Visual Basic

Ejemplo

En este ejemplo se mueve el archivo Test.txt de TestDir1 a TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

En este ejemplo se mueve el archivo Test.txt de TestDir1 a TestDir2 y se cambia su nombre a Test2.txt.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Requisitos

Espacio de nombres:Microsoft.VisualBasic.MyServices

Clase:FileSystemProxy (proporciona acceso a FileSystem)

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

Disponibilidad por tipo de proyecto

Tipo de proyecto

Disponible

Aplicación para Windows

Biblioteca de clases

Aplicación de consola

Biblioteca de controles de Windows

Biblioteca de controles Web

Servicio de Windows

Sitio Web

Permisos

Los permisos siguientes pueden ser necesarios:

Permiso

Descripción

EnvironmentPermission

Controla la capacidad para tener acceso a todas las variables de entorno. Enumeración asociada: Unrestricted.

FileIOPermission

Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.

RegistryPermission

Controla la capacidad de tener acceso a variables del Registro. Enumeración asociada: Unrestricted.

UIPermission

Controla los permisos relacionados con las interfaces de usuario y el Portapapeles. Enumeración asociada: SafeSubWindows.

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

Vea también

Referencia

My.Computer.FileSystem (Objeto)

UIOption (Enumeración)

UICancelOption (Enumeración)

Otros recursos

Crear, eliminar y mover archivos y directorios en Visual Basic