FileSystemProxy.CopyFile Methode

Definition

Namespace:: Microsoft.VisualBasic.MyServices

Assembly:: Microsoft.VisualBasic.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

Name	Beschreibung
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 datei, die kopiert werden soll.

destinationFileName: String

Der Speicherort, in 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 verwendet.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

SecurityException

Der Benutzer verfügt nicht über erforderliche 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

CopyFile behält ACEs (Access Control Einträge) nicht bei. Die neu erstellte Datei erbt Standard-ACEs vom 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.

To	Siehe
Kopieren Sie eine Datei in dasselbe Verzeichnis.	Gewusst wie: Erstellen einer Kopie einer Datei im selben 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 datei, die kopiert werden soll.

destinationFileName: String

Der Speicherort, in den die Datei kopiert werden soll.

showUI: UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt 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 vorhanden und overwrite auf False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

SecurityException

Der Benutzer verfügt nicht über erforderliche 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

CopyFile behält ACEs (Access Control Einträge) nicht bei. Die neu erstellte Datei erbt Standard-ACEs vom 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.

To	Siehe
Kopieren Sie eine Datei in dasselbe Verzeichnis.	Gewusst wie: Erstellen einer Kopie einer Datei im selben 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 datei, die kopiert werden soll.

destinationFileName: String

Der Speicherort, in 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 vorhanden und overwrite auf False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

SecurityException

Der Benutzer verfügt nicht über erforderliche 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

CopyFile behält ACEs (Access Control Einträge) nicht bei. Die neu erstellte Datei erbt Standard-ACEs vom 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.

To	Siehe
Kopieren Sie eine Datei in dasselbe Verzeichnis.	Gewusst wie: Erstellen einer Kopie einer Datei im selben 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 datei, die kopiert werden soll.

destinationFileName: String

Der Speicherort, in den die Datei kopiert werden soll.

showUI: UIOption

Gibt an, ob der Fortschritt des Vorgangs visuell nachverfolgt 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 vorhanden und overwrite auf False.

NotSupportedException

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

PathTooLongException

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

UnauthorizedAccessException

Der Benutzer verfügt nicht über erforderliche Berechtigungen.

SecurityException

Der Benutzer verfügt nicht über erforderliche Berechtigungen zum Anzeigen des Pfads.

OperationCanceledException

UICancelOption ist auf ThrowException" festgelegt" und der Benutzer hat den Vorgang abgebrochen, oder ein nicht angegebener 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 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

CopyFile behält ACEs (Access Control Einträge) nicht bei. Die neu erstellte Datei erbt Standard-ACEs vom 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.

To	Siehe
Kopieren Sie eine Datei in dasselbe Verzeichnis.	Gewusst wie: Erstellen einer Kopie einer Datei im selben Verzeichnis
Kopieren Sie eine Datei in ein anderes Verzeichnis.	Vorgehensweise: Erstellen einer Kopie einer Datei in einem anderen Verzeichnis

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?