FileSystemProxy.CopyFile Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.dll

Assembly:: Microsoft.VisualBasic.Forms.dll

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

ArgumentException

destinationFileName enthält Pfadinformationen.

ArgumentNullException

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Eine Datei im Zielverzeichnis mit demselben Namen wird gegenwärtig verwendet.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung.

SecurityException

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

ArgumentException

destinationFileName enthält Pfadinformationen.

ArgumentNullException

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung.

SecurityException

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

ArgumentException

destinationFileName enthält Pfadinformationen.

ArgumentNullException

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung.

SecurityException

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

ArgumentException

destinationFileName enthält Pfadinformationen.

ArgumentNullException

destinationFileName oder sourceFileName ist Nothing oder eine leere Zeichenfolge.

FileNotFoundException

Die Quelldatei ist ungültig oder nicht vorhanden.

IOException

Die Zieldatei ist bereits vorhanden, und overwrite ist auf False festgelegt.

NotSupportedException

Ein Datei- oder Verzeichnisname im Pfad enthält einen Doppelpunkt (:) oder hat ein ungültiges Format.

PathTooLongException

Der Pfad überschreitet die im System definierte maximale Länge.

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderliche Berechtigung.

SecurityException

Dem Benutzer fehlen die erforderlichen Berechtigungen zum Anzeigen des Pfads.

OperationCanceledException

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:

Freigeben über

FileSystemProxy.CopyFile Methode

Definition

Überlädt

CopyFile(String, String)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CopyFile(String, String, UIOption)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CopyFile(String, String, Boolean)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

CopyFile(String, String, UIOption, UICancelOption)

Parameter

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Zusätzliche Ressourcen