FileInfo.CopyTo 方法

定义

命名空间:: System.IO

程序集:: mscorlib.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.Runtime.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll

程序集:: netstandard.dll, System.IO.FileSystem.dll, System.Runtime.dll

程序集:: System.IO.FileSystem.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

将现有文件复制到新文件。

重载

名称	说明
CopyTo(String)	将现有文件复制到新文件，禁止覆盖现有文件。
CopyTo(String, Boolean)	将现有文件复制到新文件，从而允许覆盖现有文件。

CopyTo(String)

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

将现有文件复制到新文件，禁止覆盖现有文件。

public:
 System::IO::FileInfo ^ CopyTo(System::String ^ destFileName);

public System.IO.FileInfo CopyTo(string destFileName);

member this.CopyTo : string -> System.IO.FileInfo

Public Function CopyTo (destFileName As String) As FileInfo

参数

destFileName: String

要复制到的新文件的名称。

FileInfo

具有完全限定路径的新文件。

例外

ArgumentException

.NET Framework 和低于 2.1 的核心版本：.NET destFileName为空、仅包含空格或包含无效字符。

IOException

发生错误或目标文件已存在。

SecurityException

调用方没有所需的权限。

ArgumentNullException

destFileName 是 null。

UnauthorizedAccessException

将传入目录路径，或将文件移动到其他驱动器。

DirectoryNotFoundException

指定的 destFileName 目录不存在。

PathTooLongException

指定的路径、文件名或两者都超过了系统定义的最大长度。

NotSupportedException

destFileName 包含一个冒号（:)字符串中，但不指定卷。

示例

以下示例演示了该方法的两个 CopyTo 重载。

using System;
using System.IO;

class Test
{

    public static void Main()
    {
        string path = @"c:\SoureFile.txt";
        string path2 = @"c:\NewFile.txt";
        FileInfo fi1 = new FileInfo(path);
        FileInfo fi2 = new FileInfo(path2);

        try
        {
            // Create the source file.
            using (FileStream fs = fi1.Create()) { }

            //Ensure that the target file does not exist.
            if (File.Exists(path2))
            {
                fi2.Delete();
            }

            //Copy the file.f
            fi1.CopyTo(path2);
            Console.WriteLine("{0} was copied to {1}.", path, path2);
        }
        catch (IOException ioex)
        {
            Console.WriteLine(ioex.Message);
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        'Specify the directories you want to manipulate.
        Dim path As String = "c:\SourceFile.txt"
        Dim path2 As String = "c:\NewFile.txt"
        Dim fi As FileInfo = New FileInfo(path)
        Dim fi2 As FileInfo = New FileInfo(path2)

        Try
            Using fs As FileStream = fi.Create()
            End Using

            'Ensure that the target does not exist.
            If File.Exists(path2) Then
                fi2.Delete()
            End If
            
            'Copy the file.
            fi.CopyTo(path2)
            Console.WriteLine("{0} was copied to {1}.", path, path2)

        Catch ioex As IOException
            Console.WriteLine(ioex.Message)
        End Try
    End Sub
End Class

以下示例演示如何将一个文件复制到另一个文件，如果目标文件已存在，则会引发异常。

using System;
using System.IO;

public class CopyToTest
{
    public static void Main()
    {
        try
        {
            // Create a reference to a file, which might or might not exist.
            // If it does not exist, it is not yet created.
            FileInfo fi = new FileInfo("temp.txt");
            // Create a writer, ready to add entries to the file.
            StreamWriter sw = fi.AppendText();
            sw.WriteLine("Add as many lines as you like...");
            sw.WriteLine("Add another line to the output...");
            sw.Flush();
            sw.Close();
            // Get the information out of the file and display it.
            StreamReader sr = new StreamReader(fi.OpenRead());
            Console.WriteLine("This is the information in the first file:");
            while (sr.Peek() != -1)
                Console.WriteLine(sr.ReadLine());
            // Copy this file to another file. The file will not be overwritten if it already exists.
            FileInfo newfi = fi.CopyTo("newTemp.txt");
            // Get the information out of the new file and display it.
            sr = new StreamReader(newfi.OpenRead());
            Console.WriteLine("{0}This is the information in the second file:", Environment.NewLine);
            while (sr.Peek() != -1)
                Console.WriteLine(sr.ReadLine());
        }
        catch(Exception e)
        {
            Console.WriteLine(e.Message);
        }
    }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//This is the information in the first file:
//Add as many lines as you like...
//Add another line to the output...

//This is the information in the second file:
//Add as many lines as you like...
//Add another line to the output...

Imports System.IO

Public Class CopyToTest
    Public Shared Sub Main()
        Try
            ' Create a reference to a file, which might or might not exist.
            ' If it does not exist, it is not yet created.
            Dim fi As New FileInfo("temp.txt")
            ' Create a writer, ready to add entries to the file.
            Dim sw As StreamWriter = fi.AppendText()
            sw.WriteLine("Add as many lines as you like...")
            sw.WriteLine("Add another line to the output...")
            sw.Flush()
            sw.Close()
            ' Get the information out of the file and display it.
            Dim sr As New StreamReader(fi.OpenRead())
            Console.WriteLine("This is the information in the first file:")
            While sr.Peek() <> -1
                Console.WriteLine(sr.ReadLine())
            End While
            ' Copy this file to another file.
            Dim newfi As FileInfo = fi.CopyTo("newTemp.txt")
            ' Get the information out of the new file and display it.
            sr = New StreamReader(newfi.OpenRead())
            Console.WriteLine("{0}This is the information in the second file:", Environment.NewLine)
            While sr.Peek() <> -1
                Console.WriteLine(sr.ReadLine())
            End While
        Catch e As Exception
            Console.WriteLine(e.Message)
        End Try
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'This is the information in the first file:
'Add as many lines as you like...
'Add another line to the output...
'
'This is the information in the second file:
'Add as many lines as you like...
'Add another line to the output...

注解

CopyTo(String, Boolean)使用此方法允许覆盖现有文件。

Caution

尽可能避免在此方法中使用短文件名（如 XXXXXX~1.XXX）。如果两个文件具有等效的短文件名，则此方法可能会失败并引发异常和/或导致不良行为

另请参阅

适用于

CopyTo(String, Boolean)

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

Source:: FileInfo.cs

将现有文件复制到新文件，从而允许覆盖现有文件。

public:
 System::IO::FileInfo ^ CopyTo(System::String ^ destFileName, bool overwrite);

public System.IO.FileInfo CopyTo(string destFileName, bool overwrite);

member this.CopyTo : string * bool -> System.IO.FileInfo

Public Function CopyTo (destFileName As String, overwrite As Boolean) As FileInfo

参数

destFileName: String

要复制到的新文件的名称。

overwrite: Boolean

true 允许覆盖现有文件;否则，为 false.

FileInfo

新文件，或覆盖现有文件（如果 overwrite 为 true）。如果文件存在且为 >，则会引发一个。

例外

ArgumentException

.NET Framework 和低于 2.1 的核心版本：.NET destFileName为空、仅包含空格或包含无效字符。

IOException

发生错误，或者目标文件已存在且 overwrite 为 false。

SecurityException

调用方没有所需的权限。

ArgumentNullException

destFileName 是 null。

DirectoryNotFoundException

指定的 destFileName 目录不存在。

UnauthorizedAccessException

将传入目录路径，或将文件移动到其他驱动器。

PathTooLongException

指定的路径、文件名或两者都超过了系统定义的最大长度。

NotSupportedException

destFileName 包含字符串中间的冒号（:)）。

示例

以下示例演示了该方法的两个 CopyTo 重载。

using System;
using System.IO;

class Test
{

    public static void Main()
    {
        string path = @"c:\SoureFile.txt";
        string path2 = @"c:\NewFile.txt";
        FileInfo fi1 = new FileInfo(path);
        FileInfo fi2 = new FileInfo(path2);

        try
        {
            // Create the source file.
            using (FileStream fs = fi1.Create()) { }

            //Ensure that the target file does not exist.
            if (File.Exists(path2))
            {
                fi2.Delete();
            }

            //Copy the file.f
            fi1.CopyTo(path2);
            Console.WriteLine("{0} was copied to {1}.", path, path2);
        }
        catch (IOException ioex)
        {
            Console.WriteLine(ioex.Message);
        }
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        'Specify the directories you want to manipulate.
        Dim path As String = "c:\SourceFile.txt"
        Dim path2 As String = "c:\NewFile.txt"
        Dim fi As FileInfo = New FileInfo(path)
        Dim fi2 As FileInfo = New FileInfo(path2)

        Try
            Using fs As FileStream = fi.Create()
            End Using

            'Ensure that the target does not exist.
            If File.Exists(path2) Then
                fi2.Delete()
            End If
            
            'Copy the file.
            fi.CopyTo(path2)
            Console.WriteLine("{0} was copied to {1}.", path, path2)

        Catch ioex As IOException
            Console.WriteLine(ioex.Message)
        End Try
    End Sub
End Class

以下示例演示如何将一个文件复制到另一个文件，指定是否覆盖已存在的文件。

using System;
using System.IO;

public class CopyToTest
{
    public static void Main()
    {
        // Create a reference to a file, which might or might not exist.
        // If it does not exist, it is not yet created.
        FileInfo fi = new FileInfo("temp.txt");
        // Create a writer, ready to add entries to the file.
        StreamWriter sw = fi.AppendText();
        sw.WriteLine("Add as many lines as you like...");
        sw.WriteLine("Add another line to the output...");
        sw.Flush();
        sw.Close();
        // Get the information out of the file and display it.
        StreamReader sr = new StreamReader( fi.OpenRead() );
        Console.WriteLine("This is the information in the first file:");
        while (sr.Peek() != -1)
            Console.WriteLine( sr.ReadLine() );
        // Copy this file to another file. The true parameter specifies
        // that the file will be overwritten if it already exists.
        FileInfo newfi = fi.CopyTo("newTemp.txt", true);
        // Get the information out of the new file and display it.
        sr = new StreamReader( newfi.OpenRead() );
        Console.WriteLine("{0}This is the information in the second file:", Environment.NewLine);
        while (sr.Peek() != -1)
            Console.WriteLine( sr.ReadLine() );
    }
}
//This code produces output similar to the following;
//results may vary based on the computer/file structure/etc.:
//
//This is the information in the first file:
//Add as many lines as you like...
//Add another line to the output...
//Add as many lines as you like...
//Add another line to the output...

//This is the information in the second file:
//Add as many lines as you like...
//Add another line to the output...
//Add as many lines as you like...
//Add another line to the output...

Imports System.IO

Public Class CopyToTest
    Public Shared Sub Main()
        ' Create a reference to a file, which might or might not exist.
        ' If it does not exist, it is not yet created.
        Dim fi As New FileInfo("temp.txt")
        ' Create a writer, ready to add entries to the file.
        Dim sw As StreamWriter = fi.AppendText()
        sw.WriteLine("Add as many lines as you like...")
        sw.WriteLine("Add another line to the output...")
        sw.Flush()
        sw.Close()
        ' Get the information out of the file and display it.
        Dim sr As New StreamReader(fi.OpenRead())
        Console.WriteLine("This is the information in the first file:")
        While sr.Peek() <> -1
            Console.WriteLine(sr.ReadLine())
        End While
        ' Copy this file to another file. The true parameter specifies 
        ' that the file will be overwritten if it already exists.
        Dim newfi As FileInfo = fi.CopyTo("newTemp.txt", True)
        ' Get the information out of the new file and display it.
        sr = New StreamReader(newfi.OpenRead())
        Console.WriteLine("{0}This is the information in the second file:", Environment.NewLine)
        While sr.Peek() <> -1
            Console.WriteLine(sr.ReadLine())
        End While
    End Sub
End Class
'This code produces output similar to the following; 
'results may vary based on the computer/file structure/etc.:
'
'This is the information in the first file:
'Add as many lines as you like...
'Add another line to the output...
'
'This is the information in the second file:
'Add as many lines as you like...
'Add another line to the output...
'

注解

使用此方法允许或阻止覆盖现有文件。使用此方法 CopyTo(String) 可阻止默认覆盖现有文件。

Caution

尽可能避免在此方法中使用短文件名（如 XXXXXX~1.XXX）。如果两个文件具有等效的短文件名，则此方法可能会失败并引发异常和/或导致不良行为

另请参阅

适用于

反馈

此页面是否有帮助？

FileInfo.CopyTo 方法

定义

重载

CopyTo(String)

参数

返回

例外

示例

注解

另请参阅

适用于

CopyTo(String, Boolean)

参数

返回

例外

示例

注解

另请参阅

适用于