Teilen über


FileSystem.CopyFile Methode

Definition

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)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Kopiert eine Datei an einen neuen Speicherort.

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

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 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. Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis. Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyFile(String, String, UIOption)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Kopiert eine Datei an einen neuen Speicherort.

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

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 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. Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis. Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyFile(String, String, Boolean)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Kopiert eine Datei an einen neuen Speicherort.

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

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 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. Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis. Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Weitere Informationen

Gilt für:

CopyFile(String, String, UIOption, UICancelOption)

Quelle:
FileSystem.vb
Quelle:
FileSystem.vb
Quelle:
FileSystem.vb

Kopiert eine Datei an einen neuen Speicherort.

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

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 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. Gewusst wie: Erstellen einer Kopie einer Datei im gleichen Ordner in Visual Basic
Kopieren Sie eine Datei in ein anderes Verzeichnis. Gewusst wie: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis in Visual Basic

Weitere Informationen

Gilt für: