File.Move Метод
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
| Move(String, String) |
Перемещает заданный файл в новое местоположение и разрешает переименование файла. |
| Move(String, String, Boolean) |
Перемещает указанный файл в новое расположение, предоставляя параметры для указания нового имени файла и замены целевого файла, если он уже существует. |
- Исходный код:
- File.cs
- Исходный код:
- File.cs
- Исходный код:
- File.cs
Перемещает заданный файл в новое местоположение и разрешает переименование файла.
public:
static void Move(System::String ^ sourceFileName, System::String ^ destFileName);public static void Move (string sourceFileName, string destFileName);static member Move : string * string -> unitPublic Shared Sub Move (sourceFileName As String, destFileName As String)Параметры
- sourceFileName
- String
Имя перемещаемого файла. Может содержать относительный или абсолютный путь.
- destFileName
- String
Новый путь к файлу и его имя.
Исключения
destFileName уже существует.
-или-
Произошла ошибка ввода-вывода, например при копировании файла в томах диска.
Не удалось найти sourceFileName.
Параметр sourceFileName или destFileName имеет значение null.
платформа .NET Framework и .NET Core версий старше 2.1: sourceFileName или destFileName представляет собой строку нулевой длины, содержит только пробелы или недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
У вызывающего объекта отсутствует необходимое разрешение.
Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.
В sourceFileName или destFileName указан недопустимый путь (например, он ведет на несопоставленный диск).
Параметр sourceFileName или destFileName имеет недопустимый формат.
Примеры
В следующем примере файл перемещается.
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
Комментарии
Этот метод работает в разных томах диска и не создает исключение, если источник и назначение совпадают.
Обратите внимание, что при попытке заменить файл путем перемещения файла с тем же именем в этот каталог IOException создается исключение . Чтобы избежать этой проблемы, сделайте следующее:
В .NET Core 3.0 и более поздних версиях можно вызвать Move(String, String, Boolean) параметр
overwritetrue, который заменит файл, если он существует.Во всех версиях .NET можно вызвать Copy(String, String, Boolean) метод копирования с перезаписью, а затем вызвать ,
Deleteчтобы удалить лишний исходный файл. Эта стратегия рекомендуется, если копируемый файл имеет небольшой размер и вы ищете операцию с "атомарным" файлом. Если сначала выDeleteиспользуете файл, а система или программа завершатся сбоем, целевой файл больше не будет существовать.Во всех версиях .NET можно вызывать Delete(String) перед вызовом
Move, что приведет к удалению файла, только если он существует.
Аргументы sourceFileName и destFileName могут содержать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные относительно текущего рабочего каталога. Сведения о том, как получить текущий рабочий каталог, см. в разделе GetCurrentDirectory.
Перемещение файла между томами диска эквивалентно копированию файла и его удалению из источника, если копирование прошло успешно.
При попытке переместить файл между томами диска, который используется, файл копируется в место назначения, но не удаляется из источника.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Файловый и потоковый ввод-вывод
- Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Исходный код:
- File.cs
- Исходный код:
- File.cs
- Исходный код:
- File.cs
Перемещает указанный файл в новое расположение, предоставляя параметры для указания нового имени файла и замены целевого файла, если он уже существует.
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 -> unitPublic Shared Sub Move (sourceFileName As String, destFileName As String, overwrite As Boolean)Параметры
- sourceFileName
- String
Имя перемещаемого файла. Может содержать относительный или абсолютный путь.
- destFileName
- String
Новый путь к файлу и его имя.
- overwrite
- Boolean
true , чтобы заменить целевой файл, если он уже существует; false Иначе.
Исключения
Имя, заданное в параметре destFileName, уже существует, а параметр overwrite имеет значение false.
-или-
Произошла ошибка ввода-вывода, например при копировании файла в томах диска.
Не удалось найти sourceFileName.
Параметр sourceFileName или destFileName имеет значение null.
платформа .NET Framework и .NET Core версий старше 2.1: sourceFileName или destFileName представляет собой строку нулевой длины, содержит только пробелы или недопустимые символы. Вы можете запросить недопустимые символы с помощью метода GetInvalidPathChars().
У вызывающего объекта отсутствует необходимое разрешение.
-или-
Операционной системе не удалось получить монопольный доступ к целевому файлу.
Указанный путь, имя файла или оба значения превышают максимальную длину, заданную в системе.
В sourceFileName или destFileName указан недопустимый путь (например, он ведет на несопоставленный диск).
Параметр sourceFileName или destFileName имеет недопустимый формат.
Примеры
В следующем примере файл перемещается.
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
Комментарии
Этот метод работает в разных томах диска и не создает исключение, если источник и назначение совпадают.
Аргументы sourceFileName и destFileName могут содержать относительные или абсолютные сведения о пути. Относительные сведения о пути интерпретируются как относительные относительно текущего рабочего каталога. Сведения о том, как получить текущий рабочий каталог, см. в разделе GetCurrentDirectory.
Перемещение файла между томами диска эквивалентно копированию файла и его удалению из источника, если копирование прошло успешно.
При попытке переместить файл между томами диска, который используется, файл копируется в место назначения, но не удаляется из источника.
Список распространенных задач ввода-вывода см. в разделе Общие задачи ввода-вывода.
См. также раздел
- Файловый и потоковый ввод-вывод
- Чтение текста из файла
- Практическое руководство. Запись текста в файл
Применяется к
.NET 9 и другие версии
| Продукт | Версии |
|---|---|
| .NET | Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
Отзыв о .NET
.NET — это проект с открытым исходным кодом. Выберите ссылку, чтобы оставить отзыв: