File.Move Método

Definición

Sobrecargas

Move(String, String)

Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para indicar un nuevo nombre de archivo.Moves a specified file to a new location, providing the option to specify a new file name.

Move(String, String, Boolean)

Mueve un archivo especificado a una ubicación nueva y proporciona las opciones para especificar un nombre de archivo nuevo y sobrescribir el archivo de destino si ya existe.Moves a specified file to a new location, providing the options to specify a new file name and to overwrite the destination file if it already exists.

Move(String, String)

Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para indicar un nuevo nombre de archivo.Moves a specified file to a new location, providing the option to specify a new file name.

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)

Parámetros

sourceFileName
String

Nombre del archivo que se va a mover.The name of the file to move. Puede incluir una ruta de acceso relativa o absoluta.Can include a relative or absolute path.

destFileName
String

Nueva ruta de acceso y nombre del archivo.The new path and name for the file.

Excepciones

El archivo de destino ya existe.The destination file already exists.

O bien-or- No se encontró sourceFileName.sourceFileName was not found.

sourceFileName o destFileName es null.sourceFileName or destFileName is null.

sourceFileName o destFileName es una cadena de longitud cero que solo contiene espacios en blanco o caracteres no válidos como se define en InvalidPathChars.sourceFileName or destFileName is a zero-length string, contains only white space, or contains invalid characters as defined in InvalidPathChars.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada en sourceFileName o destFileName no es válida (por ejemplo, está en una unidad no asignada).The path specified in sourceFileName or destFileName is invalid, (for example, it is on an unmapped drive).

sourceFileName o destFileName está en un formato no válido.sourceFileName or destFileName is in an invalid format.

Ejemplos

En el ejemplo siguiente se mueve un archivo.The following example moves a 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());
        }
    }
}
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

Comentarios

Este método funciona en los volúmenes de disco y no produce una excepción si el origen y el destino son los mismos.This method works across disk volumes, and it does not throw an exception if the source and destination are the same.

Tenga en cuenta que si intenta reemplazar un archivo moviendo un archivo del mismo nombre a ese directorio, se produce una IOException.Note that if you attempt to replace a file by moving a file of the same name into that directory, an IOException is thrown. Para ello, llame a Move(String, String, Boolean) en su lugar.For that purpose, call Move(String, String, Boolean) instead.

Los argumentos sourceFileName y destFileName pueden incluir información de ruta de acceso relativa o absoluta.The sourceFileName and destFileName arguments can include relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, vea GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Si intentas trasladar un archivo por los volúmenes de disco y ese archivo está en uso, el archivo se copia en el destino, pero no se elimina del origen.If you try to move a file across disk volumes and that file is in use, the file is copied to the destination, but it is not deleted from the source.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para leer sourceFileName y escribir en destFileName.for reading from sourceFileName and writing to destFileName. Enumeraciones asociadas: Read, WriteAssociated enumerations: Read, Write

Consulte también:

Move(String, String, Boolean)

Mueve un archivo especificado a una ubicación nueva y proporciona las opciones para especificar un nombre de archivo nuevo y sobrescribir el archivo de destino si ya existe.Moves a specified file to a new location, providing the options to specify a new file name and to overwrite the destination file if it already exists.

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)

Parámetros

sourceFileName
String

Nombre del archivo que se va a mover.The name of the file to move. Puede incluir una ruta de acceso relativa o absoluta.Can include a relative or absolute path.

destFileName
String

Nueva ruta de acceso y nombre del archivo.The new path and name for the file.

overwrite
Boolean

true para sobrescribir el archivo de destino si ya existe; en caso contrario, false.true to overwrite the destination file if it already exists; false otherwise.

Excepciones

No se encontró sourceFileName.sourceFileName was not found.

sourceFileName o destFileName es null.sourceFileName or destFileName is null.

sourceFileName o destFileName es una cadena de longitud cero que solo contiene espacios en blanco o caracteres no válidos como se define en InvalidPathChars.sourceFileName or destFileName is a zero-length string, contains only white space, or contains invalid characters as defined in InvalidPathChars.

El llamador no dispone del permiso requerido.The caller does not have the required permission.

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema.The specified path, file name, or both exceed the system-defined maximum length.

La ruta de acceso especificada en sourceFileName o destFileName no es válida (por ejemplo, está en una unidad no asignada).The path specified in sourceFileName or destFileName is invalid, (for example, it is on an unmapped drive).

sourceFileName o destFileName está en un formato no válido.sourceFileName or destFileName is in an invalid format.

Ejemplos

En el ejemplo siguiente se mueve un archivo.The following example moves a 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());
        }
    }
}
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

Comentarios

Este método funciona en los volúmenes de disco y no produce una excepción si el origen y el destino son los mismos.This method works across disk volumes, and it does not throw an exception if the source and destination are the same.

Los argumentos sourceFileName y destFileName pueden incluir información de ruta de acceso relativa o absoluta.The sourceFileName and destFileName arguments can include relative or absolute path information. La información de la ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual.Relative path information is interpreted as relative to the current working directory. Para obtener el directorio de trabajo actual, vea GetCurrentDirectory.To obtain the current working directory, see GetCurrentDirectory.

Si intentas trasladar un archivo por los volúmenes de disco y ese archivo está en uso, el archivo se copia en el destino, pero no se elimina del origen.If you try to move a file across disk volumes and that file is in use, the file is copied to the destination, but it is not deleted from the source.

Para obtener una lista de tareas de e/s comunes, consulte tareas comunes de e/s.For a list of common I/O tasks, see Common I/O Tasks.

Seguridad

FileIOPermission
para leer sourceFileName y escribir en destFileName.for reading from sourceFileName and writing to destFileName. Enumeraciones asociadas: Read, WriteAssociated enumerations: Read, Write

Consulte también:

Se aplica a