FileSystem.MoveFile Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Mueve un archivo a una nueva ubicación.
Sobrecargas
| Nombre | Description |
|---|---|
| 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)
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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)Parámetros
- sourceFileName
- String
Ruta de acceso del archivo que se va a mover.
- destinationFileName
- String
Ruta de acceso del directorio en el que se debe mover el archivo.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
destinationFileName es Nothing o una cadena vacía.
El archivo de origen no es válido o no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El usuario carece de 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 método MoveFile 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 directos tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ACL.
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 |
Se aplica a
MoveFile(String, String, UIOption)
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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parámetros
- sourceFileName
- String
Ruta de acceso del archivo que se va a mover.
- destinationFileName
- String
Ruta de acceso del directorio en el que se debe mover el archivo.
- showUI
- UIOption
Especifica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
destinationFileName es Nothing o una cadena vacía.
El archivo de origen no es válido o no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El usuario carece de 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 método MoveFile 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 directos tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ACL.
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
Se aplica a
MoveFile(String, String, Boolean)
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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parámetros
- sourceFileName
- String
Ruta de acceso del archivo que se va a mover.
- destinationFileName
- String
Ruta de acceso del directorio en el que se debe mover el archivo.
- overwrite
- Boolean
True para sobrescribir los archivos existentes; de lo contrario False, es . El valor predeterminado es False.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
destinationFileName es Nothing o una cadena vacía.
El archivo de origen no es válido o no existe.
Otro proceso usa el archivo o se produce un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El usuario carece de 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 método MoveFile 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 directos tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ACL.
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 |
Se aplica a
MoveFile(String, String, UIOption, UICancelOption)
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 -> unitPublic Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parámetros
- sourceFileName
- String
Ruta de acceso del archivo que se va a mover.
- destinationFileName
- String
Ruta de acceso del directorio en el que se debe mover el archivo.
- showUI
- UIOption
Especifica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Especifica si se produce o no una excepción cuando el usuario cancela la operación. El valor predeterminado es UICancelOption.ThrowException.
Excepciones
La ruta de acceso no es válida por una de las siguientes razones: es una cadena de longitud cero; solo contiene espacios en blanco; contiene caracteres no válidos; o es una ruta de acceso del dispositivo (comienza con \\.\); termina con una barra diagonal final.
destinationFileName es Nothing o una cadena vacía.
El archivo de origen no es válido o no existe.
Otro proceso usa el archivo o se produce un error de E/S.
onUserCancel se establece en ThrowExceptiony el usuario ha cancelado la operación o se produce un error de E/S no especificado.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio en la ruta de acceso contiene dos puntos (:) o tiene un formato no válido.
El usuario carece de 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 método MoveFile 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 directos tienen prioridad sobre los ACE heredadas). Si un archivo se mueve entre volúmenes, no se copiarán los ACL.
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 |