This documentation is archived and is not being maintained.

Copy Class

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Implements the Copy task. Use the Copy element in your project file to create and execute this task. For usage and parameter information, see Copy Task.

Namespace:  Microsoft.Build.Tasks
Assembly:  Microsoft.Build.Tasks.v4.0 (in Microsoft.Build.Tasks.v4.0.dll)

public class Copy : TaskExtension

The Copy type exposes the following members.

Public methodCopyInfrastructure. Initializes a new instance of the Copy class.

Public propertyBuildEngineGets or sets the instance of the IBuildEngine object used by the task. (Inherited from Task.)
Public propertyBuildEngine2Gets the instance of the IBuildEngine2 object used by the task. (Inherited from Task.)
Public propertyBuildEngine3Gets the instance of the IBuildEngine3 object used by the task. (Inherited from Task.)
Public propertyCopiedFilesInfrastructure. Gets the items that were successfully copied.
Public propertyDestinationFilesInfrastructure. Gets or sets a list of files to copy the source files to.
Public propertyDestinationFolderInfrastructure. Gets or sets the directory to which you want to copy the files.
Protected propertyHelpKeywordPrefixGets or sets the prefix used to compose Help keywords from resource names. (Inherited from Task.)
Public propertyHostObjectGets or sets the host object associated with the task. (Inherited from Task.)
Public propertyLogInfrastructure. Gets an instance of a TaskLoggingHelperExtension containing task logging methods. (Inherited from TaskExtension.)
Public propertyOverwriteReadOnlyFilesInfrastructure. Gets or sets a Boolean value that indicates whether to overwrite files even if they are marked as read only files.
Public propertyRetriesHow many times to attempt to copy, if all previous attempts failed. Defaults to zero. Warning: using retries may mask a synchronization problem in your build process.
Public propertyRetryDelayMillisecondsDelay between any necessary retries. Defaults to RetryDelayMillisecondsDefault()
Public propertySkipUnchangedFilesInfrastructure. Gets or sets a Boolean value that indicates whether the Copy task should skip the copying of files that are unchanged between the source and destination.
Public propertySourceFilesInfrastructure. Gets or sets the files to copy.
Protected propertyTaskResourcesGets or sets the culture-specific resources associated with the task. (Inherited from Task.)
Public propertyUseHardlinksIfPossibleIndicates if hard links should be used.

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Public methodExecuteInfrastructure. Executes the Copy task. (Overrides Task.Execute().)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.