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

Artículo
10/07/2008

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	Sí
Biblioteca de clases	Sí
Aplicación de consola	Sí
Biblioteca de controles de Windows	Sí
Biblioteca de controles Web	Sí
Servicio de Windows	Sí
Sitio Web	Sí

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.