FileSystem.MoveFile Método

Definición

Espacio de nombres:

Microsoft.VisualBasic.FileIO

Ensamblado:

Microsoft.VisualBasic.Core.dll

Mueve un archivo a una nueva ubicación.

Sobrecargas

MoveFile(String, String)	Mueve un archivo a una nueva ubicación.
MoveFile(String, String, UIOption)	Mueve un archivo a una nueva ubicación.
MoveFile(String, String, Boolean)	Mueve un archivo a una nueva ubicación.
MoveFile(String, String, UIOption, UICancelOption)	Mueve un archivo a una nueva ubicación.

MoveFile(String, String)

Source:

FileSystem.vb

Mueve un archivo a una nueva ubicación.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public static void MoveFile (string sourceFileName, string destinationFileName);

static member MoveFile : string * string -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)

Parámetros

sourceFileName

String

Ruta de acceso al archivo que se va a mover.

destinationFileName

String

Ruta de acceso al directorio al que se moverá el archivo.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

ArgumentNullException

destinationFileName es Nothing o una cadena vacía.

FileNotFoundException

El archivo de código de origen no es válido o no existe.

IOException

El archivo está en uso por otro proceso, o hay un error de E/S.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

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 le Test2.txtcambia el nombre .

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

Comentarios

Si la estructura de destino no existe, se crea.

El MoveFile método conserva las ACE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye las ACE heredadas, que se convierten en ACE directas cuando se mueven (los ACE directas tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ASE.

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

En	Vea
Mover un archivo	Cómo: Mover un archivo en Visual Basic

MoveFile(String, String, UIOption)

Source:

FileSystem.vb

Mueve un archivo a una nueva ubicación.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parámetros

sourceFileName

String

Ruta de acceso al archivo que se va a mover.

destinationFileName

String

Ruta de acceso al directorio al que se moverá el archivo.

showUI

UIOption

Especifica si se va a seguir visualmente el progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

ArgumentNullException

destinationFileName es Nothing o una cadena vacía.

FileNotFoundException

El archivo de código de origen no es válido o no existe.

IOException

El archivo está en uso por otro proceso, o hay un error de E/S.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

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 le Test2.txtcambia el nombre .

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

Comentarios

Si la estructura de destino no existe, se crea.

El MoveFile método conserva las ACE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye las ACE heredadas, que se convierten en ACE directas cuando se mueven (los ACE directas tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ASE.

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

En	Vea
Mover un archivo	Cómo: Mover un archivo en Visual Basic

Consulte también

• UIOption

MoveFile(String, String, Boolean)

Source:

FileSystem.vb

Mueve un archivo a una nueva ubicación.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public static void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

static member MoveFile : string * string * bool -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parámetros

sourceFileName

String

Ruta de acceso al archivo que se va a mover.

destinationFileName

String

Ruta de acceso al directorio al que se moverá el archivo.

overwrite

Boolean

True para sobrescribir los archivos existentes; de lo contrario, False. El valor predeterminado es False.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

ArgumentNullException

destinationFileName es Nothing o una cadena vacía.

FileNotFoundException

El archivo de código de origen no es válido o no existe.

IOException

El archivo está en uso por otro proceso, o hay un error de E/S.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

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 le Test2.txtcambia el nombre .

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

Comentarios

Si la estructura de destino no existe, se crea.

El MoveFile método conserva las ACE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye las ACE heredadas, que se convierten en ACE directas cuando se mueven (los ACE directas tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ASE.

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

En	Vea
Mover un archivo	Cómo: Mover un archivo en Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Source:

FileSystem.vb

Mueve un archivo a una nueva ubicación.

public:
 static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public static void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parámetros

sourceFileName

String

Ruta de acceso al archivo que se va a mover.

destinationFileName

String

Ruta de acceso al directorio al que se moverá el archivo.

showUI

UIOption

Especifica si se va a seguir visualmente el progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Especifica si se va a producir una excepción cuando el usuario cancele la operación. El valor predeterminado es UICancelOption.ThrowException.

Excepciones

ArgumentException

La ruta de acceso no es válida por uno de los siguientes motivos: es una cadena de longitud cero; contiene sólo espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza por \\.\); termina con una barra diagonal final.

ArgumentNullException

destinationFileName es Nothing o una cadena vacía.

FileNotFoundException

El archivo de código de origen no es válido o no existe.

IOException

El archivo está en uso por otro proceso, o hay un error de E/S.

OperationCanceledException

onUserCancel está establecido en ThrowException y el usuario ha cancelado la operación o se ha producido un error de E/S no especificado.

PathTooLongException

La ruta de acceso supera la longitud máxima definida por el sistema.

NotSupportedException

Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.

SecurityException

El usuario no tiene los permisos necesarios para ver la ruta de acceso.

Ejemplos

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 le Test2.txtcambia el nombre .

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

Comentarios

Si la estructura de destino no existe, se crea.

El MoveFile método conserva las ACE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye las ACE heredadas, que se convierten en ACE directas cuando se mueven (los ACE directas tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ASE.

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

En	Vea
Mover un archivo	Cómo: Mover un archivo en Visual Basic

Consulte también

• UIOption
• UICancelOption