FileSystem.CopyFile FileSystem.CopyFile FileSystem.CopyFile FileSystem.CopyFile Method

Definition

Kopiert eine Datei an einen neuen Speicherort.Copies a file to a new location.

Überlädt

CopyFile(String, String) CopyFile(String, String) CopyFile(String, String) CopyFile(String, String)

Kopiert eine Datei an einen neuen Speicherort.Copies a file to a new location.

CopyFile(String, String, UIOption) CopyFile(String, String, UIOption) CopyFile(String, String, UIOption) CopyFile(String, String, UIOption)

Kopiert eine Datei an einen neuen Speicherort.Copies a file to a new location.

CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean)

Kopiert eine Datei an einen neuen Speicherort.Copies a file to a new location.

CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption)

Kopiert eine Datei an einen neuen Speicherort.Copies a file to a new location.

CopyFile(String, String) CopyFile(String, String) CopyFile(String, String) CopyFile(String, String)

Kopiert eine Datei an einen neuen Speicherort.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)

Parameter

sourceFileName
String String String String

Die zu kopierende Datei.The file to be copied.

destinationFileName
String String String String

Der Speicherort, an den die Datei kopiert werden soll.The location to which the file should be copied.

Ausnahmen

destinationFileName enthält Pfadinformationen.destinationFileName contains path information.

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.destinationFileName or sourceFileName is Nothing or an empty string.

Die Quelldatei ist ungültig oder nicht vorhanden.The source file is not valid or does not exist.

Eine Datei im Zielverzeichnis mit demselben Namen wird gegenwärtig verwendet.A file in the target directory with the same name is in use.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.A file or directory name in the path contains a colon (:) or is in an invalid format.

Der Pfad überschreitet die im System definierte maximale Länge.The path exceeds the system-defined maximum length.

Der Benutzer verfügt nicht über die erforderliche Berechtigung.The user does not have required permission.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.The user lacks necessary permissions to view the path.

Beispiele

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert, ohne vorhandene Dateien zu überschreiben.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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert und umbenannt 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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

Hinweise

CopyFilebehält keine ACEs (Access Control Einträge) bei.CopyFile does not preserve ACEs (Access Control Entries). Die neu erstellte Datei erbt Standard-ACEs aus dem Verzeichnis, in dem Sie erstellt wird.The newly created file inherits default ACEs from the directory in which it is created.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt My.Computer.FileSystem.CopyFile , die die-Methode betreffen.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

BeschreibungTo SieheSee
Kopieren Sie eine Datei in dasselbe Verzeichnis.Copy a file to the same directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei im gleichen Verzeichnis in Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis.Copy a file to a different directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei in einem anderen Verzeichnis in Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Sicherheit

EnvironmentPermission
Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen.Controls the ability to access all environment variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

FileIOPermission
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen.Controls the ability to access files and folders. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

RegistryPermission
Steuert den Zugriff auf Registrierungsvariablen.Controls the ability to access registry variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

Siehe auch

CopyFile(String, String, UIOption) CopyFile(String, String, UIOption) CopyFile(String, String, UIOption) CopyFile(String, String, UIOption)

Kopiert eine Datei an einen neuen Speicherort.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)

Parameter

sourceFileName
String String String String

Die zu kopierende Datei.The file to be copied.

destinationFileName
String String String String

Der Speicherort, an den die Datei kopiert werden soll.The location to which the file should be copied.

showUI
UIOption UIOption UIOption UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt werden soll.Whether to visually track the operation's progress. Der Standardwert ist UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

Ausnahmen

destinationFileName enthält Pfadinformationen.destinationFileName contains path information.

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.destinationFileName or sourceFileName is Nothing or an empty string.

Die Quelldatei ist ungültig oder nicht vorhanden.The source file is not valid or does not exist.

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.The destination file exists and overwrite is set to False.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.A file or directory name in the path contains a colon (:) or is in an invalid format.

Der Pfad überschreitet die im System definierte maximale Länge.The path exceeds the system-defined maximum length.

Der Benutzer verfügt nicht über die erforderliche Berechtigung.The user does not have required permission.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.The user lacks necessary permissions to view the path.

Beispiele

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert, ohne vorhandene Dateien zu überschreiben.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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert und umbenannt 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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

Hinweise

CopyFilebehält keine ACEs (Access Control Einträge) bei.CopyFile does not preserve ACEs (Access Control Entries). Die neu erstellte Datei erbt Standard-ACEs aus dem Verzeichnis, in dem Sie erstellt wird.The newly created file inherits default ACEs from the directory in which it is created.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt My.Computer.FileSystem.CopyFile , die die-Methode betreffen.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

BeschreibungTo SieheSee
Kopieren Sie eine Datei in dasselbe Verzeichnis.Copy a file to the same directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei im gleichen Verzeichnis in Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis.Copy a file to a different directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei in einem anderen Verzeichnis in Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Sicherheit

EnvironmentPermission
Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen.Controls the ability to access all environment variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

FileIOPermission
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen.Controls the ability to access files and folders. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

RegistryPermission
Steuert den Zugriff auf Registrierungsvariablen.Controls the ability to access registry variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

UIPermission
Steuert die Berechtigungen, die sich auf Benutzeroberflächen und die Zwischenablage beziehen.Controls the permissions related to user interfaces and the clipboard. Zugeordnete Enumeration: SafeSubWindowsAssociated enumeration: SafeSubWindows.

Siehe auch

CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean) CopyFile(String, String, Boolean)

Kopiert eine Datei an einen neuen Speicherort.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)

Parameter

sourceFileName
String String String String

Die zu kopierende Datei.The file to be copied.

destinationFileName
String String String String

Der Speicherort, an den die Datei kopiert werden soll.The location to which the file should be copied.

overwrite
Boolean Boolean Boolean Boolean

True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False.True if existing files should be overwritten; otherwise False. Der Standardwert ist False.Default is False.

Ausnahmen

destinationFileName enthält Pfadinformationen.destinationFileName contains path information.

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.destinationFileName or sourceFileName is Nothing or an empty string.

Die Quelldatei ist ungültig oder nicht vorhanden.The source file is not valid or does not exist.

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.The destination file exists and overwrite is set to False.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.A file or directory name in the path contains a colon (:) or is in an invalid format.

Der Pfad überschreitet die im System definierte maximale Länge.The path exceeds the system-defined maximum length.

Der Benutzer verfügt nicht über die erforderliche Berechtigung.The user does not have required permission.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.The user lacks necessary permissions to view the path.

Beispiele

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert, ohne vorhandene Dateien zu überschreiben.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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert und umbenannt 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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

Hinweise

CopyFilebehält keine ACEs (Access Control Einträge) bei.CopyFile does not preserve ACEs (Access Control Entries). Die neu erstellte Datei erbt Standard-ACEs aus dem Verzeichnis, in dem Sie erstellt wird.The newly created file inherits default ACEs from the directory in which it is created.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt My.Computer.FileSystem.CopyFile , die die-Methode betreffen.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

BeschreibungTo SieheSee
Kopieren Sie eine Datei in dasselbe Verzeichnis.Copy a file to the same directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei im gleichen Verzeichnis in Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis.Copy a file to a different directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei in einem anderen Verzeichnis in Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Sicherheit

EnvironmentPermission
Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen.Controls the ability to access all environment variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

FileIOPermission
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen.Controls the ability to access files and folders. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

RegistryPermission
Steuert den Zugriff auf Registrierungsvariablen.Controls the ability to access registry variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

Siehe auch

CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption) CopyFile(String, String, UIOption, UICancelOption)

Kopiert eine Datei an einen neuen Speicherort.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)

Parameter

sourceFileName
String String String String

Die zu kopierende Datei.The file to be copied.

destinationFileName
String String String String

Der Speicherort, an den die Datei kopiert werden soll.The location to which the file should be copied.

showUI
UIOption UIOption UIOption UIOption

Gibt an, ob der Status des Vorgangs visuell dargestellt werden soll.Whether to visually track the operation's progress. Der Standardwert ist UIOption.OnlyErrorDialogs.Default is UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption UICancelOption UICancelOption UICancelOption

Gibt die Aktion an, die ausgeführt werden soll, wenn während des Vorgangs auf Abbrechen geklickt wird.Specifies what should be done if the user clicks Cancel during the operation. Der Standardwert ist ThrowException.Default is ThrowException.

Ausnahmen

destinationFileName enthält Pfadinformationen.destinationFileName contains path information.

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.destinationFileName or sourceFileName is Nothing or an empty string.

Die Quelldatei ist ungültig oder nicht vorhanden.The source file is not valid or does not exist.

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.The destination file exists and overwrite is set to False.

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.A file or directory name in the path contains a colon (:) or is in an invalid format.

Der Pfad überschreitet die im System definierte maximale Länge.The path exceeds the system-defined maximum length.

Der Benutzer verfügt nicht über die erforderliche Berechtigung.The user does not have required permission.

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.The user lacks necessary permissions to view the path.

UICancelOption ist auf ThrowException festgelegt, und entweder hat der Benutzer den Vorgang abgebrochen, oder ein nicht näher bezeichneter E/A-Fehler tritt auf.UICancelOption is set to ThrowException, and the user has canceled the operation or an unspecified I/O error occurs.

Beispiele

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert, ohne vorhandene Dateien zu überschreiben.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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

In diesem Beispiel wird die Test.txt Datei in das TestFiles2 Verzeichnis kopiert und umbenannt 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)

Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.Replace the file paths with the paths you want to use in your code.

Hinweise

CopyFilebehält keine ACEs (Access Control Einträge) bei.CopyFile does not preserve ACEs (Access Control Entries). Die neu erstellte Datei erbt Standard-ACEs aus dem Verzeichnis, in dem Sie erstellt wird.The newly created file inherits default ACEs from the directory in which it is created.

In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt My.Computer.FileSystem.CopyFile , die die-Methode betreffen.The following table lists examples of tasks involving the My.Computer.FileSystem.CopyFile method.

BeschreibungTo SieheSee
Kopieren Sie eine Datei in dasselbe Verzeichnis.Copy a file to the same directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei im gleichen Verzeichnis in Visual BasicHow to: Create a Copy of a File in the Same Directory in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis.Copy a file to a different directory. Vorgehensweise: Erstellen Sie eine Kopie einer Datei in einem anderen Verzeichnis in Visual BasicHow to: Create a Copy of a File in a Different Directory in Visual Basic

Sicherheit

EnvironmentPermission
Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen.Controls the ability to access all environment variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

FileIOPermission
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen.Controls the ability to access files and folders. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

RegistryPermission
Steuert den Zugriff auf Registrierungsvariablen.Controls the ability to access registry variables. Zugeordnete Enumeration: UnrestrictedAssociated enumeration: Unrestricted.

UIPermission
Steuert die Berechtigungen, die sich auf Benutzeroberflächen und die Zwischenablage beziehen.Controls the permissions related to user interfaces and the clipboard. Zugeordnete Enumeration: SafeSubWindowsAssociated enumeration: SafeSubWindows.

Siehe auch

Gilt für: