My.Computer.FileSystem.CopyFile-Methode
Aktualisiert: November 2007
Kopiert eine Datei an einen neuen Speicherort.
' Usage
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,overwrite)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI)
My.Computer.FileSystem.CopyFile(sourceFileName ,destinationFileName ,showUI ,onUserCancel)
' Declaration
Public Sub CopyFile( _
ByVal sourceFileName As String, _
ByVal destinationFileName As String _
)
' -or-
Public Sub CopyFile( _
ByVal sourceFileName As String, _
ByVal destinationFileName As String, _
ByVal overwrite As Boolean _
)
' -or-
Public Sub CopyFile( _
ByVal sourceFileName As String, _
ByVal destinationFileName As String, _
ByVal showUI As UIOption _
)
' -or-
Public Sub CopyFile( _
ByVal sourceFileName As String, _
ByVal destinationFileName As String, _
ByVal showUI As UIOption, _
ByVal onUserCancel As UICancelOption _
)
Parameter
sourceFileName
String. Die zu kopierende Datei. Erforderlich.destinationFileName
String. Der Speicherort, an den die Datei kopiert werden soll. Erforderlich.overwrite
Boolean. Ob vorhandene Dateien überschrieben werden sollen. Der Standardwert ist False. Erforderlich.showUI
UIOption. Ob der Status des Vorgangs visuell nachverfolgt werden soll. Der Standardwert ist UIOption.OnlyErrorDialogs. Erforderlich.onUserCancel
UICancelOption. Gibt an, was geschehen soll, wenn der Benutzer während des Vorgangs auf Abbrechen klickt. Der Standardwert ist ThrowException. Erforderlich.
Ausnahmen
Die folgenden Bedingungen verursachen möglicherweise das Auslösen einer Ausnahme:
Der Pfad ist aus einem der folgenden Gründe ungültig: Es handelt sich um eine Zeichenfolge der Länge 0 (null), der Pfad enthält nur Leerzeichen, er enthält ungültige Zeichen, oder es handelt sich um einen Gerätepfad (beginnt mit \\.\) (ArgumentException).
Das System konnte den absoluten Pfad nicht abrufen (ArgumentException).
destinationFileName enthält Pfadinformationen (ArgumentException).
Der Pfad ist ungültig, da er Nothing ist (ArgumentNullException).
destinationFileName ist Nothing oder eine leere Zeichenfolge (ArgumentNullException).
Die Quelldatei ist ungültig oder nicht vorhanden (FileNotFoundException).
Der kombinierte Pfad zeigt auf ein vorhandenes Verzeichnis (IOException).
Die Zieldatei ist vorhanden, und overwrite ist auf False festgelegt (IOException).
Der Benutzer verfügt nicht über ausreichende Berechtigungen für den Zugriff auf die Datei (IOException).
Eine Datei im Zielverzeichnis mit dem gleichen Namen wird gegenwärtig verwendet (IOException).
Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format (NotSupportedException).
UICancelOption ist auf ThrowException festgelegt, und der Benutzer hat den Vorgang abgebrochen (OperationCanceledException).
UICancelOption ist auf ThrowException festgelegt, und ein nicht näher bezeichneter E/A-Fehler tritt auf (OperationCanceledException).
Der Pfad überschreitet die im System definierte maximale Länge (PathTooLongException).
Der Benutzer verfügt nicht über die erforderliche Berechtigung (UnauthorizedAccessException).
Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Anzeigen des Pfads (SecurityException).
Hinweise
CopyFile behält Einträge für die Zugriffssteuerung (ACEs, Access Control Entries) nicht bei. Die neu erstellte Datei erbt Standard-ACEs von dem Verzeichnis, in dem sie erstellt wird.
Aufgaben
In der folgenden Tabelle werden Beispiele für Aufgaben mit der My.Computer.FileSystem.CopyFile-Methode aufgeführt.
Zweck |
Weitere Informationen finden Sie unter |
---|---|
Kopieren einer Datei in das gleiche Verzeichnis |
Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic |
Kopieren einer Datei in ein anderes Verzeichnis |
Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic |
Beispiel
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")
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 in NewFile.txt umbenannt.
My.Computer.FileSystem.CopyFile _
("C:\UserFiles\TestFiles\test.txt", _
"C:\UserFiles\TestFiles2", "NewFile.txt", FileIO.UICancelOption.DoNothing)
Ersetzen Sie die Dateipfade durch die Pfade, die Sie im Code verwenden möchten.
Anforderungen
Namespace:Microsoft.VisualBasic.MyServices
Klasse:FileSystemProxy (ermöglicht den Zugriff auf FileSystem)
Assembly: Visual Basic-Laufzeitbibliothek (in Microsoft.VisualBasic.dll)
Verfügbarkeit nach Projekttyp
Projekttyp |
Verfügbar |
---|---|
Windows-Anwendung |
Ja |
Klassenbibliothek |
Ja |
Konsolenanwendung |
Ja |
Windows-Steuerelementbibliothek |
Ja |
Web-Steuerelementbibliothek |
Ja |
Windows-Dienst |
Ja |
Website |
Ja |
Berechtigungen
Die folgenden Berechtigungen sind möglicherweise erforderlich:
Berechtigung |
Beschreibung |
---|---|
Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
|
Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
|
Steuert die Fähigkeit, auf Registrierungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted. |
|
Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows. |
Weitere Informationen finden Sie unter Codezugriffssicherheit und unter Anfordern von Berechtigungen.
Siehe auch
Aufgaben
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