FileSystemProxy.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
| 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:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void MoveFile (string sourceFileName, string destinationFileName);member this.MoveFile : string * string -> unitPublic 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
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.
destinationFileName es Nothing o una cadena vacía.
El archivo de código de origen no es válido o no existe.
El archivo está en uso por otro proceso, o hay un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.
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 los ASE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye los ASE heredados, que se convierten en ACE directas cuando se mueven (las ACE directas 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 | Procedimiento para mover un archivo |
Consulte también
Se aplica a
MoveFile(String, String, UIOption)
Mueve un archivo a una nueva ubicación.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unitPublic 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
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.
destinationFileName es Nothing o una cadena vacía.
El archivo de código de origen no es válido o no existe.
El archivo está en uso por otro proceso, o hay un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.
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 los ASE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye los ASE heredados, que se convierten en ACE directas cuando se mueven (las ACE directas 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 | Procedimiento para mover un archivo |
Consulte también
Se aplica a
MoveFile(String, String, Boolean)
Mueve un archivo a una nueva ubicación.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);member this.MoveFile : string * string * bool -> unitPublic 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
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.
destinationFileName es Nothing o una cadena vacía.
El archivo de código de origen no es válido o no existe.
El archivo está en uso por otro proceso, o hay un error de E/S.
La ruta de acceso supera la longitud máxima definida por el sistema.
Un nombre de archivo o directorio de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.
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 los ASE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye los ASE heredados, que se convierten en ACE directas cuando se mueven (las ACE directas 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 enumeran ejemplos de una tarea que implica el My.Computer.FileSystem.MoveFile método .
| En | Vea |
|---|---|
| Mover un archivo | Procedimiento para mover un archivo |
Consulte también
Se aplica a
MoveFile(String, String, UIOption, UICancelOption)
Mueve un archivo a una nueva ubicación.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unitPublic 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
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.
destinationFileName es Nothing o una cadena vacía.
El archivo de código de origen no es válido o no existe.
El archivo está en uso por otro proceso, o hay un error de E/S.
onUserCancel está establecido en ThrowException y el usuario ha cancelado la operación o se ha producido 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 de la ruta de acceso contiene dos puntos (:) o está en un formato no válido.
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 los ASE (Access Control entradas) solo al mover el archivo dentro del mismo volumen. Esto incluye los ASE heredados, que se convierten en ACE directas cuando se mueven (las ACE directas 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 | Procedimiento para mover un archivo |
Consulte también
Se aplica a
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de