FileSystemProxy.MoveFile Metódus

Definíció

Névtér:

Microsoft.VisualBasic.MyServices

Szerelvény:

Microsoft.VisualBasic.Forms.dll

Fájl áthelyezése új helyre.

Túlterhelések

Name	Description
MoveFile(String, String)	Fájl áthelyezése új helyre.
MoveFile(String, String, UIOption)	Fájl áthelyezése új helyre.
MoveFile(String, String, Boolean)	Fájl áthelyezése új helyre.
MoveFile(String, String, UIOption, UICancelOption)	Fájl áthelyezése új helyre.

MoveFile(String, String)

Forrás:

FileSystemProxy.vb

Fájl áthelyezése új helyre.

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)

Paraméterek

sourceFileName

String

Az áthelyezendő fájl elérési útja.

destinationFileName

String

Annak a könyvtárnak az elérési útja, amelybe a fájlt át kell helyezni.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

destinationFileName vagy Nothing üres sztring.

FileNotFoundException

A forrásfájl érvénytelen vagy nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa áthelyezi a fájlt Test.txtTestDir1-ról TestDir2-re.

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

Ez a példa áthelyezi a fájlt a fájlból Test.txtTestDir1 , TestDir2 és átnevezi azt Test2.txt.

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

Megjegyzések

Ha a célstruktúra nem létezik, létrejön.

A MoveFile metódus csak akkor őrzi meg az ACE-ket (Access Control bejegyzéseket), ha a fájlt ugyanabban a kötetben helyezi át. Ide tartoznak az örökölt ACE-k, amelyek áthelyezéskor közvetlen ACE-kké válnak (a közvetlen ACE-k elsőbbséget élveznek az örökölt ACE-vel szemben). Ha a fájl kötetek között van áthelyezve, a rendszer nem másolja az ACL-eket.

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.MoveFile .

Címzett	Nézze
Fájl áthelyezése	Útmutató: Fájl áthelyezése

Lásd még

• Objects (Visual Basic)
• Fájlok és könyvtárak létrehozása, törlése és áthelyezése a Visual Basic

MoveFile(String, String, UIOption)

Forrás:

FileSystemProxy.vb

Fájl áthelyezése új helyre.

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)

Paraméterek

sourceFileName

String

Az áthelyezendő fájl elérési útja.

destinationFileName

String

Annak a könyvtárnak az elérési útja, amelybe a fájlt át kell helyezni.

showUI

UIOption

Meghatározza, hogy a művelet előrehaladását vizuálisan nyomon kell-e követni. Az alapértelmezett érték UIOption.OnlyErrorDialogs.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

destinationFileName vagy Nothing üres sztring.

FileNotFoundException

A forrásfájl érvénytelen vagy nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa áthelyezi a fájlt Test.txtTestDir1-ról TestDir2-re.

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

Ez a példa áthelyezi a fájlt a fájlból Test.txtTestDir1 , TestDir2 és átnevezi azt Test2.txt.

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

Megjegyzések

Ha a célstruktúra nem létezik, létrejön.

A MoveFile metódus csak akkor őrzi meg az ACE-ket (Access Control bejegyzéseket), ha a fájlt ugyanabban a kötetben helyezi át. Ide tartoznak az örökölt ACE-k, amelyek áthelyezéskor közvetlen ACE-kké válnak (a közvetlen ACE-k elsőbbséget élveznek az örökölt ACE-vel szemben). Ha a fájl kötetek között van áthelyezve, a rendszer nem másolja az ACL-eket.

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.MoveFile .

Címzett	Nézze
Fájl áthelyezése	Útmutató: Fájl áthelyezése

Lásd még

• UIOption
• Objects (Visual Basic)
• Fájlok és könyvtárak létrehozása, törlése és áthelyezése a Visual Basic

MoveFile(String, String, Boolean)

Forrás:

FileSystemProxy.vb

Fájl áthelyezése új helyre.

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)

Paraméterek

sourceFileName

String

Az áthelyezendő fájl elérési útja.

destinationFileName

String

Annak a könyvtárnak az elérési útja, amelybe a fájlt át kell helyezni.

overwrite

Boolean

True meglévő fájlok felülírása; egyéb esetben False. Az alapértelmezett érték False.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

destinationFileName vagy Nothing üres sztring.

FileNotFoundException

A forrásfájl érvénytelen vagy nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa áthelyezi a fájlt Test.txtTestDir1-ról TestDir2-re.

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

Ez a példa áthelyezi a fájlt a fájlból Test.txtTestDir1 , TestDir2 és átnevezi azt Test2.txt.

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

Megjegyzések

Ha a célstruktúra nem létezik, létrejön.

A MoveFile metódus csak akkor őrzi meg az ACE-ket (Access Control bejegyzéseket), ha a fájlt ugyanabban a kötetben helyezi át. Ide tartoznak az örökölt ACE-k, amelyek áthelyezéskor közvetlen ACE-kké válnak (a közvetlen ACE-k elsőbbséget élveznek az örökölt ACE-vel szemben). Ha a fájl kötetek között van áthelyezve, a rendszer nem másolja az ACL-eket.

Az alábbi táblázat példákat sorol fel a metódust érintő My.Computer.FileSystem.MoveFile tevékenységekre.

Címzett	Nézze
Fájl áthelyezése	Útmutató: Fájl áthelyezése

Lásd még

• Objects (Visual Basic)
• Fájlok és könyvtárak létrehozása, törlése és áthelyezése a Visual Basic

MoveFile(String, String, UIOption, UICancelOption)

Forrás:

FileSystemProxy.vb

Fájl áthelyezése új helyre.

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)

Paraméterek

sourceFileName

String

Az áthelyezendő fájl elérési útja.

destinationFileName

String

Annak a könyvtárnak az elérési útja, amelybe a fájlt át kell helyezni.

showUI

UIOption

Meghatározza, hogy a művelet előrehaladását vizuálisan nyomon kell-e követni. Az alapértelmezett érték UIOption.OnlyErrorDialogs.

onUserCancel

UICancelOption

Megadja, hogy a rendszer kivételt jelez-e, amikor a felhasználó megszakítja a műveletet. Az alapértelmezett érték UICancelOption.ThrowException.

Kivételek

ArgumentException

Az elérési út az alábbi okok egyike miatt nem érvényes: nulla hosszúságú sztring; csak üres helyet tartalmaz; érvénytelen karaktereket tartalmaz; vagy egy eszköz elérési útja (\\.\-val kezdődik); záró perjellel végződik.

ArgumentNullException

destinationFileName vagy Nothing üres sztring.

FileNotFoundException

A forrásfájl érvénytelen vagy nem létezik.

IOException

A fájlt egy másik folyamat használja, vagy I/O-hiba történik.

OperationCanceledException

onUserCancel beállításra ThrowExceptionvan állítva, és vagy a felhasználó megszakította a műveletet, vagy nem meghatározott I/O-hiba történik.

PathTooLongException

Az elérési út meghaladja a rendszer által megadott maximális hosszt.

NotSupportedException

Az elérési út fájl- vagy könyvtárneve kettőspontot tartalmaz (:) vagy érvénytelen formátumú.

SecurityException

A felhasználó nem rendelkezik az elérési út megtekintéséhez szükséges engedélyekkel.

Példák

Ez a példa áthelyezi a fájlt Test.txtTestDir1-ról TestDir2-re.

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

Ez a példa áthelyezi a fájlt a fájlból Test.txtTestDir1 , TestDir2 és átnevezi azt Test2.txt.

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

Megjegyzések

Ha a célstruktúra nem létezik, létrejön.

A MoveFile metódus csak akkor őrzi meg az ACE-ket (Access Control bejegyzéseket), ha a fájlt ugyanabban a kötetben helyezi át. Ide tartoznak az örökölt ACE-k, amelyek áthelyezéskor közvetlen ACE-kké válnak (a közvetlen ACE-k elsőbbséget élveznek az örökölt ACE-vel szemben). Ha a fájl kötetek között van áthelyezve, a rendszer nem másolja az ACL-eket.

Az alábbi táblázat egy példát sorol fel a metódust érintő feladatra My.Computer.FileSystem.MoveFile .

Címzett	Nézze
Fájl áthelyezése	Útmutató: Fájl áthelyezése

Lásd még

• UIOption
• UICancelOption
• Fájlok és könyvtárak létrehozása, törlése és áthelyezése a Visual Basic