FileSystem.MoveFile Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee verplaatst u een bestand naar een nieuwe locatie.
Overloads
| Name | Description |
|---|---|
| MoveFile(String, String) |
Hiermee verplaatst u een bestand naar een nieuwe locatie. |
| MoveFile(String, String, UIOption) |
Hiermee verplaatst u een bestand naar een nieuwe locatie. |
| MoveFile(String, String, Boolean) |
Hiermee verplaatst u een bestand naar een nieuwe locatie. |
| MoveFile(String, String, UIOption, UICancelOption) |
Hiermee verplaatst u een bestand naar een nieuwe locatie. |
MoveFile(String, String)
Hiermee verplaatst u een bestand naar een nieuwe locatie.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName);
public static void MoveFile(string sourceFileName, string destinationFileName);
static member MoveFile : string * string -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String)
Parameters
- sourceFileName
- String
Het pad van het bestand dat moet worden verplaatst.
- destinationFileName
- String
Pad naar de map waarin het bestand moet worden verplaatst.
Uitzonderingen
Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul; het bevat alleen witruimte; bevat ongeldige tekens; of het is een apparaatpad (begint met \\.\); het eindigt met een afsluitende slash.
destinationFileName is Nothing of een lege tekenreeks.
Het bronbestand is ongeldig of bestaat niet.
Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.
Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.
Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.
De gebruiker beschikt niet over de benodigde machtigingen om het pad weer te geven.
Voorbeelden
In dit voorbeeld wordt het bestand Test.txt verplaatst naar TestDir1TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
In dit voorbeeld wordt het bestand Test.txt verplaatst van TestDir1 naar TestDir2 en wordt de Test2.txtnaam ervan gewijzigd.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Opmerkingen
Als de doelstructuur niet bestaat, wordt deze gemaakt.
De methode MoveFile behoudt ACL's (Access Control vermeldingen) alleen bij het verplaatsen van het bestand binnen hetzelfde volume. Dit omvat overgenomen ACL's, die directe ACL's worden wanneer ze worden verplaatst (directe ACL's hebben voorrang op overgenomen ACL's). Als een bestand tussen volumes wordt verplaatst, worden ACL's niet gekopieerd.
De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.FileSystem.MoveFile methode.
| Tot | Zien! |
|---|---|
| Een bestand verplaatsen | Hoe to: Een bestand verplaatsen in Visual Basic |
Van toepassing op
MoveFile(String, String, UIOption)
Hiermee verplaatst u een bestand naar een nieuwe locatie.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI);
public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption)
Parameters
- sourceFileName
- String
Het pad van het bestand dat moet worden verplaatst.
- destinationFileName
- String
Pad naar de map waarin het bestand moet worden verplaatst.
- showUI
- UIOption
Hiermee geeft u op of de voortgang van de bewerking visueel moet worden bijgehouden. De standaardwaarde is UIOption.OnlyErrorDialogs.
Uitzonderingen
Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul; het bevat alleen witruimte; bevat ongeldige tekens; of het is een apparaatpad (begint met \\.\); het eindigt met een afsluitende slash.
destinationFileName is Nothing of een lege tekenreeks.
Het bronbestand is ongeldig of bestaat niet.
Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.
Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.
Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.
De gebruiker beschikt niet over de benodigde machtigingen om het pad weer te geven.
Voorbeelden
In dit voorbeeld wordt het bestand Test.txt verplaatst naar TestDir1TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
In dit voorbeeld wordt het bestand Test.txt verplaatst van TestDir1 naar TestDir2 en wordt de Test2.txtnaam ervan gewijzigd.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Opmerkingen
Als de doelstructuur niet bestaat, wordt deze gemaakt.
De methode MoveFile behoudt ACL's (Access Control vermeldingen) alleen bij het verplaatsen van het bestand binnen hetzelfde volume. Dit omvat overgenomen ACL's, die directe ACL's worden wanneer ze worden verplaatst (directe ACL's hebben voorrang op overgenomen ACL's). Als een bestand tussen volumes wordt verplaatst, worden ACL's niet gekopieerd.
De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.FileSystem.MoveFile methode.
| Tot | Zien! |
|---|---|
| Een bestand verplaatsen | Hoe to: Een bestand verplaatsen in Visual Basic |
Zie ook
Van toepassing op
MoveFile(String, String, Boolean)
Hiermee verplaatst u een bestand naar een nieuwe locatie.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, bool overwrite);
public static void MoveFile(string sourceFileName, string destinationFileName, bool overwrite);
static member MoveFile : string * string * bool -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, overwrite As Boolean)
Parameters
- sourceFileName
- String
Het pad van het bestand dat moet worden verplaatst.
- destinationFileName
- String
Pad naar de map waarin het bestand moet worden verplaatst.
- overwrite
- Boolean
True bestaande bestanden te overschrijven; anders False. De standaardwaarde is False.
Uitzonderingen
Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul; het bevat alleen witruimte; bevat ongeldige tekens; of het is een apparaatpad (begint met \\.\); het eindigt met een afsluitende slash.
destinationFileName is Nothing of een lege tekenreeks.
Het bronbestand is ongeldig of bestaat niet.
Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.
Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.
Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.
De gebruiker beschikt niet over de benodigde machtigingen om het pad weer te geven.
Voorbeelden
In dit voorbeeld wordt het bestand Test.txt verplaatst naar TestDir1TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
In dit voorbeeld wordt het bestand Test.txt verplaatst van TestDir1 naar TestDir2 en wordt de Test2.txtnaam ervan gewijzigd.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Opmerkingen
Als de doelstructuur niet bestaat, wordt deze gemaakt.
De methode MoveFile behoudt ACL's (Access Control vermeldingen) alleen bij het verplaatsen van het bestand binnen hetzelfde volume. Dit omvat overgenomen ACL's, die directe ACL's worden wanneer ze worden verplaatst (directe ACL's hebben voorrang op overgenomen ACL's). Als een bestand tussen volumes wordt verplaatst, worden ACL's niet gekopieerd.
De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.FileSystem.MoveFile methode.
| Tot | Zien! |
|---|---|
| Een bestand verplaatsen | Hoe to: Een bestand verplaatsen in Visual Basic |
Van toepassing op
MoveFile(String, String, UIOption, UICancelOption)
Hiermee verplaatst u een bestand naar een nieuwe locatie.
public:
static void MoveFile(System::String ^ sourceFileName, System::String ^ destinationFileName, Microsoft::VisualBasic::FileIO::UIOption showUI, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public static void MoveFile(string sourceFileName, string destinationFileName, Microsoft.VisualBasic.FileIO.UIOption showUI, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
static member MoveFile : string * string * Microsoft.VisualBasic.FileIO.UIOption * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Shared Sub MoveFile (sourceFileName As String, destinationFileName As String, showUI As UIOption, onUserCancel As UICancelOption)
Parameters
- sourceFileName
- String
Het pad van het bestand dat moet worden verplaatst.
- destinationFileName
- String
Pad naar de map waarin het bestand moet worden verplaatst.
- showUI
- UIOption
Hiermee geeft u op of de voortgang van de bewerking visueel moet worden bijgehouden. De standaardwaarde is UIOption.OnlyErrorDialogs.
- onUserCancel
- UICancelOption
Hiermee geeft u op of er een uitzondering wordt gegenereerd wanneer de gebruiker de bewerking annuleert. De standaardwaarde is UICancelOption.ThrowException.
Uitzonderingen
Het pad is om een van de volgende redenen niet geldig: het is een tekenreeks met lengte nul; het bevat alleen witruimte; bevat ongeldige tekens; of het is een apparaatpad (begint met \\.\); het eindigt met een afsluitende slash.
destinationFileName is Nothing of een lege tekenreeks.
Het bronbestand is ongeldig of bestaat niet.
Het bestand wordt gebruikt door een ander proces of er treedt een I/O-fout op.
onUserCancel is ingesteld op ThrowException, en de gebruiker heeft de bewerking geannuleerd of er treedt een niet-opgegeven I/O-fout op.
Het pad overschrijdt de door het systeem gedefinieerde maximumlengte.
Een bestands- of mapnaam in het pad bevat een dubbele punt (:) of heeft een ongeldige indeling.
De gebruiker beschikt niet over de benodigde machtigingen om het pad weer te geven.
Voorbeelden
In dit voorbeeld wordt het bestand Test.txt verplaatst naar TestDir1TestDir2.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test.txt")
In dit voorbeeld wordt het bestand Test.txt verplaatst van TestDir1 naar TestDir2 en wordt de Test2.txtnaam ervan gewijzigd.
My.Computer.FileSystem.MoveFile("C:\TestDir1\test.txt", "C:\TestDir2\test2.txt")
Opmerkingen
Als de doelstructuur niet bestaat, wordt deze gemaakt.
De methode MoveFile behoudt ACL's (Access Control vermeldingen) alleen bij het verplaatsen van het bestand binnen hetzelfde volume. Dit omvat overgenomen ACL's, die directe ACL's worden wanneer ze worden verplaatst (directe ACL's hebben voorrang op overgenomen ACL's). Als een bestand tussen volumes wordt verplaatst, worden ACL's niet gekopieerd.
De volgende tabel bevat een voorbeeld van een taak die betrekking heeft op de My.Computer.FileSystem.MoveFile methode.
| Tot | Zien! |
|---|---|
| Een bestand verplaatsen | Hoe to: Een bestand verplaatsen in Visual Basic |