Share via

FileSystemProxy.MoveFile Metoda

  • Reference

Definice

Obor názvů:
Microsoft.VisualBasic.MyServices
Sestavení:
Microsoft.VisualBasic.dll
Sestavení:
Microsoft.VisualBasic.Forms.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)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public void MoveFile (string sourceFileName, string destinationFileName);
member this.MoveFile : string * string -> unit
Public 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á v jiném procesu nebo dojde k vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

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

Tento příklad přesune soubor Test.txt z TestDir1 do 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 Položky) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděné ACE, které se při přesunutí 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.

Následující tabulka uvádí příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr Seznamte se s 
Přesunutí souboru Postupy: Přesunutí souboru

Viz také

Platí pro

MoveFile(String, String, UIOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public 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, jestli 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á v jiném procesu nebo dojde k vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

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

Tento příklad přesune soubor Test.txt z TestDir1 do 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 Položky) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděné ACE, které se při přesunutí 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.

Následující tabulka uvádí příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr Seznamte se s 
Přesunutí souboru Postupy: Přesunutí souboru

Viz také

Platí pro

MoveFile(String, String, Boolean)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public void MoveFile (string sourceFileName, string destinationFileName, bool overwrite);
member this.MoveFile : string * string * bool -> unit
Public 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á v jiném procesu nebo dojde k vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

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

Tento příklad přesune soubor Test.txt z TestDir1 do 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 Položky) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděné ACE, které se při přesunutí 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.

Následující tabulka uvádí příklady úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr Seznamte se s 
Přesunutí souboru Postupy: Přesunutí souboru

Viz také

Platí pro

MoveFile(String, String, UIOption, UICancelOption)

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

public:
 void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void MoveFile (string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public 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, jestli se má vizuálně sledovat průběh operace. Výchozí je UIOption.OnlyErrorDialogs.

onUserCancel
UICancelOption

Určuje, jestli 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á v jiném procesu nebo dojde k vstupně-výstupní chybě.

OperationCanceledException

onUserCancel Je nastavená na ThrowExceptionhodnotu a buď uživatel zrušil operaci, nebo dojde k nespecifikované vstupně-výstupní chybě.

PathTooLongException

Cesta přesahuje systémem definovanou maximální délku.

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

Tento příklad přesune soubor Test.txt z TestDir1 do 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 Položky) pouze při přesouvání souboru v rámci stejného svazku. To zahrnuje zděděné ACE, které se při přesunutí 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.

Následující tabulka uvádí příklad úlohy zahrnující metodu My.Computer.FileSystem.MoveFile .

Záměr Seznamte se s 
Přesunutí souboru Postupy: Přesunutí souboru

Viz také

Platí pro