My.Computer.FileSystem.CopyFile-Methode

Artikel
09/02/2008

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
EnvironmentPermission	Steuert die Fähigkeit, auf alle Umgebungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted.
FileIOPermission	Steuert die Fähigkeit, auf Dateien und Ordner zuzugreifen. Zugeordnete Enumeration: Unrestricted.
RegistryPermission	Steuert die Fähigkeit, auf Registrierungsvariablen zuzugreifen. Zugeordnete Enumeration: Unrestricted.
UIPermission	Steuert die Berechtigungen für Benutzeroberflächen und die Zwischenablage. Zugeordnete Enumeration: SafeSubWindows.