FileSystemProxy.CopyFile Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Kopiert eine Datei an einen neuen Speicherort.
Überlädt
| CopyFile(String, String) |
Kopiert eine Datei an einen neuen Speicherort. |
| CopyFile(String, String, UIOption) |
Kopiert eine Datei an einen neuen Speicherort. |
| CopyFile(String, String, Boolean) |
Kopiert eine Datei an einen neuen Speicherort. |
| CopyFile(String, String, UIOption, UICancelOption) |
Kopiert eine Datei an einen neuen Speicherort. |
CopyFile(String, String)
Kopiert eine Datei an einen neuen Speicherort.
public:
void CopyFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void CopyFile (string sourceFileName, string destinationFileName);member this.CopyFile : string * string -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String)Parameter
- sourceFileName
- String
Die zu kopierende Datei.
- destinationFileName
- String
Der Speicherort, an den die Datei kopiert werden soll.
Ausnahmen
destinationFileName enthält Pfadinformationen.
destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.
Die Quelldatei ist ungültig oder nicht vorhanden.
Eine Datei im Zielverzeichnis mit demselben Namen wird gegenwärtig verwendet.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.
Der Pfad überschreitet die im System definierte maximale Länge.
Der Benutzer verfügt nicht über die erforderliche Berechtigung.
Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.
Beispiele
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert, ohne vorhandene Dateien zu überschreiben.
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 in Ihrem Code verwenden möchten.
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert und umbenannt 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 in Ihrem Code verwenden möchten.
Hinweise
CopyFilebehält keine ACEs (Access Control Einträge) bei. Die neu erstellte Datei erbt Standard-ACEs von dem Verzeichnis, in dem sie erstellt wird.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyFile -Methode betreffen.
| Beschreibung | Siehe |
|---|---|
| Kopieren Sie eine Datei in dasselbe Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei im gleichen Verzeichnis |
| Kopieren Sie eine Datei in ein anderes Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis |
Weitere Informationen
- UICancelOption
- Objekte (Visual Basic)
- Gewusst wie: Kopieren von Dateien mit einem bestimmten Muster in ein Verzeichnis in Visual Basic
- Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
- Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic
- Gewusst wie: Umbenennen einer Datei in Visual Basic
Gilt für:
CopyFile(String, String, UIOption)
Kopiert eine Datei an einen neuen Speicherort.
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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parameter
- sourceFileName
- String
Die zu kopierende Datei.
- destinationFileName
- String
Der Speicherort, an den die Datei kopiert werden soll.
- showUI
- UIOption
Gibt an, ob der Status des Vorgangs visuell dargestellt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.
Ausnahmen
destinationFileName enthält Pfadinformationen.
destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.
Die Quelldatei ist ungültig oder nicht vorhanden.
Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.
Der Pfad überschreitet die im System definierte maximale Länge.
Der Benutzer verfügt nicht über die erforderliche Berechtigung.
Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.
Beispiele
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert, ohne vorhandene Dateien zu überschreiben.
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 in Ihrem Code verwenden möchten.
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert und umbenannt 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 in Ihrem Code verwenden möchten.
Hinweise
CopyFilebehält keine ACEs (Access Control Einträge) bei. Die neu erstellte Datei erbt Standard-ACEs von dem Verzeichnis, in dem sie erstellt wird.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyFile -Methode betreffen.
| Beschreibung | Siehe |
|---|---|
| Kopieren Sie eine Datei in dasselbe Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei im gleichen Verzeichnis |
| Kopieren Sie eine Datei in ein anderes Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis |
Weitere Informationen
- UICancelOption
- Objekte (Visual Basic)
- Gewusst wie: Kopieren von Dateien mit einem bestimmten Muster in ein Verzeichnis in Visual Basic
- Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
- Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic
- Gewusst wie: Umbenennen einer Datei in Visual Basic
Gilt für:
CopyFile(String, String, Boolean)
Kopiert eine Datei an einen neuen Speicherort.
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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parameter
- sourceFileName
- String
Die zu kopierende Datei.
- destinationFileName
- String
Der Speicherort, an den die Datei kopiert werden soll.
- overwrite
- Boolean
True, wenn vorhandene Dateien überschrieben werden sollen, andernfalls False. Der Standardwert ist False.
Ausnahmen
destinationFileName enthält Pfadinformationen.
destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.
Die Quelldatei ist ungültig oder nicht vorhanden.
Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.
Der Pfad überschreitet die im System definierte maximale Länge.
Der Benutzer verfügt nicht über die erforderliche Berechtigung.
Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.
Beispiele
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert, ohne vorhandene Dateien zu überschreiben.
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 in Ihrem Code verwenden möchten.
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert und umbenannt 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 in Ihrem Code verwenden möchten.
Hinweise
CopyFilebehält keine ACEs (Access Control Einträge) bei. Die neu erstellte Datei erbt Standard-ACEs von dem Verzeichnis, in dem sie erstellt wird.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyFile -Methode betreffen.
| Beschreibung | Siehe |
|---|---|
| Kopieren Sie eine Datei in dasselbe Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei im gleichen Verzeichnis |
| Kopieren Sie eine Datei in ein anderes Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis |
Weitere Informationen
- UICancelOption
- Objekte (Visual Basic)
- Gewusst wie: Kopieren von Dateien mit einem bestimmten Muster in ein Verzeichnis in Visual Basic
- Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
- Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic
- Gewusst wie: Umbenennen einer Datei in Visual Basic
Gilt für:
CopyFile(String, String, UIOption, UICancelOption)
Kopiert eine Datei an einen neuen Speicherort.
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 -> unitPublic Sub CopyFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parameter
- sourceFileName
- String
Die zu kopierende Datei.
- destinationFileName
- String
Der Speicherort, an den die Datei kopiert werden soll.
- showUI
- UIOption
Gibt an, ob der Status des Vorgangs visuell dargestellt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Gibt an, was ausgeführt werden soll, wenn der Benutzer während des Vorgangs auf Abbrechen klickt. Der Standardwert ist ThrowException.
Ausnahmen
destinationFileName enthält Pfadinformationen.
destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.
Die Quelldatei ist ungültig oder nicht vorhanden.
Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.
Der Pfad überschreitet die im System definierte maximale Länge.
Der Benutzer verfügt nicht über die erforderliche Berechtigung.
Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.
UICancelOption ist auf ThrowException festgelegt, und entweder hat der Benutzer den Vorgang abgebrochen, oder ein nicht näher bezeichneter E/A-Fehler tritt auf.
Beispiele
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert, ohne vorhandene Dateien zu überschreiben.
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.
In diesem Beispiel wird die Datei Test.txt in das Verzeichnis TestFiles2 kopiert und umbenannt 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.
Hinweise
CopyFilebehält keine ACEs (Access Control Einträge) bei. Die neu erstellte Datei erbt Standard-ACEs aus dem Verzeichnis, in dem sie erstellt wird.
In der folgenden Tabelle sind Beispiele für Aufgaben aufgeführt, die die My.Computer.FileSystem.CopyFile -Methode betreffen.
| Beschreibung | Siehe |
|---|---|
| Kopieren Sie eine Datei in dasselbe Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei im gleichen Verzeichnis |
| Kopieren Sie eine Datei in ein anderes Verzeichnis. | Vorgehensweise: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis |
Weitere Informationen
- UICancelOption
- Objekte (Visual Basic)
- Gewusst wie: Kopieren von Dateien mit einem bestimmten Muster in ein Verzeichnis in Visual Basic
- Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
- Gewusst wie: Kopieren eines Verzeichnisses in ein anderes Verzeichnis in Visual Basic
- Gewusst wie: Umbenennen einer Datei in Visual Basic
Gilt für:
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für