FileSystem.MoveFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.FileIO

Sestavení:

Microsoft.VisualBasic.Core.dll

Přesune soubor do nového umístění.

Přetížení

MoveFile(String, String)	Přesune soubor do nového umístění.
MoveFile(String, String, UIOption)	Přesune soubor do nového umístění.
MoveFile(String, String, Boolean)	Přesune soubor do nového umístění.
MoveFile(String, String, UIOption, UICancelOption)	Přesune soubor do nového umístění.

MoveFile(String, String)

Zdroj:

FileSystem.vb

Přesune soubor do nového umístění.

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

Cesta k souboru, který se má přesunout.

destinationFileName

String

Cesta k adresáři, do kterého se má soubor přesunout.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

destinationFileName je Nothing nebo prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Soubor se používá jiným procesem nebo dojde k chybě vstupně-výstupních operací.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

V tomto příkladu se soubor Test.txt přesune z TestDir1 na TestDir2.

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

Tento příklad přesune soubor Test.txt z TestDir1 do TestDir2 a přejmenuje ho Test2.txt.

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

Poznámky

Pokud cílová struktura neexistuje, vytvoří se.

Metoda MoveFile zachovává ACE (Access Control Entries) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděná ACE, která se při přesunu stanou přímými ACE (přímé ACE mají přednost před zděděnými ACE). Pokud se soubor přesune mezi svazky, nekopírují se ACE.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr	Seznamte se s
Přesunutí souboru	Postupy: Přesunutí souboru v jazyce Visual Basic

MoveFile(String, String, UIOption)

Zdroj:

FileSystem.vb

Přesune soubor do nového umístění.

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

Cesta k souboru, který se má přesunout.

destinationFileName

String

Cesta k adresáři, do kterého se má soubor přesunout.

showUI

UIOption

Určuje, zda se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

destinationFileName je Nothing nebo prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Soubor se používá jiným procesem nebo dojde k chybě vstupně-výstupních operací.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

V tomto příkladu se soubor Test.txt přesune z TestDir1 na TestDir2.

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

Tento příklad přesune soubor Test.txt z TestDir1 do TestDir2 a přejmenuje ho Test2.txt.

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

Poznámky

Pokud cílová struktura neexistuje, vytvoří se.

Metoda MoveFile zachovává ACE (Access Control Entries) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděná ACE, která se při přesunu stanou přímými ACE (přímé ACE mají přednost před zděděnými ACE). Pokud se soubor přesune mezi svazky, nekopírují se ACE.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr	Seznamte se s
Přesunutí souboru	Postupy: Přesunutí souboru v jazyce Visual Basic

Viz také

• UIOption

MoveFile(String, String, Boolean)

Zdroj:

FileSystem.vb

Přesune soubor do nového umístění.

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

Cesta k souboru, který se má přesunout.

destinationFileName

String

Cesta k adresáři, do kterého se má soubor přesunout.

overwrite

Boolean

True přepsat existující soubory; jinak False. Výchozí je False.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

destinationFileName je Nothing nebo prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Soubor se používá jiným procesem nebo dojde k chybě vstupně-výstupních operací.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

V tomto příkladu se soubor Test.txt přesune z TestDir1 na TestDir2.

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

Tento příklad přesune soubor Test.txt z TestDir1 do TestDir2 a přejmenuje ho Test2.txt.

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

Poznámky

Pokud cílová struktura neexistuje, vytvoří se.

Metoda MoveFile zachovává ACE (Access Control Entries) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděná ACE, která se při přesunu stanou přímými ACE (přímé ACE mají přednost před zděděnými ACE). Pokud se soubor přesune mezi svazky, nekopírují se ACE.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr	Seznamte se s
Přesunutí souboru	Postupy: Přesunutí souboru v jazyce Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Zdroj:

FileSystem.vb

Přesune soubor do nového umístění.

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

Cesta k souboru, který se má přesunout.

destinationFileName

String

Cesta k adresáři, do kterého se má soubor přesunout.

showUI

UIOption

Určuje, zda se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Určuje, zda se při zrušení operace uživatelem vyvolá výjimka. Výchozí je UICancelOption.ThrowException.

Výjimky

ArgumentException

Cesta není platná z jednoho z následujících důvodů: jedná se o řetězec nulové délky; obsahuje pouze prázdné znaky; obsahuje neplatné znaky; nebo se jedná o cestu k zařízení (začíná na \\.\); končí koncovým lomítkem.

ArgumentNullException

destinationFileName je Nothing nebo prázdný řetězec.

FileNotFoundException

Zdrojový soubor není platný nebo neexistuje.

IOException

Soubor se používá jiným procesem nebo dojde k chybě vstupně-výstupních operací.

OperationCanceledException

onUserCancel je nastavená na ThrowExceptionhodnotu a uživatel buď operaci zrušil, nebo dojde k nespecifikované V/V chybě.

PathTooLongException

Cesta překračuje maximální délku definovanou systémem.

NotSupportedException

Název souboru nebo adresáře v cestě obsahuje dvojtečku (:) nebo je v neplatném formátu.

SecurityException

Uživatel nemá potřebná oprávnění k zobrazení cesty.

Příklady

V tomto příkladu se soubor Test.txt přesune z TestDir1 na TestDir2.

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

Tento příklad přesune soubor Test.txt z TestDir1 do TestDir2 a přejmenuje ho Test2.txt.

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

Poznámky

Pokud cílová struktura neexistuje, vytvoří se.

Metoda MoveFile zachovává ACE (Access Control Entries) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděná ACE, která se při přesunu stanou přímými ACE (přímé ACE mají přednost před zděděnými ACE). Pokud se soubor přesune mezi svazky, nekopírují se ACE.

V následující tabulce je uveden příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr	Seznamte se s
Přesunutí souboru	Postupy: Přesunutí souboru v jazyce Visual Basic

Viz také

• UIOption
• UICancelOption