Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Método File.Move (String, String)

 

Publicado: octubre de 2016

Mueve un archivo especificado a una nueva ubicación, proporcionando la opción para indicar un nuevo nombre de archivo.

Espacio de nombres:   System.IO
Ensamblado:  mscorlib (en mscorlib.dll)

public static void Move(
	string sourceFileName,
	string destFileName
)

Parámetros

sourceFileName
Type: System.String

Nombre del archivo que se va a mover. Puede incluir una ruta de acceso relativa o absoluta.

destFileName
Type: System.String

Nueva ruta de acceso y nombre del archivo.

Exception Condition
IOException

El archivo de destino ya existe.

-o-

No se encontró sourceFileName.

ArgumentNullException

El valor de sourceFileName o destFileName es null.

ArgumentException

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.

UnauthorizedAccessException

El llamador no dispone del permiso requerido.

PathTooLongException

La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas de acceso deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.

DirectoryNotFoundException

La ruta de acceso especificada en sourceFileName o destFileName no es válida (por ejemplo, está en una unidad no asignada).

NotSupportedException

sourceFileName o destFileName está en un formato no válido.

Este método funciona en volúmenes de disco y no se produce una excepción si el origen y destino son iguales. Tenga en cuenta que si se intenta reemplazar un archivo moviendo un archivo del mismo nombre en el directorio, obtendrá un IOException. No puede utilizar el método Move para sobrescribir un archivo existente.

El sourceFileName y destFileName argumentos pueden incluir información de ruta de acceso relativa o absoluta. Información de ruta de acceso relativa se interpreta en relación con el directorio de trabajo actual. Para obtener el directorio de trabajo actual, consulte GetCurrentDirectory.

Si intenta mover un archivo entre volúmenes de disco y dicho archivo está en uso, el archivo se copia al destino, pero no se elimina del origen.

Para obtener una lista de tareas de E/S comunes, consulte Tareas de E/S comunes.

En el ejemplo siguiente se mueve un archivo.

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());
        }
    }
}

FileIOPermission

for reading from sourceFileName and writing to destFileName. Associated enumerations: F:System.Security.Permissions.FileIOPermissionAccess.Read, F:System.Security.Permissions.FileIOPermissionAccess.Write

Plataforma universal de Windows
Disponible desde 10
.NET Framework
Disponible desde 1.1
Silverlight
Disponible desde 2.0
Windows Phone Silverlight
Disponible desde 7.0
Volver al principio
Mostrar: