Personas que lo han encontrado útil: 0 de 3 - Valorar este tema

File.Move (Método)

.NET Framework 2.0

Otras versiones

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)

Sintaxis

C++

Copiar

public static void Move (
	string sourceFileName,
	string destFileName
)

Copiar

public static void Move (
	String sourceFileName, 
	String destFileName
)

JScript

Copiar

public static function Move (
	sourceFileName : String, 
	destFileName : String
)

Parámetros

sourceFileName: Nombre del archivo que se va a mover.

destFileName: Nueva ruta de acceso al archivo.

Excepciones

Tipo de excepción	Condición
IOException	El archivo de destino ya existe.
ArgumentNullException	El valor de sourceFileName o destFileName es referencia de objeto null (Nothing en Visual Basic).
ArgumentException	sourceFileName o destFileName es una cadena de longitud cero, contiene sólo espacios en blanco o contiene caracteres no válidos, tal y como se definen en InvalidPathChars.
UnauthorizedAccessException	El llamador no dispone del permiso requerido.
FileNotFoundException	No se encontró sourceFileName.
PathTooLongException	La ruta de acceso especificada, el nombre de archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, las rutas de acceso deben ser inferiores a 248 caracteres y los nombres de archivo deben ser inferiores a 260 caracteres.
DirectoryNotFoundException	La ruta de acceso especificada en sourceFileName o destFileName no es válida (por ejemplo, se encuentra en una unidad de red no asignada).
NotSupportedException	sourceFileName o destFileName tiene un formato no válido.

Comentarios

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

Los argumentos sourceFileName y destFileName pueden especificar información de ruta de acceso relativa o absoluta. La 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, vea GetCurrentDirectory.

Para obtener un ejemplo de cómo utilizar este método, vea la sección Ejemplo. En la siguiente tabla se muestran ejemplos de otras tareas de E/S típicas o relacionadas.

Para realizar esta operación...	Vea el ejemplo de este tema...
Escribir en un archivo de texto	Cómo: Escribir texto en un archivo
Leer de un archivo de texto	Cómo: Leer texto de un archivo
Anexar texto a un archivo	Cómo: Abrir y anexar a un archivo de registro File.AppendText FileInfo.AppendText
Copiar un archivo.	File.Copy FileInfo.CopyTo
Cambiar de nombre o mover un directorio	Directory.Move DirectoryInfo.MoveTo

Ejemplo

En el siguiente ejemplo se mueve un archivo.

C++

Copiar

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

Copiar

import System.*;
import System.IO.*;

class Test
{
    public static void main(String[] args)
    {
        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);

                try {
                }
                finally {
                    fs.Dispose();
                }                
            }

            // 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 (System.Exception e) {
            Console.WriteLine("The process failed: {0}", e.ToString());
        }
    } //main
} //Test

Seguridad de .NET Framework

FileIOPermission para leer sourceFileName y escribir en destFileName. Enumeraciones asociadas: FileIOPermissionAccess.Read, FileIOPermissionAccess.Write.

Plataformas

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

Información de versión