FileSystemProxy.MoveFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

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é

• Objekty (Visual Basic)
• Vytváření, odstraňování a přesouvání souborů a adresářů v jazyce Visual Basic

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é

• UIOption
• Objekty (Visual Basic)
• Vytváření, odstraňování a přesouvání souborů a adresářů v jazyce Visual Basic

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é

• Objekty (Visual Basic)
• Vytváření, odstraňování a přesouvání souborů a adresářů v jazyce Visual Basic

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é

• UIOption
• UICancelOption
• Vytváření, odstraňování a přesouvání souborů a adresářů v jazyce Visual Basic