Udostępnij za pośrednictwem


FileSystem.MoveFile Metoda

Definicja

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
Źródło:
FileSystem.vb
Ź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

Ś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.

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

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

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

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

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

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

Dotyczy

MoveFile(String, String, UIOption)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Ź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

Ś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.

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

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

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

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

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

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ż

Dotyczy

MoveFile(String, String, Boolean)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Ź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

Ś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.

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

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

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

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

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

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

Dotyczy

MoveFile(String, String, UIOption, UICancelOption)

Źródło:
FileSystem.vb
Źródło:
FileSystem.vb
Ź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

Ś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.

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

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

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

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

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

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

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ż

Dotyczy