File.Move Metoda

Definicja

Przestrzeń nazw:: System.IO

Zestawy:: mscorlib.dll, System.IO.FileSystem.dll

Zestawy:: netstandard.dll, System.Runtime.dll

Zestawy:: netstandard.dll, System.IO.FileSystem.dll

Zestawy:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

Zestaw:: System.IO.FileSystem.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Przeciążenia

Nazwa	Opis
Move(String, String)	Przenosi określony plik do nowej lokalizacji, podając opcję określenia nowej nazwy pliku.
Move(String, String, Boolean)	Przenosi określony plik do nowej lokalizacji, udostępniając opcje określania nowej nazwy pliku i zastępowania pliku docelowego, jeśli już istnieje.

Move(String, String)

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Przenosi określony plik do nowej lokalizacji, podając opcję określenia nowej nazwy pliku.

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)

Parametry

sourceFileName: String

Nazwa pliku do przeniesienia. Może zawierać ścieżkę względną lub bezwzględną.

destFileName: String

Nowa ścieżka i nazwa pliku.

Wyjątki

IOException

destFileName już istnieje.

— lub —

Wystąpił błąd we/wy, np. podczas kopiowania pliku między woluminami dysku.

FileNotFoundException

sourceFileName nie można odnaleźć.

ArgumentNullException

sourceFileName lub destFileName ma wartość null.

ArgumentException

.NET Framework i .NET Core w wersjach starszych niż 2.1: sourceFileName lub destFileName jest ciągiem o zerowej długości, zawiera tylko białe znaki lub zawiera nieprawidłowe znaki. Możesz wykonać zapytanie o nieprawidłowe znaki przy użyciu GetInvalidPathChars() metody .

UnauthorizedAccessException

Obiekt wywołujący nie ma wymaganych uprawnień.

PathTooLongException

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

DirectoryNotFoundException

Ścieżka określona w sourceFileName lub destFileName jest nieprawidłowa (na przykład znajduje się na niemapowanym dysku).

NotSupportedException

sourceFileName lub destFileName jest w nieprawidłowym formacie.

Przykłady

Poniższy przykład przenosi plik.

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

Uwagi

Ta metoda działa na woluminach dysków i nie zgłasza wyjątku, jeśli źródło i lokalizacja docelowa są takie same.

Należy pamiętać, że jeśli próbujesz zamienić plik przez przeniesienie pliku o tej samej nazwie do tego katalogu, IOException zostanie zgłoszony element . Aby uniknąć tego problemu:

W programie .NET Core 3.0 i nowszych wersjach można wywołać Move(String, String, Boolean) ustawienie parametru overwrite na true, który zastępuje plik, jeśli istnieje.
We wszystkich wersjach platformy .NET można wywołać metodę Copy(String, String, Boolean) kopiowania za pomocą zastępowania, a następnie wywołać metodę Delete usunięcia nadmiarowego pliku źródłowego. Ta strategia nie jest niepodzielna, ponieważ awaria systemu lub programu podczas Copy programu może pozostawić częściowo zapisany plik docelowy, ale zapewni (prawdopodobnie niekompletny) plik zawsze istnieje w miejscu docelowym.
We wszystkich wersjach platformy .NET można wywołać metodę Delete(String) przed wywołaniem Movemetody , co spowoduje usunięcie pliku tylko wtedy, gdy istnieje.

Argumenty sourceFileName i destFileName mogą zawierać informacje o ścieżce względnej lub bezwzględnej. Informacje o ścieżce względnej są interpretowane jako względem bieżącego katalogu roboczego. Aby uzyskać bieżący katalog roboczy, zobacz GetCurrentDirectory.

Przeniesienie pliku między woluminami dysku jest równoważne skopiowaniu pliku i usunięciu go ze źródła, jeśli kopiowanie zakończyło się pomyślnie.

Jeśli spróbujesz przenieść plik na woluminy dysku i ten plik jest używany, plik zostanie skopiowany do miejsca docelowego, ale nie zostanie usunięty ze źródła.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

Move(String, String, Boolean)

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Źródło:: File.cs

Przenosi określony plik do nowej lokalizacji, udostępniając opcje określania nowej nazwy pliku i zastępowania pliku docelowego, jeśli już istnieje.

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)

Parametry

sourceFileName: String

Nazwa pliku do przeniesienia. Może zawierać ścieżkę względną lub bezwzględną.

destFileName: String

Nowa ścieżka i nazwa pliku.

overwrite: Boolean

true aby zastąpić plik docelowy, jeśli już istnieje; false Inaczej.

Wyjątki

IOException

destFileName już istnieje i overwrite ma wartość false.

— lub —

Wystąpił błąd we/wy, np. podczas kopiowania pliku między woluminami dysku.

FileNotFoundException

sourceFileName nie można odnaleźć.

ArgumentNullException

sourceFileName lub destFileName ma wartość null.

ArgumentException

UnauthorizedAccessException

Obiekt wywołujący nie ma wymaganych uprawnień.

— lub —

System operacyjny nie może uzyskać wyłącznego dostępu do pliku docelowego.

PathTooLongException

Określona ścieżka, nazwa pliku lub obie metody przekraczają maksymalną długość zdefiniowaną przez system.

DirectoryNotFoundException

Ścieżka określona w sourceFileName lub destFileName jest nieprawidłowa (na przykład znajduje się na niemapowanym dysku).

NotSupportedException

sourceFileName lub destFileName jest w nieprawidłowym formacie.

Przykłady

Poniższy przykład przenosi plik.

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

Uwagi

Ta metoda działa na woluminach dysków i nie zgłasza wyjątku, jeśli źródło i lokalizacja docelowa są takie same.

Przeniesienie pliku między woluminami dysku jest równoważne skopiowaniu pliku i usunięciu go ze źródła, jeśli kopiowanie zakończyło się pomyślnie.

Jeśli spróbujesz przenieść plik na woluminy dysku i ten plik jest używany, plik zostanie skopiowany do miejsca docelowego, ale nie zostanie usunięty ze źródła.

Aby uzyskać listę typowych zadań we/wy, zobacz Typowe zadania we/wy.

Zobacz też

Dotyczy

Opinia

Czy ta strona była pomocna?

Udostępnij za pośrednictwem

File.Move Metoda

Definicja

Przeciążenia

Move(String, String)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Move(String, String, Boolean)

Parametry

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Opinia