Home  |  Delphi .net Home  |  System.IO.File  |  Copy Method
Copy  
Method  
Copies the specified file to a new location, optionally with a new name
File Class
System.IO NameSpace
CF1.  Procedure Copy ( SourceFileName:StringSourceFileName : String; TargetFileName : String; ) ;
CF2.  Procedure Copy ( SourceFileName:StringSourceFileName : String; TargetFileName : String; OverWrite : Boolean; ) ; Static;
CF : Methods with this mark are Compact Framework Compatible
Description
The SourceFileName file is copied to the new TargetFileName.
 
If the file already exists, an exception is thrown unless the optional Overwrite is set to true.
Microsoft MSDN Links
System.IO
System.IO.File
 
 
A simple example
// Full Unit code.
// -------------------------------------------------------------
// Create a new WinForm application, double click the form to
// create an OnLoad event, and then replace the WinForm unit
// with this text.
 
unit WinForm;
 
interface
 
uses
  System.Drawing, System.Collections, System.ComponentModel,
System.Windows.Forms, System.Data;
 
type
  TWinForm = class(System.Windows.Forms.Form)
  \{REGION 'Designer Managed Code'\} // Note that REGION and ENREGION should be prefixed by a dollar sign
  strict private
    ///
    /// Required designer variable.
    ///

    Components: System.ComponentModel.Container;
    ///
    /// Required method for Designer support - do not modify
    /// the contents of this method with the code editor.
    ///

    procedure InitializeComponent;
    procedure TWinForm_Load(sender: System.Object; e: System.EventArgs);
  {ENDREGION}
  strict protected
    ///
    /// Clean up any resources being used.
    ///

    procedure Dispose(Disposing: Boolean); override;
  private
    { Private Declarations }
  public
    constructor Create;
  end;
 
  [assembly: RuntimeRequiredAttribute(TypeOf(TWinForm))]
 
implementation
 
\{REGION 'Windows Form Designer generated code'\}
///
/// Required method for Designer support -- do not modify
/// the contents of this method with the code editor.
///

 
 
procedure TWinForm.InitializeComponent;
begin
  //
  // TWinForm
  //
  Self.AutoScaleBaseSize := System.Drawing.Size.Create(5, 13);
  Self.ClientSize := System.Drawing.Size.Create(292, 266);
  Self.Name := 'TWinForm';
  Self.Text := 'WinForm';
  Include(Self.Load, Self.TWinForm_Load);
end;
{ENDREGION}
 
procedure TWinForm.Dispose(Disposing: Boolean);
begin
  if Disposing then
  begin
    if Components <> nil then
      Components.Dispose();
  end;
  inherited Dispose(Disposing);
end;
 
constructor TWinForm.Create;
begin
  inherited Create;
  //
  // Required for Windows Form Designer support
  //
  InitializeComponent;
  //
  // TODO: Add any constructor code after InitializeComponent call
  //
end;
 
procedure TWinForm.TWinForm_Load(sender: System.Object; e: System.EventArgs);
program Project1;
{$APPTYPE CONSOLE}

uses
  System.IO;

var
  Path   : String;
  Files  : Array of String;
  Stream : FileStream;
  i      : Integer;

begin
  // Create the DelphiBasics.txt file
  Path := 'C:\DelphiBasics.txt';
  Stream := System.IO.File.&Create(Path);

  // Close the file
  Stream.Close;

  // List files in the current folder
  Files := System.IO.Directory.GetFiles(Directory.GetCurrentDirectory);

  for i := 0 to Length(Files)-1 do
    Console.WriteLine(System.IO.Path.GetFileName(Files[i]));

  // Copy the file to a new file
  Console.WriteLine;
  Console.WriteLine('Copy DelphiBasics.txt to CopyOfDelphiBasics.txt :');
  Console.WriteLine;

  System.IO.File.Copy(Path, 'CopyOfDelphiBasics.txt');

  // List files in the current folder
  Files := System.IO.Directory.GetFiles(Directory.GetCurrentDirectory);

  for i := 0 to Length(Files)-1 do
    Console.WriteLine(System.IO.Path.GetFileName(Files[i]));

  // Clean up - delete the new file
  System.IO.File.Delete('CopyOfDelphiBasics.txt');

  Console.Readline;
end.
 
end.
Hide full unit code
  DelphiBasics.txt
  Project1.exe
  Project1.pdb
  Project1.rsp
  
  Copy DelphiBasics.txt to CopyOfDelphiBasics.txt
  
  CopyOfDelphiBasics.txt
  DelphiBasics.txt
  Project1.exe
  Project1.pdb
  Project1.rsp
 
 
Delphi Programming © Neil Moffatt All rights reserved.  |  Contact the author