Compartir a través de


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.

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

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

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.

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