Condividi tramite

File.Move Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.IO
Assembly:
mscorlib.dll, System.IO.FileSystem.dll
Assembly:
System.IO.FileSystem.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Overload

Move(String, String)

Sposta un file specificato in un nuovo percorso, fornendo l'opzione per specificare un nuovo nome file.
Move(String, String, Boolean)

Sposta un file specificato in un nuovo percorso, fornendo le opzioni per specificare un nuovo nome file e sostituire il file di destinazione, se già esistente.

Move(String, String)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Sposta un file specificato in un nuovo percorso, fornendo l'opzione per specificare un nuovo nome file.

public:
 static void Move(System::String ^ sourceFileName, System::String ^ destFileName);
public static void Move (string sourceFileName, string destFileName);
static member Move : string * string -> unit
Public Shared Sub Move (sourceFileName As String, destFileName As String)

Parametri

sourceFileName
String

Nome del file da spostare. Può includere un percorso relativo o assoluto.

destFileName
String

Nuovo percorso e nome per il file.

Eccezioni

IOException

destFileName esiste già.

-o-

Si è verificato un errore di I/O, ad esempio, durante la copia del file tra volumi disco.

FileNotFoundException

sourceFileName non è stato trovato.

ArgumentNullException

sourceFileName o destFileName è null.

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: sourceFileName o destFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

DirectoryNotFoundException

Il percorso specificato in sourceFileName o destFileName non è valido, ad esempio in un'unità non mappata.

NotSupportedException

sourceFileName o destFileName non è valido.

Esempio

Nell'esempio seguente viene spostato un file.

using namespace System;
using namespace System::IO;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   String^ path2 = "c:\\temp2\\MyTest.txt";
   try
   {
      if (  !File::Exists( path ) )
      {
         
         // This statement ensures that the file is created,
         // but the handle is not kept.
         FileStream^ fs = File::Create( path );
         if ( fs )
                  delete (IDisposable^)fs;
      }
      
      // Ensure that the target does not exist.
      if ( File::Exists( path2 ) )
            File::Delete( path2 );
      
      // Move the file.
      File::Move( path, path2 );
      Console::WriteLine( "{0} was moved to {1}.", path, path2 );
      
      // See if the original exists now.
      if ( File::Exists( path ) )
      {
         Console::WriteLine( "The original file still exists, which is unexpected." );
      }
      else
      {
         Console::WriteLine( "The original file no longer exists, which is expected." );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp2\MyTest.txt";
        try
        {
            if (!File.Exists(path))
            {
                // This statement ensures that the file is created,
                // but the handle is not kept.
                using (FileStream fs = File.Create(path)) {}
            }

            // Ensure that the target does not exist.
            if (File.Exists(path2))	
            File.Delete(path2);

            // Move the file.
            File.Move(path, path2);
            Console.WriteLine("{0} was moved to {1}.", path, path2);

            // See if the original exists now.
            if (File.Exists(path))
            {
                Console.WriteLine("The original file still exists, which is unexpected.");
            }
            else
            {
                Console.WriteLine("The original file no longer exists, which is expected.");
            }			
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"
let path2 = @"c:\temp2\MyTest.txt"

if File.Exists path |> not then
    // This statement ensures that the file is created,
    // but the handle is not kept.
    use _ = File.Create path
    ()

// Ensure that the target does not exist.
if File.Exists path2 then
    File.Delete path2

// Move the file.
File.Move(path, path2)
printfn $"{path} was moved to {path2}."

// See if the original exists now.
if File.Exists path then
    printfn "The original file still exists, which is unexpected."
else
    printfn "The original file no longer exists, which is expected."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim path2 As String = "c:\temp2\MyTest.txt"

        Try
            If File.Exists(path) = False Then
                ' This statement ensures that the file is created,
                ' but the handle is not kept.
                Dim fs As FileStream = File.Create(path)
                fs.Close()
            End If

            ' Ensure that the target does not exist.
            If File.Exists(path2) Then
                File.Delete(path2)
            End If

            ' Move the file.
            File.Move(path, path2)
            Console.WriteLine("{0} moved to {1}", path, path2)

            ' See if the original file exists now.
            If File.Exists(path) Then
                Console.WriteLine("The original file still exists, which is unexpected.")
            Else
                Console.WriteLine("The original file no longer exists, which is expected.")
            End If
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Commenti

Questo metodo funziona tra volumi di dischi e non genera un'eccezione se l'origine e la destinazione sono uguali.

Si noti che se si tenta di sostituire un file spostando un file con lo stesso nome in tale directory, viene generata una IOException. Per evitare questo problema:

  • In .NET Core 3.0 e versioni successive è possibile chiamare Move(String, String, Boolean) impostare il parametro overwrite su true, che sostituirà il file, se esistente.

  • In tutte le versioni di .NET è possibile chiamare Copy(String, String, Boolean) per eseguire la copia con sovrascrittura, quindi chiamare Delete per rimuovere il file di origine in eccesso. Questa strategia è consigliabile se il file copiato è di piccole dimensioni e si sta cercando un'operazione di file "atomico". Se si Delete prima il file e il sistema o il programma si arresta in modo anomalo, il file di destinazione non esisterà più.

  • In tutte le versioni di .NET è possibile chiamare Delete(String) prima di chiamare Move, che eliminerà il file solo se esistente.

Gli argomenti sourceFileName e destFileName possono includere informazioni sul percorso relative o assolute. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Lo spostamento del file tra volumi del disco equivale a copiare il file ed eliminarlo dall'origine se la copia ha avuto esito positivo.

Se si tenta di spostare un file tra volumi di disco e tale file è in uso, il file viene copiato nella destinazione, ma non viene eliminato dall'origine.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a

Move(String, String, Boolean)

Origine:
File.cs
Origine:
File.cs
Origine:
File.cs

Sposta un file specificato in un nuovo percorso, fornendo le opzioni per specificare un nuovo nome file e sostituire il file di destinazione, se già esistente.

public:
 static void Move(System::String ^ sourceFileName, System::String ^ destFileName, bool overwrite);
public static void Move (string sourceFileName, string destFileName, bool overwrite);
static member Move : string * string * bool -> unit
Public Shared Sub Move (sourceFileName As String, destFileName As String, overwrite As Boolean)

Parametri

sourceFileName
String

Nome del file da spostare. Può includere un percorso relativo o assoluto.

destFileName
String

Nuovo percorso e nome per il file.

overwrite
Boolean

true sostituire il file di destinazione se esiste già; false in caso contrario.

Eccezioni

IOException

destFileName esiste già e overwrite è false.

-o-

Si è verificato un errore di I/O, ad esempio, durante la copia del file tra volumi disco.

FileNotFoundException

sourceFileName non è stato trovato.

ArgumentNullException

sourceFileName o destFileName è null.

ArgumentException

.NET Framework e versioni di .NET Core precedenti alla 2.1: sourceFileName o destFileName è una stringa di lunghezza zero, contiene solo spazi vuoti o contiene caratteri non validi. È possibile eseguire una query per individuare caratteri non validi usando il metodo GetInvalidPathChars().

UnauthorizedAccessException

Il chiamante non dispone dell'autorizzazione richiesta.

-o-

Il sistema operativo non è riuscito ad acquisire un accesso esclusivo al file di destinazione.

PathTooLongException

Il percorso, il nome file specificato o entrambi superano la lunghezza massima definita dal sistema.

DirectoryNotFoundException

Il percorso specificato in sourceFileName o destFileName non è valido, ad esempio in un'unità non mappata.

NotSupportedException

sourceFileName o destFileName non è valido.

Esempio

Nell'esempio seguente viene spostato un file.

using namespace System;
using namespace System::IO;

int main()
{
   String^ path = "c:\\temp\\MyTest.txt";
   String^ path2 = "c:\\temp2\\MyTest.txt";
   try
   {
      if (  !File::Exists( path ) )
      {
         
         // This statement ensures that the file is created,
         // but the handle is not kept.
         FileStream^ fs = File::Create( path );
         if ( fs )
                  delete (IDisposable^)fs;
      }
      
      // Ensure that the target does not exist.
      if ( File::Exists( path2 ) )
            File::Delete( path2 );
      
      // Move the file.
      File::Move( path, path2 );
      Console::WriteLine( "{0} was moved to {1}.", path, path2 );
      
      // See if the original exists now.
      if ( File::Exists( path ) )
      {
         Console::WriteLine( "The original file still exists, which is unexpected." );
      }
      else
      {
         Console::WriteLine( "The original file no longer exists, which is expected." );
      }
   }
   catch ( Exception^ e ) 
   {
      Console::WriteLine( "The process failed: {0}", e );
   }
}

using System;
using System.IO;

class Test
{
    public static void Main()
    {
        string path = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp2\MyTest.txt";
        try
        {
            if (!File.Exists(path))
            {
                // This statement ensures that the file is created,
                // but the handle is not kept.
                using (FileStream fs = File.Create(path)) {}
            }

            // Ensure that the target does not exist.
            if (File.Exists(path2))	
            File.Delete(path2);

            // Move the file.
            File.Move(path, path2);
            Console.WriteLine("{0} was moved to {1}.", path, path2);

            // See if the original exists now.
            if (File.Exists(path))
            {
                Console.WriteLine("The original file still exists, which is unexpected.");
            }
            else
            {
                Console.WriteLine("The original file no longer exists, which is expected.");
            }			
        }
        catch (Exception e)
        {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    }
}

open System.IO

let path = @"c:\temp\MyTest.txt"
let path2 = @"c:\temp2\MyTest.txt"

if File.Exists path |> not then
    // This statement ensures that the file is created,
    // but the handle is not kept.
    use _ = File.Create path
    ()

// Ensure that the target does not exist.
if File.Exists path2 then
    File.Delete path2

// Move the file.
File.Move(path, path2)
printfn $"{path} was moved to {path2}."

// See if the original exists now.
if File.Exists path then
    printfn "The original file still exists, which is unexpected."
else
    printfn "The original file no longer exists, which is expected."

Imports System.IO
Imports System.Text

Public Class Test
    Public Shared Sub Main()
        Dim path As String = "c:\temp\MyTest.txt"
        Dim path2 As String = "c:\temp2\MyTest.txt"

        Try
            If File.Exists(path) = False Then
                ' This statement ensures that the file is created,
                ' but the handle is not kept.
                Dim fs As FileStream = File.Create(path)
                fs.Close()
            End If

            ' Ensure that the target does not exist.
            If File.Exists(path2) Then
                File.Delete(path2)
            End If

            ' Move the file.
            File.Move(path, path2)
            Console.WriteLine("{0} moved to {1}", path, path2)

            ' See if the original file exists now.
            If File.Exists(path) Then
                Console.WriteLine("The original file still exists, which is unexpected.")
            Else
                Console.WriteLine("The original file no longer exists, which is expected.")
            End If
        Catch e As Exception
            Console.WriteLine("The process failed: {0}", e.ToString())
        End Try
    End Sub
End Class

Commenti

Questo metodo funziona tra volumi di dischi e non genera un'eccezione se l'origine e la destinazione sono uguali.

Gli argomenti sourceFileName e destFileName possono includere informazioni sul percorso relative o assolute. Le informazioni sul percorso relative sono interpretate come relative alla directory di lavoro corrente. Per ottenere la directory di lavoro corrente, vedere GetCurrentDirectory.

Lo spostamento del file tra volumi del disco equivale a copiare il file ed eliminarlo dall'origine se la copia ha avuto esito positivo.

Se si tenta di spostare un file tra volumi di disco e tale file è in uso, il file viene copiato nella destinazione, ma non viene eliminato dall'origine.

Per un elenco delle attività di I/O comuni, vedere Attività di I/O comuni.

Vedi anche

Si applica a