FileSystem.CopyFile Метод

Определение

Копирует файл в новое местоположение.Copies a file to a new location.

Перегрузки

CopyFile(String, String)

Копирует файл в новое местоположение.Copies a file to a new location.

CopyFile(String, String, UIOption)

Копирует файл в новое местоположение.Copies a file to a new location.

CopyFile(String, String, Boolean)

Копирует файл в новое местоположение.Copies a file to a new location.

CopyFile(String, String, UIOption, UICancelOption)

Копирует файл в новое местоположение.Copies a file to a new location.

CopyFile(String, String)

Копирует файл в новое местоположение.Copies a file to a new location.

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)

Параметры

sourceFileName
String

Файл, который необходимо скопировать.The file to be copied.

destinationFileName
String

Местоположение, в которое необходимо скопировать файл.The location to which the file should be copied.

Исключения

destinationFileName содержит сведения о пути.destinationFileName contains path information.

destinationFileName или sourceFileName равен Nothing или является пустой строкой.destinationFileName or sourceFileName is Nothing or an empty string.

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Файл в целевом каталоге с тем же именем уже используется.A file in the target directory with the same name is in use.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.This example copies the file Test.txt to the directory TestFiles2 without overwriting existing files.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.This example copies the file Test.txt to the directory TestFiles2 and renames it NewFile.txt.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

Комментарии

CopyFile не сохраняет ACE (записи контроля доступа).CopyFile does not preserve ACEs (Access Control Entries). Созданный файл наследует элементы ACE по умолчанию из каталога, в котором он создается.The newly created file inherits default ACEs from the directory in which it is created.

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.CopyFile.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

КомуTo См.See
Скопируйте файл в тот же каталог.Copy a file to the same directory. Как создать копию файла в том же каталоге в Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Скопируйте файл в другой каталог.Copy a file to a different directory. Как создать копию файла в другом каталоге в Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

CopyFile(String, String, UIOption)

Копирует файл в новое местоположение.Copies a file to a new location.

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)

Параметры

sourceFileName
String

Файл, который необходимо скопировать.The file to be copied.

destinationFileName
String

Местоположение, в которое необходимо скопировать файл.The location to which the file should be copied.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

Исключения

destinationFileName содержит сведения о пути.destinationFileName contains path information.

destinationFileName или sourceFileName равен Nothing или является пустой строкой.destinationFileName or sourceFileName is Nothing or an empty string.

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Конечный файл существует, а параметр overwrite имеет значение False.The destination file exists and overwrite is set to False.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.This example copies the file Test.txt to the directory TestFiles2 without overwriting existing files.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.This example copies the file Test.txt to the directory TestFiles2 and renames it NewFile.txt.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

Комментарии

CopyFile не сохраняет ACE (записи контроля доступа).CopyFile does not preserve ACEs (Access Control Entries). Созданный файл наследует элементы ACE по умолчанию из каталога, в котором он создается.The newly created file inherits default ACEs from the directory in which it is created.

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.CopyFile.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

КомуTo См.See
Скопируйте файл в тот же каталог.Copy a file to the same directory. Как создать копию файла в том же каталоге в Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Скопируйте файл в другой каталог.Copy a file to a different directory. Как создать копию файла в другом каталоге в Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

CopyFile(String, String, Boolean)

Копирует файл в новое местоположение.Copies a file to a new location.

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)

Параметры

sourceFileName
String

Файл, который необходимо скопировать.The file to be copied.

destinationFileName
String

Местоположение, в которое необходимо скопировать файл.The location to which the file should be copied.

overwrite
Boolean

Значение True, если нужно перезаписывать существующие файлы; в противном случае — значение False.True if existing files should be overwritten; otherwise False. Значение по умолчанию — False.Default is False.

Исключения

destinationFileName содержит сведения о пути.destinationFileName contains path information.

destinationFileName или sourceFileName равен Nothing или является пустой строкой.destinationFileName or sourceFileName is Nothing or an empty string.

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Конечный файл существует, а параметр overwrite имеет значение False.The destination file exists and overwrite is set to False.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.This example copies the file Test.txt to the directory TestFiles2 without overwriting existing files.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.This example copies the file Test.txt to the directory TestFiles2 and renames it NewFile.txt.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

Комментарии

CopyFile не сохраняет ACE (записи контроля доступа).CopyFile does not preserve ACEs (Access Control Entries). Созданный файл наследует элементы ACE по умолчанию из каталога, в котором он создается.The newly created file inherits default ACEs from the directory in which it is created.

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.CopyFile.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

КомуTo См.See
Скопируйте файл в тот же каталог.Copy a file to the same directory. Как создать копию файла в том же каталоге в Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Скопируйте файл в другой каталог.Copy a file to a different directory. Как создать копию файла в другом каталоге в Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

Дополнительно

CopyFile(String, String, UIOption, UICancelOption)

Копирует файл в новое местоположение.Copies a file to a new location.

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)

Параметры

sourceFileName
String

Файл, который необходимо скопировать.The file to be copied.

destinationFileName
String

Местоположение, в которое необходимо скопировать файл.The location to which the file should be copied.

showUI
UIOption

Указывает, следует ли отображать ход выполнения операции.Whether to visually track the operation's progress. Значение по умолчанию — UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Определяет, что должно быть выполнено, если во время операции пользователь нажмет кнопку Отмена.Specifies what should be done if the user clicks Cancel during the operation. Значение по умолчанию — ThrowException.Default is ThrowException.

Исключения

destinationFileName содержит сведения о пути.destinationFileName contains path information.

destinationFileName или sourceFileName равен Nothing или является пустой строкой.destinationFileName or sourceFileName is Nothing or an empty string.

Исходный файл не является допустимым или не существует.The source file is not valid or does not exist.

Конечный файл существует, а параметр overwrite имеет значение False.The destination file exists and overwrite is set to False.

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.A file or directory name in the path contains a colon (:) or is in an invalid format.

Длина пути превышает максимальную длину, определенную в системе.The path exceeds the system-defined maximum length.

Пользователь не имеет необходимого разрешения.The user does not have required permission.

У пользователя отсутствуют необходимые разрешения на просмотр пути.The user lacks necessary permissions to view the path.

UICancelOption имеет значение ThrowException, а пользователь отменил операцию, или возникла ошибка ввода-вывода.UICancelOption is set to ThrowException, and the user has canceled the operation or an unspecified I/O error occurs.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.This example copies the file Test.txt to the directory TestFiles2 without overwriting existing files.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.This example copies the file Test.txt to the directory TestFiles2 and renames it NewFile.txt.

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

Замените пути к файлам на пути, которые вы хотите использовать в коде.Replace the file paths with the paths you want to use in your code.

Комментарии

CopyFile не сохраняет ACE (записи контроля доступа).CopyFile does not preserve ACEs (Access Control Entries). Созданный файл наследует элементы ACE по умолчанию из каталога, в котором он создается.The newly created file inherits default ACEs from the directory in which it is created.

В следующей таблице приведены примеры задач, в которых используется метод My.Computer.FileSystem.CopyFile.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

КомуTo См.See
Скопируйте файл в тот же каталог.Copy a file to the same directory. Как создать копию файла в том же каталоге в Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Скопируйте файл в другой каталог.Copy a file to a different directory. Как создать копию файла в другом каталоге в Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Безопасность

EnvironmentPermission
Управляет возможностью доступа ко всем переменным среды.Controls the ability to access all environment variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

FileIOPermission
Управляет возможностью доступа к файлам и папкам.Controls the ability to access files and folders. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

RegistryPermission
Управляет возможностью доступа к переменным реестра.Controls the ability to access registry variables. Связанное перечисление: Unrestricted.Associated enumeration: Unrestricted.

UIPermission
Управляет разрешениями, связанными с пользовательскими интерфейсами и буфером обмена.Controls the permissions related to user interfaces and the clipboard. Связанное перечисление: SafeSubWindows.Associated enumeration: SafeSubWindows.

Дополнительно

Применяется к