FileSystemProxy.MoveFile Metod
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Flyttar en fil till en ny plats.
Överlagringar
| Name | Description |
|---|---|
| MoveFile(String, String) |
Flyttar en fil till en ny plats. |
| MoveFile(String, String, UIOption) |
Flyttar en fil till en ny plats. |
| MoveFile(String, String, Boolean) |
Flyttar en fil till en ny plats. |
| MoveFile(String, String, UIOption, UICancelOption) |
Flyttar en fil till en ny plats. |
MoveFile(String, String)
Flyttar en fil till en ny plats.
public:
void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);public void MoveFile(string sourceFileName, string destinationFileName);member this.MoveFile : string * string -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String)Parametrar
- sourceFileName
- String
Sökvägen till filen som ska flyttas.
- destinationFileName
- String
Sökväg till den katalog som filen ska flyttas till.
Undantag
Sökvägen är inte giltig av någon av följande orsaker: det är en sträng med noll längd. den innehåller endast tomt utrymme. den innehåller ogiltiga tecken. eller så är det en enhetssökväg (börjar med \\.\); det slutar med ett avslutande snedstreck.
destinationFileName är Nothing eller en tom sträng.
Källfilen är ogiltig eller finns inte.
Filen används av en annan process eller så uppstår ett I/O-fel.
Sökvägen överskrider den systemdefinierade maximala längden.
Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.
Användaren saknar nödvändiga behörigheter för att visa sökvägen.
Exempel
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2 och byter namn på den Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Kommentarer
Om målstrukturen inte finns skapas den.
Metoden MoveFile bevarar endast ACL:er (Access Control poster) när filen flyttas inom samma volym. Detta inkluderar ärvda ACL:er, som blir direkta ACL:er när de flyttas (direkta ACL:er har företräde framför ärvda ACL:er). Om en fil flyttas mellan volymer kopieras inte ACL:er.
I följande tabell visas ett exempel på en uppgift som involverar My.Computer.FileSystem.MoveFile metoden.
| Till | Se |
|---|---|
| Flytta en fil | Gör så här: Flytta en fil |
Se även
Gäller för
MoveFile(String, String, UIOption)
Flyttar en fil till en ny plats.
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)Parametrar
- sourceFileName
- String
Sökvägen till filen som ska flyttas.
- destinationFileName
- String
Sökväg till den katalog som filen ska flyttas till.
- showUI
- UIOption
Anger om åtgärdens förlopp ska spåras visuellt. Standard är UIOption.OnlyErrorDialogs.
Undantag
Sökvägen är inte giltig av någon av följande orsaker: det är en sträng med noll längd. den innehåller endast tomt utrymme. den innehåller ogiltiga tecken. eller så är det en enhetssökväg (börjar med \\.\); det slutar med ett avslutande snedstreck.
destinationFileName är Nothing eller en tom sträng.
Källfilen är ogiltig eller finns inte.
Filen används av en annan process eller så uppstår ett I/O-fel.
Sökvägen överskrider den systemdefinierade maximala längden.
Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.
Användaren saknar nödvändiga behörigheter för att visa sökvägen.
Exempel
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2 och byter namn på den Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Kommentarer
Om målstrukturen inte finns skapas den.
Metoden MoveFile bevarar endast ACL:er (Access Control poster) när filen flyttas inom samma volym. Detta inkluderar ärvda ACL:er, som blir direkta ACL:er när de flyttas (direkta ACL:er har företräde framför ärvda ACL:er). Om en fil flyttas mellan volymer kopieras inte ACL:er.
I följande tabell visas ett exempel på en uppgift som involverar My.Computer.FileSystem.MoveFile metoden.
| Till | Se |
|---|---|
| Flytta en fil | Gör så här: Flytta en fil |
Se även
Gäller för
MoveFile(String, String, Boolean)
Flyttar en fil till en ny plats.
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)Parametrar
- sourceFileName
- String
Sökvägen till filen som ska flyttas.
- destinationFileName
- String
Sökväg till den katalog som filen ska flyttas till.
- overwrite
- Boolean
True för att skriva över befintliga filer. annars False. Standard är False.
Undantag
Sökvägen är inte giltig av någon av följande orsaker: det är en sträng med noll längd. den innehåller endast tomt utrymme. den innehåller ogiltiga tecken. eller så är det en enhetssökväg (börjar med \\.\); det slutar med ett avslutande snedstreck.
destinationFileName är Nothing eller en tom sträng.
Källfilen är ogiltig eller finns inte.
Filen används av en annan process eller så uppstår ett I/O-fel.
Sökvägen överskrider den systemdefinierade maximala längden.
Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.
Användaren saknar nödvändiga behörigheter för att visa sökvägen.
Exempel
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2 och byter namn på den Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Kommentarer
Om målstrukturen inte finns skapas den.
Metoden MoveFile bevarar endast ACL:er (Access Control poster) när filen flyttas inom samma volym. Detta inkluderar ärvda ACL:er, som blir direkta ACL:er när de flyttas (direkta ACL:er har företräde framför ärvda ACL:er). Om en fil flyttas mellan volymer kopieras inte ACL:er.
I följande tabell visas ett exempel på en uppgift som involverar My.Computer.FileSystem.MoveFile metoden.
| Till | Se |
|---|---|
| Flytta en fil | Gör så här: Flytta en fil |
Se även
Gäller för
MoveFile(String, String, UIOption, UICancelOption)
Flyttar en fil till en ny plats.
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 -> unitPublic Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)Parametrar
- sourceFileName
- String
Sökvägen till filen som ska flyttas.
- destinationFileName
- String
Sökväg till den katalog som filen ska flyttas till.
- showUI
- UIOption
Anger om åtgärdens förlopp ska spåras visuellt. Standard är UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Anger om ett undantag utlöses när användaren avbryter åtgärden. Standard är UICancelOption.ThrowException.
Undantag
Sökvägen är inte giltig av någon av följande orsaker: det är en sträng med noll längd. den innehåller endast tomt utrymme. den innehåller ogiltiga tecken. eller så är det en enhetssökväg (börjar med \\.\); det slutar med ett avslutande snedstreck.
destinationFileName är Nothing eller en tom sträng.
Källfilen är ogiltig eller finns inte.
Filen används av en annan process eller så uppstår ett I/O-fel.
onUserCancel är inställt på ThrowException, och antingen har användaren avbrutit åtgärden eller så inträffar ett ospecificerat I/O-fel.
Sökvägen överskrider den systemdefinierade maximala längden.
Ett fil- eller katalognamn i sökvägen innehåller ett kolon (:) eller är i ett ogiltigt format.
Användaren saknar nödvändiga behörigheter för att visa sökvägen.
Exempel
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
Det här exemplet flyttar filen Test.txt från TestDir1 till TestDir2 och byter namn på den Test2.txt.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Kommentarer
Om målstrukturen inte finns skapas den.
Metoden MoveFile bevarar endast ACL:er (Access Control poster) när filen flyttas inom samma volym. Detta inkluderar ärvda ACL:er, som blir direkta ACL:er när de flyttas (direkta ACL:er har företräde framför ärvda ACL:er). Om en fil flyttas mellan volymer kopieras inte ACL:er.
I följande tabell visas ett exempel på en uppgift som involverar My.Computer.FileSystem.MoveFile metoden.
| Till | Se |
|---|---|
| Flytta en fil | Gör så här: Flytta en fil |