FileSystem.CopyFile Método

Definición

Espacio de nombres:: Microsoft.VisualBasic.FileIO

Ensamblado:: Microsoft.VisualBasic.dll

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í.

Copia un archivo en una nueva ubicación.

Sobrecargas

Nombre	Description
CopyFile(String, String)	Copia un archivo en una nueva ubicación.
CopyFile(String, String, UIOption)	Copia un archivo en una nueva ubicación.
CopyFile(String, String, Boolean)	Copia un archivo en una nueva ubicación.
CopyFile(String, String, UIOption, UICancelOption)	Copia un archivo en una nueva ubicación.

CopyFile(String, String)

Copia un archivo en una nueva ubicación.

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

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

static member CopyFile : string * string -> unit

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

Parámetros

sourceFileName: String

Archivo que se va a copiar.

destinationFileName: String

Ubicación a la que se debe copiar el archivo.

Excepciones

ArgumentException

destinationFileName contiene información de ruta de acceso.

ArgumentNullException

destinationFileName o sourceFileName es Nothing o una cadena vacía.

FileNotFoundException

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

IOException

Se usa un archivo en el directorio de destino con el mismo nombre.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

El usuario no tiene permiso necesario.

SecurityException

El usuario carece de permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 sin sobrescribir los archivos existentes.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 y se le NewFile.txtcambia el nombre .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

Comentarios

CopyFile no conserva ACL (entradas de Access Control). El archivo recién creado hereda los ACE predeterminados del directorio en el que se crea.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.CopyFile método .

En	Vea
Copie un archivo en el mismo directorio.	Cómo crear una copia de un archivo en el mismo directorio en Visual Basic
Copie un archivo en otro directorio.	Cómo crear una copia de un archivo en un directorio diferente en Visual Basic

Consulte también

UICancelOption

Se aplica a

CopyFile(String, String, UIOption)

Copia un archivo en una nueva ubicación.

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

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

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

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

Parámetros

sourceFileName: String

Archivo que se va a copiar.

destinationFileName: String

Ubicación a la que se debe copiar el archivo.

showUI: UIOption

Indica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

Excepciones

ArgumentException

destinationFileName contiene información de ruta de acceso.

ArgumentNullException

destinationFileName o sourceFileName es Nothing o una cadena vacía.

FileNotFoundException

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

IOException

El archivo de destino existe y overwrite se establece en False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

El usuario no tiene permiso necesario.

SecurityException

El usuario carece de permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 sin sobrescribir los archivos existentes.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 y se le NewFile.txtcambia el nombre .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

Comentarios

CopyFile no conserva ACL (entradas de Access Control). El archivo recién creado hereda los ACE predeterminados del directorio en el que se crea.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.CopyFile método .

En	Vea
Copie un archivo en el mismo directorio.	Cómo crear una copia de un archivo en el mismo directorio en Visual Basic
Copie un archivo en otro directorio.	Cómo crear una copia de un archivo en un directorio diferente en Visual Basic

Consulte también

UICancelOption

Se aplica a

CopyFile(String, String, Boolean)

Copia un archivo en una nueva ubicación.

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

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

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

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

Parámetros

sourceFileName: String

Archivo que se va a copiar.

destinationFileName: String

Ubicación a la que se debe copiar el archivo.

overwrite: Boolean

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

Excepciones

ArgumentException

destinationFileName contiene información de ruta de acceso.

ArgumentNullException

destinationFileName o sourceFileName es Nothing o una cadena vacía.

FileNotFoundException

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

IOException

El archivo de destino existe y overwrite se establece en False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

El usuario no tiene permiso necesario.

SecurityException

El usuario carece de permisos necesarios para ver la ruta de acceso.

Ejemplos

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 sin sobrescribir los archivos existentes.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 y se le NewFile.txtcambia el nombre .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

Comentarios

CopyFile no conserva ACL (entradas de Access Control). El archivo recién creado hereda los ACE predeterminados del directorio en el que se crea.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.CopyFile método .

En	Vea
Copie un archivo en el mismo directorio.	Cómo crear una copia de un archivo en el mismo directorio en Visual Basic
Copie un archivo en otro directorio.	Cómo crear una copia de un archivo en un directorio diferente en Visual Basic

Consulte también

UICancelOption

Se aplica a

CopyFile(String, String, UIOption, UICancelOption)

Copia un archivo en una nueva ubicación.

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

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

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

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

Parámetros

sourceFileName: String

Archivo que se va a copiar.

destinationFileName: String

Ubicación a la que se debe copiar el archivo.

showUI: UIOption

Indica si se va a realizar un seguimiento visual del progreso de la operación. El valor predeterminado es UIOption.OnlyErrorDialogs.

onUserCancel: UICancelOption

Especifica lo que se debe hacer si el usuario hace clic en Cancelar durante la operación. El valor predeterminado es ThrowException.

Excepciones

ArgumentException

destinationFileName contiene información de ruta de acceso.

ArgumentNullException

destinationFileName o sourceFileName es Nothing o una cadena vacía.

FileNotFoundException

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

IOException

El archivo de destino existe y overwrite se establece en False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

El usuario no tiene permiso necesario.

SecurityException

El usuario carece de permisos necesarios para ver la ruta de acceso.

OperationCanceledException

UICancelOption se establece en ThrowExceptiony el usuario ha cancelado la operación o se produce un error de E/S no especificado.

Ejemplos

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 sin sobrescribir los archivos existentes.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

En este ejemplo se copia el archivo Test.txt en el directorio TestFiles2 y se le NewFile.txtcambia el nombre .

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Reemplace las rutas de acceso de archivo por las rutas de acceso que desea usar en el código.

Comentarios

CopyFile no conserva ACL (entradas de Access Control). El archivo recién creado hereda los ACE predeterminados del directorio en el que se crea.

En la tabla siguiente se enumeran ejemplos de tareas relacionadas con el My.Computer.FileSystem.CopyFile método .

En	Vea
Copie un archivo en el mismo directorio.	Cómo crear una copia de un archivo en el mismo directorio en Visual Basic
Copie un archivo en otro directorio.	Cómo crear una copia de un archivo en un directorio diferente en Visual Basic

Consulte también

UICancelOption

Se aplica a

Comentarios

¿Le ha resultado útil esta página?