Sdílet prostřednictvím


FileSystem.MoveFile Metoda

Definice

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
Zdroj:
FileSystem.vb
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

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.

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

Zdrojový soubor není platný nebo neexistuje.

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

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

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

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

Platí pro

MoveFile(String, String, UIOption)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
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

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.

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

Zdrojový soubor není platný nebo neexistuje.

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

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

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

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é

Platí pro

MoveFile(String, String, Boolean)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
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

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.

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

Zdrojový soubor není platný nebo neexistuje.

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

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

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

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

Platí pro

MoveFile(String, String, UIOption, UICancelOption)

Zdroj:
FileSystem.vb
Zdroj:
FileSystem.vb
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

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.

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

Zdrojový soubor není platný nebo neexistuje.

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

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

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

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

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é

Platí pro