FileSystem.MoveFile Metoda

Definicja

Przestrzeń nazw:

Microsoft.VisualBasic.FileIO

Zestaw:

Microsoft.VisualBasic.Core.dll

Przenosi plik do nowej lokalizacji.

Przeciążenia

Nazwa	Opis
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ę ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing lub pusty 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 jest przenoszony z TestDir1 do TestDir2.

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

Ten przykład przenosi plik Test.txt z TestDir1 do TestDir2 i zmienia jego nazwę Test2.txt.

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

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje elementy ACE (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone elementy ACL, które stają się bezpośrednimi ACL po przeniesieniu (bezpośrednie ace mają pierwszeństwo przed dziedziczymi sieciami ACL). 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 .

Do	Zobacz
Przenoszenie pliku	Jak przenieść plik 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ę ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing lub pusty 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 jest przenoszony z TestDir1 do TestDir2.

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

Ten przykład przenosi plik Test.txt z TestDir1 do TestDir2 i zmienia jego nazwę Test2.txt.

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

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje elementy ACE (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone elementy ACL, które stają się bezpośrednimi ACL po przeniesieniu (bezpośrednie ace mają pierwszeństwo przed dziedziczymi sieciami ACL). 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 .

Do	Zobacz
Przenoszenie pliku	Jak przenieść plik 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ę ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing lub pusty 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 jest przenoszony z TestDir1 do TestDir2.

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

Ten przykład przenosi plik Test.txt z TestDir1 do TestDir2 i zmienia jego nazwę Test2.txt.

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

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje elementy ACE (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone elementy ACL, które stają się bezpośrednimi ACL po przeniesieniu (bezpośrednie ace mają pierwszeństwo przed dziedziczymi sieciami ACL). 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 .

Do	Zobacz
Przenoszenie pliku	Jak przenieść plik 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ę ukośnikiem.

ArgumentNullException

destinationFileName jest Nothing lub pusty 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 jest przenoszony z TestDir1 do TestDir2.

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

Ten przykład przenosi plik Test.txt z TestDir1 do TestDir2 i zmienia jego nazwę Test2.txt.

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

Uwagi

Jeśli struktura docelowa nie istnieje, zostanie utworzona.

Metoda MoveFile zachowuje elementy ACE (Access Control Wpisy) tylko podczas przenoszenia pliku w tym samym woluminie. Obejmuje to dziedziczone elementy ACL, które stają się bezpośrednimi ACL po przeniesieniu (bezpośrednie ace mają pierwszeństwo przed dziedziczymi sieciami ACL). 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 .

Do	Zobacz
Przenoszenie pliku	Jak przenieść plik w Visual Basic

Zobacz też

• UIOption
• UICancelOption