FileSystemProxy.MoveFile Metoda

Definice

Obor názvů:

Microsoft.VisualBasic.MyServices

Sestavení:

Microsoft.VisualBasic.dll

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

Přetížení

Name	Description
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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

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 vstupně-výstupní 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

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á acEs (Access Control Entries) pouze při přesouvání souboru ve stejném svazku. To zahrnuje zděděné ace, které se při přesunutí stanou přímými aces (přímé řízení přístupu mají přednost před zděděnými aces). Pokud se soubor přesune mezi svazky, střídavá kopie se nezkopíruje.

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

To	Podívejte se
Přesunutí souboru	Postupy: Přesunutí souboru

Viz také

• Objekty (Visual Basic)
• Vytvoření, odstranění a přesouvání souborů a adresářů v 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í hodnota 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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

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 vstupně-výstupní 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

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á acEs (Access Control Entries) pouze při přesouvání souboru ve stejném svazku. To zahrnuje zděděné ace, které se při přesunutí stanou přímými aces (přímé řízení přístupu mají přednost před zděděnými aces). Pokud se soubor přesune mezi svazky, střídavá kopie se nezkopíruje.

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

To	Podívejte se
Přesunutí souboru	Postupy: Přesunutí souboru

Viz také

• UIOption
• Objekty (Visual Basic)
• Vytvoření, odstranění a přesouvání souborů a adresářů v 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řepsání existujících souborů; jinak False. Výchozí hodnota 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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

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 vstupně-výstupní 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

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á acEs (Access Control Entries) pouze při přesouvání souboru ve stejném svazku. To zahrnuje zděděné ace, které se při přesunutí stanou přímými aces (přímé řízení přístupu mají přednost před zděděnými aces). Pokud se soubor přesune mezi svazky, střídavá kopie se nezkopíruje.

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

To	Podívejte se
Přesunutí souboru	Postupy: Přesunutí souboru

Viz také

• Objekty (Visual Basic)
• Vytvoření, odstranění a přesouvání souborů a adresářů v 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í hodnota je UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Určuje, zda je vyvolán výjimka při zrušení operace uživatelem. Výchozí hodnota 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 je to cesta zařízení (začíná na \\.\); končí koncové lomítko.

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 vstupně-výstupní chybě.

OperationCanceledException

onUserCancel je nastavena na ThrowExceptionhodnotu a buď uživatel zrušil operaci, nebo dojde k nezadané vstupně-výstupní 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

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á acEs (Access Control Entries) pouze při přesouvání souboru ve stejném svazku. To zahrnuje zděděné ace, které se při přesunutí stanou přímými aces (přímé řízení přístupu mají přednost před zděděnými aces). Pokud se soubor přesune mezi svazky, střídavá kopie se nezkopíruje.

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

To	Podívejte se
Přesunutí souboru	Postupy: Přesunutí souboru

Viz také

• UIOption
• UICancelOption
• Vytvoření, odstranění a přesouvání souborů a adresářů v Visual Basic