FileSystem.MoveFile Methode

Definitie

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

Zie ook

Van toepassing op