FileSystemProxy.MoveFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.MyServices

Zestaw:

Microsoft.VisualBasic.Forms.dll

Przenosi plik do nowej lokalizacji.

Przeciążenia

MoveFile(String, String)	Przenosi plik do nowej lokalizacji.
MoveFile(String, String, UIOption)	Przenosi plik do nowej lokalizacji.
MoveFile(String, String, Boolean)	Przenosi plik do nowej lokalizacji.
MoveFile(String, String, UIOption, UICancelOption)	Przenosi plik do nowej lokalizacji.

MoveFile(String, String)

Przenosi plik do nowej lokalizacji.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);

public void MoveFile (string sourceFileName, string destinationFileName);

member this.MoveFile : string * string -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String)

Parametry

sourceFileName

String

Ścieżka pliku do przeniesienia.

destinationFileName

String

Ścieżka katalogu, do którego należy przenieść plik.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

destinationFileName jest lub pusty Nothing ciąg.

FileNotFoundException

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

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

PathTooLongException

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

NotSupportedException

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

SecurityException

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

Przykłady

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2 i zmieni jego Test2.txtnazwę .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje acEs (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone acE, które stają się bezpośrednimi acEs po przeniesieniu (bezpośrednie acE mają pierwszeństwo przed dziedziczyłymi acEs). Jeśli plik zostanie przeniesiony między woluminami, pliki ACE nie zostaną skopiowane.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.MoveFile .

Działanie	Zobacz
Przenoszenie pliku	Instrukcje: Przenoszenie pliku

Zobacz też

• Obiekty (Visual Basic)
• Tworzenie, usuwanie i przenoszenie plików i katalogów w Visual Basic

MoveFile(String, String, UIOption)

Przenosi plik do nowej lokalizacji.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)

Parametry

sourceFileName

String

Ścieżka pliku do przeniesienia.

destinationFileName

String

Ścieżka katalogu, do którego należy przenieść plik.

showUI

UIOption

Określa, czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

destinationFileName jest lub pusty Nothing ciąg.

FileNotFoundException

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

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

PathTooLongException

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

NotSupportedException

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

SecurityException

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

Przykłady

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2 i zmieni jego Test2.txtnazwę .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje acEs (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone acE, które stają się bezpośrednimi acEs po przeniesieniu (bezpośrednie acE mają pierwszeństwo przed dziedziczyłymi acEs). Jeśli plik zostanie przeniesiony między woluminami, pliki ACE nie zostaną skopiowane.

W poniższej tabeli wymieniono przykład zadania obejmującego metodę My.Computer.FileSystem.MoveFile .

Działanie	Zobacz
Przenoszenie pliku	Instrukcje: Przenoszenie pliku

Zobacz też

• UIOption
• Obiekty (Visual Basic)
• Tworzenie, usuwanie i przenoszenie plików i katalogów w Visual Basic

MoveFile(String, String, Boolean)

Przenosi plik do nowej lokalizacji.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);

public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);

member this.MoveFile : string * string * bool -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)

Parametry

sourceFileName

String

Ścieżka pliku do przeniesienia.

destinationFileName

String

Ścieżka katalogu, do którego należy przenieść plik.

overwrite

Boolean

True aby zastąpić istniejące pliki; w przeciwnym razie False. Wartość domyślna to False.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

destinationFileName jest lub pusty Nothing ciąg.

FileNotFoundException

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

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

PathTooLongException

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

NotSupportedException

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

SecurityException

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

Przykłady

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2 i zmieni jego Test2.txtnazwę .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje acEs (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone acE, które stają się bezpośrednimi acEs po przeniesieniu (bezpośrednie acE mają pierwszeństwo przed dziedziczyłymi acEs). Jeśli plik zostanie przeniesiony między woluminami, pliki ACE nie zostaną skopiowane.

W poniższej tabeli wymieniono przykłady zadania obejmującego metodę My.Computer.FileSystem.MoveFile .

Działanie	Zobacz
Przenoszenie pliku	Instrukcje: Przenoszenie pliku

Zobacz też

• Obiekty (Visual Basic)
• Tworzenie, usuwanie i przenoszenie plików i katalogów w Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Przenosi plik do nowej lokalizacji.

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)

Parametry

sourceFileName

String

Ścieżka pliku do przeniesienia.

destinationFileName

String

Ścieżka katalogu, do którego należy przenieść plik.

showUI

UIOption

Określa, czy wizualnie śledzić postęp operacji. Wartość domyślna to UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Określa, czy wyjątek jest zgłaszany, gdy użytkownik anuluje operację. Wartość domyślna to UICancelOption.ThrowException.

Wyjątki

ArgumentException

Ścieżka jest nieprawidłowa z jednego z następujących powodów: jest to ciąg o zerowej długości; zawiera tylko białe znaki; zawiera nieprawidłowe znaki; lub jest to ścieżka urządzenia (rozpoczyna się od \\.\); kończy się ukośnikiem.

ArgumentNullException

destinationFileName jest lub pusty Nothing ciąg.

FileNotFoundException

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

IOException

Plik jest używany przez inny proces lub występuje błąd we/wy.

OperationCanceledException

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

PathTooLongException

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

NotSupportedException

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

SecurityException

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

Przykłady

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2.

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")

W tym przykładzie plik Test.txt zostanie przeniesiony z TestDir1 do TestDir2 i zmieni jego Test2.txtnazwę .

My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje acE (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to odziedziczone ACE, które stają się bezpośrednimi ACL po przeniesieniu (bezpośrednie ACE mają pierwszeństwo przed dziedziczymi ACL). Jeśli plik zostanie przeniesiony między woluminami, pliki ACL nie zostaną skopiowane.

W poniższej tabeli przedstawiono przykład zadania obejmującego metodę My.Computer.FileSystem.MoveFile .

Działanie	Zobacz
Przenoszenie pliku	Instrukcje: Przenoszenie pliku

Zobacz też

• UIOption
• UICancelOption
• Tworzenie, usuwanie i przenoszenie plików i katalogów w Visual Basic