FileSystemProxy.CopyFile Метод

Определение

Пространство имен:

Microsoft.VisualBasic.MyServices

Сборка:

Microsoft.VisualBasic.Forms.dll

Копирует файл в новое местоположение.

Перегрузки

CopyFile(String, String)	Копирует файл в новое местоположение.
CopyFile(String, String, UIOption)	Копирует файл в новое местоположение.
CopyFile(String, String, Boolean)	Копирует файл в новое местоположение.
CopyFile(String, String, UIOption, UICancelOption)	Копирует файл в новое местоположение.

CopyFile(String, String)

Копирует файл в новое местоположение.

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

public void CopyFile (string sourceFileName, string destinationFileName);

member this.CopyFile : string * string -> unit

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

Параметры

sourceFileName

String

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

destinationFileName

String

Местоположение, в которое необходимо скопировать файл.

Исключения

ArgumentException

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

ArgumentNullException

destinationFileName или sourceFileName равен Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Файл в целевом каталоге с тем же именем уже используется.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

UnauthorizedAccessException

Пользователь не имеет необходимого разрешения.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

Комментарии

CopyFileне сохраняет ACE (записи контроль доступа). Созданный файл наследует ACE по умолчанию от каталога, в котором он создан.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyFile .

Кому	См.
Скопируйте файл в тот же каталог.	Практическое руководство. Создание копии файла в том же каталоге
Скопируйте файл в другой каталог.	Практическое руководство. Создание копии файла в другом каталоге

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• Практическое руководство. Копирование файлов в каталог с использованием шаблона в Visual Basic
• Практическое руководство. Создание копии файла в том же каталоге в Visual Basic
• Практическое руководство. Копирование каталога в другой каталог в Visual Basic
• Практическое руководство. Переименование файла в Visual Basic

CopyFile(String, String, UIOption)

Копирует файл в новое местоположение.

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

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

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

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

Параметры

sourceFileName

String

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

destinationFileName

String

Местоположение, в которое необходимо скопировать файл.

showUI

UIOption

Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs.

Исключения

ArgumentException

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

ArgumentNullException

destinationFileName или sourceFileName равен Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Конечный файл существует, а параметр overwrite имеет значение False.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

UnauthorizedAccessException

Пользователь не имеет необходимого разрешения.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

Комментарии

CopyFileне сохраняет ACE (записи контроль доступа). Созданный файл наследует ACE по умолчанию от каталога, в котором он создан.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyFile .

Кому	См.
Скопируйте файл в тот же каталог.	Практическое руководство. Создание копии файла в том же каталоге
Скопируйте файл в другой каталог.	Практическое руководство. Создание копии файла в другом каталоге

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• Практическое руководство. Копирование файлов в каталог с использованием шаблона в Visual Basic
• Практическое руководство. Создание копии файла в том же каталоге в Visual Basic
• Практическое руководство. Копирование каталога в другой каталог в Visual Basic
• Практическое руководство. Переименование файла в Visual Basic

CopyFile(String, String, Boolean)

Копирует файл в новое местоположение.

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

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

member this.CopyFile : string * string * bool -> unit

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

Параметры

sourceFileName

String

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

destinationFileName

String

Местоположение, в которое необходимо скопировать файл.

overwrite

Boolean

Значение True, если нужно перезаписывать существующие файлы; в противном случае — значение False. Значение по умолчанию — False.

Исключения

ArgumentException

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

ArgumentNullException

destinationFileName или sourceFileName равен Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Конечный файл существует, а параметр overwrite имеет значение False.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

UnauthorizedAccessException

Пользователь не имеет необходимого разрешения.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

Комментарии

CopyFileне сохраняет ACE (записи контроль доступа). Созданный файл наследует ACE по умолчанию от каталога, в котором он создан.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyFile .

Кому	См.
Скопируйте файл в тот же каталог.	Практическое руководство. Создание копии файла в том же каталоге
Скопируйте файл в другой каталог.	Практическое руководство. Создание копии файла в другом каталоге

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• Практическое руководство. Копирование файлов в каталог с использованием шаблона в Visual Basic
• Практическое руководство. Создание копии файла в том же каталоге в Visual Basic
• Практическое руководство. Копирование каталога в другой каталог в Visual Basic
• Практическое руководство. Переименование файла в Visual Basic

CopyFile(String, String, UIOption, UICancelOption)

Копирует файл в новое местоположение.

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

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

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

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

Параметры

sourceFileName

String

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

destinationFileName

String

Местоположение, в которое необходимо скопировать файл.

showUI

UIOption

Указывает, следует ли отображать ход выполнения операции. Значение по умолчанию — UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Указывает, что следует сделать, если пользователь нажимает кнопку Отмена во время операции. Значение по умолчанию — ThrowException.

Исключения

ArgumentException

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

ArgumentNullException

destinationFileName или sourceFileName равен Nothing или является пустой строкой.

FileNotFoundException

Исходный файл не является допустимым или не существует.

IOException

Конечный файл существует, а параметр overwrite имеет значение False.

NotSupportedException

Имя файла или каталога в пути содержит двоеточие (:) или имеет недопустимый формат.

PathTooLongException

Длина пути превышает максимальную длину, определенную в системе.

UnauthorizedAccessException

Пользователь не имеет необходимого разрешения.

SecurityException

У пользователя отсутствуют необходимые разрешения на просмотр пути.

OperationCanceledException

UICancelOption имеет значение ThrowException, а пользователь отменил операцию, или возникла ошибка ввода-вывода.

Примеры

В этом примере файл Test.txt копируется в каталог TestFiles2 без перезаписи существующих файлов.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

В этом примере файл Test.txt копируется в каталог TestFiles2 и переименовывается NewFile.txt.

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

Замените пути к файлам путями, которые вы хотите использовать в коде.

Комментарии

CopyFileне сохраняет ACE (записи контроль доступа). Созданный файл наследует ACE по умолчанию от каталога, в котором он создан.

В следующей таблице перечислены примеры задач, связанных с методом My.Computer.FileSystem.CopyFile .

Кому	См.
Скопируйте файл в тот же каталог.	Практическое руководство. Создание копии файла в том же каталоге
Скопируйте файл в другой каталог.	Практическое руководство. Создание копии файла в другом каталоге

См. также раздел

• UICancelOption
• Объекты (Visual Basic)
• Практическое руководство. Копирование файлов в каталог с использованием шаблона в Visual Basic
• Практическое руководство. Создание копии файла в том же каталоге в Visual Basic
• Практическое руководство. Копирование каталога в другой каталог в Visual Basic
• Практическое руководство. Переименование файла в Visual Basic