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

Artículo
10/07/2008

Actualización: noviembre 2007

Mueve un directorio de una ubicación a otra.

' Usage
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,overwrite)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI)
My.Computer.FileSystem.MoveDirectory(sourceDirectoryName ,destinationDirectoryName ,showUI ,onUserCancel)

' Declaration
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal overwrite As Boolean _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption _
)
' -or-
Public Sub MoveDirectory( _
   ByVal sourceDirectoryName As String, _
   ByVal destinationDirectoryName As String, _
   ByVal showUI As UIOption, _
   ByVal onUserCancel As UICancelOption _
)

Parámetros

sourceDirectoryName
String. Ruta de acceso del directorio que se va a mover. Obligatorio.
destinationDirectoryName
String. Ruta de acceso del directorio al que se mueve el directorio de origen. Obligatorio.
overwrite
Boolean. Especifica si deben sobrescribirse los directorios existentes. El valor predeterminado es False. Obligatorio.
showUI
UIOption. 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 es una cadena de longitud cero, contiene sólo espacios en blanco, contiene los caracteres no válidos o es una ruta de acceso del dispositivo (se inicia con \\. \) (ArgumentException).
La ruta de acceso es Nothing (ArgumentNullException).
La ruta de acceso no es válida (DirectoryNotFoundException).
El origen es un directorio raíz (IOException).
La ruta de acceso combinada apunta a un archivo existente (IOException).
La ruta de acceso de origen y destino son la misma (IOException).
El archivo de destino ya existe y overwrite está establecido en False (IOException).
El parámetro onUserCancel está establecido en ThrowException y un subdirectorio del archivo no se puede copiar (IOException).
La operación es cíclica (InvalidOperationException).
Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) (NotSupportedException).
La enumeración UICancelOption está establecida en ThrowException y el usuario cancela la operación o ésta no se puede finalizar (OperationCanceledException).
La ruta supera la longitud máxima definida por el sistema (PathTooLongException).
La enumeración UICancelOption está establecida en ThrowException y el usuario carece de los permisos necesarios (SecurityException).
El usuario no tiene permiso para modificar el archivo (UnauthorizedAccessException).

Comentarios

Si se intenta mover un directorio dentro de otro directorio que no existe, se creará la estructura de destino.

Tareas

En la tabla siguiente se muestra un ejemplo de una tarea en la que interviene el método My.Computer.FileSystem.MoveDirectory.

Para	Vea
Mover un directorio	Cómo: Mover un directorio en Visual Basic

Ejemplo

En este ejemplo se mueve Directory1 dentro de Directory2.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2")

En este ejemplo se mueve Directory1 dentro de Directory2 y sobrescribe el directorio si ya existe.

My.Computer.FileSystem.MoveDirectory("C:\Directory1", "C:\Directory2", _
True)

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
FileIOPermission	Controla la capacidad de tener acceso a archivos y carpetas. Enumeración asociada: Unrestricted.
UIPermission	Controla los permisos relacionados con las interfaces de usuario y el Portapapeles. Enumeración asociada: SafeSubWindows.