FileSystem.MoveFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.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)

Źródło:

FileSystem.vb

Przenosi plik do nowej lokalizacji.

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

public static void MoveFile (string sourceFileName, string destinationFileName);

static member MoveFile : string * string -> unit

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

Parametry

sourceFileName

String

Ścieżka pliku do przeniesienia.

destinationFileName

String

Ścieżka katalogu, do którego ma zostać przeniesiony 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ę końcowym ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing ciągiem lub ciągiem pustym.

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 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	Porady: przenoszenie pliku w Visual Basic

MoveFile(String, String, UIOption)

Źródło:

FileSystem.vb

Przenosi plik do nowej lokalizacji.

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

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

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

Public Shared 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 ma zostać przeniesiony 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ę końcowym ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing ciągiem lub ciągiem pustym.

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 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	Porady: przenoszenie pliku w Visual Basic

Zobacz też

• UIOption

MoveFile(String, String, Boolean)

Źródło:

FileSystem.vb

Przenosi plik do nowej lokalizacji.

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

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

static member MoveFile : string * string * bool -> unit

Public Shared 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 ma zostać przeniesiony 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ę końcowym ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing ciągiem lub ciągiem pustym.

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 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	Porady: przenoszenie pliku w Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Źródło:

FileSystem.vb

Przenosi plik do nowej lokalizacji.

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

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

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

Public Shared 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 ma zostać przeniesiony 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ę końcowym ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing ciągiem lub ciągiem pustym.

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	Porady: przenoszenie pliku w Visual Basic

Zobacz też

• UIOption
• UICancelOption