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

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.

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

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

Referencia

My.Computer.FileSystem (Objeto)

UIOption (Enumeración)

UICancelOption (Enumeración)

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

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

Otros recursos

Crear, eliminar y mover archivos y directorios en Visual Basic