FileSystemProxy.CopyFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.MyServices

Zestaw:

Microsoft.VisualBasic.Forms.dll

Kopiuje plik do nowej lokalizacji.

Przeciążenia

CopyFile(String, String)	Kopiuje plik do nowej lokalizacji.
CopyFile(String, String, UIOption)	Kopiuje plik do nowej lokalizacji.
CopyFile(String, String, Boolean)	Kopiuje plik do nowej lokalizacji.
CopyFile(String, String, UIOption, UICancelOption)	Kopiuje plik do nowej lokalizacji.

CopyFile(String, String)

Kopiuje plik do nowej lokalizacji.

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)

Parametry

sourceFileName

String

Plik do skopiowania.

destinationFileName

String

Lokalizacja, do której ma zostać skopiowany plik.

Wyjątki

ArgumentException

destinationFileName zawiera informacje o ścieżce.

ArgumentNullException

destinationFileName lub sourceFileName jest Nothing pustym ciągiem.

FileNotFoundException

Plik źródłowy jest nieprawidłowy lub nie istnieje.

IOException

Plik w katalogu docelowym o tej samej nazwie jest używany.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Użytkownik nie ma wymaganych uprawnień.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

Ten przykład kopiuje plik Test.txt do katalogu TestFiles2 bez zastępowania istniejących plików.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

W tym przykładzie plik Test.txt jest kopiowany do katalogu TestFiles2 i zmienia jego nazwę NewFile.txt.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

Uwagi

CopyFileprogram nie zachowuje elementów ACE (Access Control wpisów). Nowo utworzony plik dziedziczy domyślne wartości ACE z katalogu, w którym został utworzony.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyFile .

Działanie	Zobacz
Skopiuj plik do tego samego katalogu.	Instrukcje: Tworzenie kopii pliku w tym samym katalogu
Skopiuj plik do innego katalogu.	Instrukcje: Tworzenie kopii pliku w innym katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: kopiowanie plików z określonym wzorcem do katalogu w Visual Basic
• Porady: tworzenie kopii pliku w tym samym katalogu w Visual Basic
• Porady: kopiowanie katalogu do innego katalogu w Visual Basic
• Porady: zmienianie nazwy pliku w Visual Basic

CopyFile(String, String, UIOption)

Kopiuje plik do nowej lokalizacji.

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)

Parametry

sourceFileName

String

Plik do skopiowania.

destinationFileName

String

Lokalizacja, do której ma zostać skopiowany plik.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

Wyjątki

ArgumentException

destinationFileName zawiera informacje o ścieżce.

ArgumentNullException

destinationFileName lub sourceFileName jest Nothing pustym ciągiem.

FileNotFoundException

Plik źródłowy jest nieprawidłowy lub nie istnieje.

IOException

Plik docelowy istnieje i overwrite ma wartość False.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Użytkownik nie ma wymaganych uprawnień.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

Ten przykład kopiuje plik Test.txt do katalogu TestFiles2 bez zastępowania istniejących plików.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

W tym przykładzie plik Test.txt jest kopiowany do katalogu TestFiles2 i zmienia jego nazwę NewFile.txt.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

Uwagi

CopyFileprogram nie zachowuje elementów ACE (Access Control wpisów). Nowo utworzony plik dziedziczy domyślne wartości ACE z katalogu, w którym został utworzony.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyFile .

Działanie	Zobacz
Skopiuj plik do tego samego katalogu.	Instrukcje: Tworzenie kopii pliku w tym samym katalogu
Skopiuj plik do innego katalogu.	Instrukcje: Tworzenie kopii pliku w innym katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: kopiowanie plików z określonym wzorcem do katalogu w Visual Basic
• Porady: tworzenie kopii pliku w tym samym katalogu w Visual Basic
• Porady: kopiowanie katalogu do innego katalogu w Visual Basic
• Porady: zmienianie nazwy pliku w Visual Basic

CopyFile(String, String, Boolean)

Kopiuje plik do nowej lokalizacji.

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)

Parametry

sourceFileName

String

Plik do skopiowania.

destinationFileName

String

Lokalizacja, do której ma zostać skopiowany plik.

overwrite

Boolean

True jeśli istniejące pliki powinny zostać zastąpione; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

destinationFileName zawiera informacje o ścieżce.

ArgumentNullException

destinationFileName lub sourceFileName jest Nothing pustym ciągiem.

FileNotFoundException

Plik źródłowy jest nieprawidłowy lub nie istnieje.

IOException

Plik docelowy istnieje i overwrite ma wartość False.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Użytkownik nie ma wymaganych uprawnień.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

Przykłady

Ten przykład kopiuje plik Test.txt do katalogu TestFiles2 bez zastępowania istniejących plików.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

W tym przykładzie plik Test.txt jest kopiowany do katalogu TestFiles2 i zmienia jego nazwę NewFile.txt.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

Uwagi

CopyFileprogram nie zachowuje elementów ACE (Access Control wpisów). Nowo utworzony plik dziedziczy domyślne wartości ACE z katalogu, w którym został utworzony.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyFile .

Działanie	Zobacz
Skopiuj plik do tego samego katalogu.	Instrukcje: Tworzenie kopii pliku w tym samym katalogu
Skopiuj plik do innego katalogu.	Instrukcje: Tworzenie kopii pliku w innym katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: kopiowanie plików z określonym wzorcem do katalogu w Visual Basic
• Porady: tworzenie kopii pliku w tym samym katalogu w Visual Basic
• Porady: kopiowanie katalogu do innego katalogu w Visual Basic
• Porady: zmienianie nazwy pliku w Visual Basic

CopyFile(String, String, UIOption, UICancelOption)

Kopiuje plik do nowej lokalizacji.

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)

Parametry

sourceFileName

String

Plik do skopiowania.

destinationFileName

String

Lokalizacja, do której ma zostać skopiowany plik.

showUI

UIOption

Czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Określa, co należy zrobić, jeśli użytkownik kliknie przycisk Anuluj podczas operacji. Wartość domyślna to ThrowException.

Wyjątki

ArgumentException

destinationFileName zawiera informacje o ścieżce.

ArgumentNullException

destinationFileName lub sourceFileName jest Nothing pustym ciągiem.

FileNotFoundException

Plik źródłowy jest nieprawidłowy lub nie istnieje.

IOException

Plik docelowy istnieje i overwrite ma wartość False.

NotSupportedException

Nazwa pliku lub katalogu w ścieżce zawiera dwukropek (:) lub jest w nieprawidłowym formacie.

PathTooLongException

Ścieżka przekracza maksymalną długość zdefiniowaną przez system.

UnauthorizedAccessException

Użytkownik nie ma wymaganych uprawnień.

SecurityException

Użytkownik nie ma niezbędnych uprawnień do wyświetlania ścieżki.

OperationCanceledException

UICancelOption jest ustawiona na ThrowExceptionwartość , a użytkownik anulował operację lub wystąpił nieokreślony błąd we/wy.

Przykłady

Ten przykład kopiuje plik Test.txt do katalogu TestFiles2 bez zastępowania istniejących plików.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

W tym przykładzie plik Test.txt jest kopiowany do katalogu TestFiles2 i zmienia jego nazwę NewFile.txt.

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

Zastąp ścieżki plików ścieżkami, których chcesz użyć w kodzie.

Uwagi

CopyFileprogram nie zachowuje elementów ACE (Access Control wpisów). Nowo utworzony plik dziedziczy domyślne wartości ACE z katalogu, w którym został utworzony.

W poniższej tabeli wymieniono przykłady zadań obejmujących metodę My.Computer.FileSystem.CopyFile .

Działanie	Zobacz
Skopiuj plik do tego samego katalogu.	Instrukcje: Tworzenie kopii pliku w tym samym katalogu
Skopiuj plik do innego katalogu.	Instrukcje: Tworzenie kopii pliku w innym katalogu

Zobacz też

• UICancelOption
• Obiekty (Visual Basic)
• Porady: kopiowanie plików z określonym wzorcem do katalogu w Visual Basic
• Porady: tworzenie kopii pliku w tym samym katalogu w Visual Basic
• Porady: kopiowanie katalogu do innego katalogu w Visual Basic
• Porady: zmienianie nazwy pliku w Visual Basic