FileSystemProxy.CopyFile Metod

Definition

Namnområde:

Microsoft.VisualBasic.MyServices

Sammansättning:

Microsoft.VisualBasic.dll

Kopierar en fil till en ny plats.

Överlagringar

Name	Description
CopyFile(String, String)	Kopierar en fil till en ny plats.
CopyFile(String, String, UIOption)	Kopierar en fil till en ny plats.
CopyFile(String, String, Boolean)	Kopierar en fil till en ny plats.
CopyFile(String, String, UIOption, UICancelOption)	Kopierar en fil till en ny plats.

CopyFile(String, String)

Kopierar en fil till en ny plats.

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)

Parametrar

sourceFileName

String

Filen som ska kopieras.

destinationFileName

String

Den plats som filen ska kopieras till.

Undantag

ArgumentException

destinationFileName innehåller sökvägsinformation.

ArgumentNullException

destinationFileName eller sourceFileName är Nothing eller en tom sträng.

FileNotFoundException

Källfilen är ogiltig eller finns inte.

IOException

En fil i målkatalogen med samma namn används.

NotSupportedException

Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.

PathTooLongException

Sökvägen överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Användaren har inte nödvändig behörighet.

SecurityException

Användaren saknar nödvändiga behörigheter för att visa sökvägen.

Exempel

I det här exemplet kopieras filen Test.txt till katalogen TestFiles2 utan att befintliga filer skrivs över.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Det här exemplet kopierar filen Test.txt till katalogen TestFiles2 och byter namn på den NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Kommentarer

CopyFile bevarar inte ACL:er (Access Control poster). Den nyligen skapade filen ärver standard-ACL:er från katalogen där den skapas.

I följande tabell visas exempel på uppgifter som involverar My.Computer.FileSystem.CopyFile metoden.

Till	Se
Kopiera en fil till samma katalog.	Anvisningar: Skapa en kopia av en fil i samma katalog
Kopiera en fil till en annan katalog.	Anvisningar: Skapa en kopia av en fil i en annan katalog

Se även

• UICancelOption
• Objects (Visual Basic)
• Så här: Kopiera filer med ett specifikt mönster till en katalog i Visual Basic
• Skapa en kopia av en fil i samma katalog i Visual Basic
• Så här: Kopiera en katalog till en annan katalog i Visual Basic
• Anvisningar: Byt namn på en fil i Visual Basic

CopyFile(String, String, UIOption)

Kopierar en fil till en ny plats.

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)

Parametrar

sourceFileName

String

Filen som ska kopieras.

destinationFileName

String

Den plats som filen ska kopieras till.

showUI

UIOption

Om åtgärdens förlopp ska spåras visuellt. Standard är UIOption.OnlyErrorDialogs.

Undantag

ArgumentException

destinationFileName innehåller sökvägsinformation.

ArgumentNullException

destinationFileName eller sourceFileName är Nothing eller en tom sträng.

FileNotFoundException

Källfilen är ogiltig eller finns inte.

IOException

Målfilen finns och overwrite är inställd på False.

NotSupportedException

Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.

PathTooLongException

Sökvägen överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Användaren har inte nödvändig behörighet.

SecurityException

Användaren saknar nödvändiga behörigheter för att visa sökvägen.

Exempel

I det här exemplet kopieras filen Test.txt till katalogen TestFiles2 utan att befintliga filer skrivs över.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Det här exemplet kopierar filen Test.txt till katalogen TestFiles2 och byter namn på den NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Kommentarer

CopyFile bevarar inte ACL:er (Access Control poster). Den nyligen skapade filen ärver standard-ACL:er från katalogen där den skapas.

I följande tabell visas exempel på uppgifter som involverar My.Computer.FileSystem.CopyFile metoden.

Till	Se
Kopiera en fil till samma katalog.	Anvisningar: Skapa en kopia av en fil i samma katalog
Kopiera en fil till en annan katalog.	Anvisningar: Skapa en kopia av en fil i en annan katalog

Se även

• UICancelOption
• Objects (Visual Basic)
• Så här: Kopiera filer med ett specifikt mönster till en katalog i Visual Basic
• Skapa en kopia av en fil i samma katalog i Visual Basic
• Så här: Kopiera en katalog till en annan katalog i Visual Basic
• Anvisningar: Byt namn på en fil i Visual Basic

CopyFile(String, String, Boolean)

Kopierar en fil till en ny plats.

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)

Parametrar

sourceFileName

String

Filen som ska kopieras.

destinationFileName

String

Den plats som filen ska kopieras till.

overwrite

Boolean

True om befintliga filer ska skrivas över; annars False. Standard är False.

Undantag

ArgumentException

destinationFileName innehåller sökvägsinformation.

ArgumentNullException

destinationFileName eller sourceFileName är Nothing eller en tom sträng.

FileNotFoundException

Källfilen är ogiltig eller finns inte.

IOException

Målfilen finns och overwrite är inställd på False.

NotSupportedException

Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.

PathTooLongException

Sökvägen överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Användaren har inte nödvändig behörighet.

SecurityException

Användaren saknar nödvändiga behörigheter för att visa sökvägen.

Exempel

I det här exemplet kopieras filen Test.txt till katalogen TestFiles2 utan att befintliga filer skrivs över.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Det här exemplet kopierar filen Test.txt till katalogen TestFiles2 och byter namn på den NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Kommentarer

CopyFile bevarar inte ACL:er (Access Control poster). Den nyligen skapade filen ärver standard-ACL:er från katalogen där den skapas.

I följande tabell visas exempel på uppgifter som involverar My.Computer.FileSystem.CopyFile metoden.

Till	Se
Kopiera en fil till samma katalog.	Anvisningar: Skapa en kopia av en fil i samma katalog
Kopiera en fil till en annan katalog.	Anvisningar: Skapa en kopia av en fil i en annan katalog

Se även

• UICancelOption
• Objects (Visual Basic)
• Så här: Kopiera filer med ett specifikt mönster till en katalog i Visual Basic
• Skapa en kopia av en fil i samma katalog i Visual Basic
• Så här: Kopiera en katalog till en annan katalog i Visual Basic
• Anvisningar: Byt namn på en fil i Visual Basic

CopyFile(String, String, UIOption, UICancelOption)

Kopierar en fil till en ny plats.

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)

Parametrar

sourceFileName

String

Filen som ska kopieras.

destinationFileName

String

Den plats som filen ska kopieras till.

showUI

UIOption

Om åtgärdens förlopp ska spåras visuellt. Standard är UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Anger vad som ska göras om användaren klickar på Avbryt under åtgärden. Standard är ThrowException.

Undantag

ArgumentException

destinationFileName innehåller sökvägsinformation.

ArgumentNullException

destinationFileName eller sourceFileName är Nothing eller en tom sträng.

FileNotFoundException

Källfilen är ogiltig eller finns inte.

IOException

Målfilen finns och overwrite är inställd på False.

NotSupportedException

Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.

PathTooLongException

Sökvägen överskrider den systemdefinierade maximala längden.

UnauthorizedAccessException

Användaren har inte nödvändig behörighet.

SecurityException

Användaren saknar nödvändiga behörigheter för att visa sökvägen.

OperationCanceledException

UICancelOption är inställt på ThrowException, och användaren har avbrutit åtgärden eller så inträffar ett ospecificerat I/O-fel.

Exempel

I det här exemplet kopieras filen Test.txt till katalogen TestFiles2 utan att befintliga filer skrivs över.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\test.txt", overwrite:=False)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Det här exemplet kopierar filen Test.txt till katalogen TestFiles2 och byter namn på den NewFile.txt.

My.Computer.FileSystem.CopyFile( _
    "C:\UserFiles\TestFiles\test.txt", _
    "C:\UserFiles\TestFiles2\NewFile.txt", _
    FileIO.UIOption.OnlyErrorDialogs, _
    FileIO.UICancelOption.DoNothing)

Ersätt filsökvägarna med de sökvägar som du vill använda i koden.

Kommentarer

CopyFile bevarar inte ACL:er (Access Control poster). Den nyligen skapade filen ärver standard-ACL:er från katalogen där den skapas.

I följande tabell visas exempel på uppgifter som involverar My.Computer.FileSystem.CopyFile metoden.

Till	Se
Kopiera en fil till samma katalog.	Anvisningar: Skapa en kopia av en fil i samma katalog
Kopiera en fil till en annan katalog.	Anvisningar: Skapa en kopia av en fil i en annan katalog

Se även

• UICancelOption
• Objects (Visual Basic)
• Så här: Kopiera filer med ett specifikt mönster till en katalog i Visual Basic
• Skapa en kopia av en fil i samma katalog i Visual Basic
• Så här: Kopiera en katalog till en annan katalog i Visual Basic
• Anvisningar: Byt namn på en fil i Visual Basic