Directory.Move(String, String) 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 of map en de inhoud ervan naar een nieuwe locatie.
public:
static void Move(System::String ^ sourceDirName, System::String ^ destDirName);public static void Move(string sourceDirName, string destDirName);static member Move : string * string -> unitPublic Shared Sub Move (sourceDirName As String, destDirName As String)Parameters
- sourceDirName
- String
Het pad van het bestand of de map die u wilt verplaatsen.
- destDirName
- String
Het pad naar de nieuwe locatie voor sourceDirName of de inhoud ervan. Als sourceDirName dit een bestand is, moet dit destDirName ook een bestandsnaam zijn.
Uitzonderingen
Er is een poging gedaan om een map naar een ander volume te verplaatsen.
– of –
destDirName bestaat al. Zie de opmerking in de sectie Opmerkingen.
– of –
De sourceDirName parameters destDirName verwijzen naar hetzelfde bestand of dezelfde map.
– of –
De map of een bestand in het bestand wordt gebruikt door een ander proces.
De beller heeft niet de vereiste machtiging.
.NET Framework en .NET Core-versies ouder dan 2.1: sourceDirName of destDirName is een tekenreeks met lengte nul, bevat alleen witruimte of bevat een of meer ongeldige tekens. U kunt een query uitvoeren op ongeldige tekens met de GetInvalidPathChars() methode.
sourceDirName of destDirName is null.
Het opgegeven pad, de bestandsnaam of beide overschrijden de door het systeem gedefinieerde maximumlengte.
Het opgegeven sourceDirName pad is ongeldig (bijvoorbeeld op een niet-toegewezen station).
Voorbeelden
In het volgende voorbeeld ziet u hoe u een map en alle bijbehorende bestanden naar een nieuwe map verplaatst. De oorspronkelijke map bestaat niet meer nadat deze is verplaatst.
using System;
using System.IO;
partial class Program
{
static void DirectoryMoveExample()
{
string sourceDirectory = @"C:\source";
string destinationDirectory = @"C:\destination";
try
{
Directory.Move(sourceDirectory, destinationDirectory);
}
catch (Exception e)
{
Console.WriteLine(e.Message);
}
}
}
open System.IO
let sourceDirectory = @"C:\source"
let destinationDirectory = @"C:\destination"
try
Directory.Move(sourceDirectory, destinationDirectory)
with e ->
printfn $"{e.Message}"
Imports System.IO
Partial Class Program
Shared Sub DirectoryMoveExample()
Dim sourceDirectory As String = "C:\source"
Dim destinationDirectory As String = "C:\destination"
Try
Directory.Move(sourceDirectory, destinationDirectory)
Catch e As Exception
Console.WriteLine(e.Message)
End Try
End Sub
End Class
Opmerkingen
Met deze methode maakt u een nieuwe map met de naam die is opgegeven door destDirName en verplaatst u de inhoud van sourceDirName, inclusief bestanden en mappen, naar de zojuist gemaakte doelmap. Vervolgens wordt de sourceDirName map verwijderd.
Als u een map probeert te verplaatsen naar een map die al bestaat, wordt er een IOException actie uitgevoerd.
De sourceDirName en destDirName argumenten mogen relatieve of absolute padinformatie opgeven. Relatieve padinformatie wordt geïnterpreteerd als relatief ten opzichte van de huidige werkmap. Als u de huidige werkmap wilt ophalen, raadpleegt GetCurrentDirectoryu .
Volgspaties worden verwijderd uit het einde van de padparameters voordat u de map verplaatst.
Zie Algemene I/O-taken voor een lijst met algemene I/O-taken.
Note
Vanaf .NET Core 3.0 genereert de methode Move een IOException op alle platforms wanneer de destDirName al bestaat. Zie de naam van C++
