Freigeben über


FileSystemProxy.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)

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 -> unit
Public 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

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 -> unit
Public 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

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 -> unit
Public 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

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 -> unit
Public 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

Gilt für: