Copy 类

定义

复制文件的任务。A task that copies files.

此 API 支持产品基础结构,不能在代码中直接使用。

public ref class Copy : Microsoft::Build::Tasks::TaskExtension, Microsoft::Build::Framework::ICancelableTask
public ref class Copy : Microsoft::Build::Tasks::TaskExtension
public class Copy : Microsoft.Build.Tasks.TaskExtension, Microsoft.Build.Framework.ICancelableTask
public class Copy : Microsoft.Build.Tasks.TaskExtension
type Copy = class
    inherit TaskExtension
    interface ICancelableTask
    interface ITask
type Copy = class
    inherit TaskExtension
Public Class Copy
Inherits TaskExtension
Implements ICancelableTask
Public Class Copy
Inherits TaskExtension
继承
实现

构造函数

Copy()

此 API 支持产品基础结构,不能在代码中直接使用。

构造函数。Constructor.

属性

BuildEngine

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it.

(继承自 Task)
BuildEngine2

生成引擎自动设置此属性,以允许任务回调到其中。The build engine automatically sets this property to allow tasks to call back into it. 这是一个便捷属性,因此从此类继承的任务作者不必将值从 IBuildEngine 强制转换为 IBuildEngine2。This is a convenience property so that task authors inheriting from this class do not have to cast the value from IBuildEngine to IBuildEngine2.

(继承自 Task)
BuildEngine3

检索主机提供的生成引擎接口的 IBuildEngine3 版本。Retrieves the IBuildEngine3 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine4

检索主机提供的生成引擎接口的 IBuildEngine4 版本。Retrieves the IBuildEngine4 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine5

检索主机提供的生成引擎接口的 IBuildEngine5 版本。Retrieves the IBuildEngine5 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine6

检索主机提供的生成引擎接口的 IBuildEngine6 版本。Retrieves the IBuildEngine6 version of the build engine interface provided by the host.

(继承自 Task)
BuildEngine7

获取主机提供的生成引擎接口的版本。Gets the version of the build engine interface provided by the host.

(继承自 Task)
CopiedFiles

此 API 支持产品基础结构,不能在代码中直接使用。

已成功复制的文件的子集。The subset of files that were successfully copied.

DestinationFiles

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要对其复制源文件的文件的列表。Gets or sets a list of files to copy the source files to.

DestinationFolder

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要将文件复制到的目录。Gets or sets the directory to which you want to copy the files.

ErrorIfLinkFails

如果无法创建符号链接或硬链接(而不是回退到复制),则会失败Fail if unable to create a symbolic or hard link instead of falling back to copy

HelpKeywordPrefix

获取或设置前缀,该前缀用于通过字符串资源名称组成 help 关键字。Gets or sets the prefix used to compose help keywords from string resource names. 如果任务没有与消息关联的 help 关键字,则可以忽略此属性或将其设置为 null。If a task does not have help keywords associated with its messages, it can ignore this property or set it to null. 如果前缀设置为空字符串,则字符串资源名称将逐字用作 help 关键字。If the prefix is set to an empty string, then string resource names will be used verbatim as help keywords. 有关如何使用此前缀的示例,请参阅 TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) 方法。For an example of how this prefix is used, see the TaskLoggingHelper.LogErrorWithCodeFromResources(string, object[]) method.

(继承自 Task)
HostObject

如果主机 IDE 具有与此特定任务关联的主机对象,则生成引擎会设置此属性。The build engine sets this property if the host IDE has associated a host object with this particular task.

(继承自 Task)
Log

此 API 支持产品基础结构,不能在代码中直接使用。

获取包含任务日志记录方法的 TaskLoggingHelperExtension 类的实例。Gets an instance of a TaskLoggingHelperExtension class containing task logging methods.

(继承自 TaskExtension)
OverwriteReadOnlyFiles

此 API 支持产品基础结构,不能在代码中直接使用。

是否覆盖目标中设置了只读属性的文件。Whether to overwrite files in the destination that have the read-only attribute set.

Retries

此 API 支持产品基础结构,不能在代码中直接使用。

在前面的所有尝试失败的情况下,尝试复制的次数。How 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.

RetryDelayMilliseconds

此 API 支持产品基础结构,不能在代码中直接使用。

任何必要重试之间的延迟。Delay between any necessary retries. 默认为 Microsoft.Build.Tasks.Copy.RetryDelayMillisecondsDefaultDefaults to Microsoft.Build.Tasks.Copy.RetryDelayMillisecondsDefault

SkipUnchangedFiles

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置一个布尔值,该值指示 Copy 任务是否应跳过复制在源和目标之间保持不变的文件。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.

SourceFiles

此 API 支持产品基础结构,不能在代码中直接使用。

获取或设置要复制的文件。Gets or sets the files to copy.

TaskResources

获取或设置任务的区域性特定资源。Gets or sets the task's culture-specific resources. 派生类应在构造期间注册资源,如果它们有本地化字符串,则可以通过此属性注册。Derived classes should register their resources either during construction, or via this property, if they have localized strings.

(继承自 Task)
UseHardlinksIfPossible

此 API 支持产品基础结构,不能在代码中直接使用。

为复制的文件创建硬链接,而不是复制文件(如果可行)Create Hard Links for the copied files rather than copy the files if possible to do so

UseSymboliclinksIfPossible

为复制的文件创建符号链接,而不是复制文件(如果可行)Create Symbolic Links for the copied files rather than copy the files if possible to do so

方法

Cancel()

此 API 支持产品基础结构,不能在代码中直接使用。

尽快停止并返回(在一个未定义状态)。Stop and return (in an undefined state) as soon as possible.

Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

(继承自 Object)
Execute()

此 API 支持产品基础结构,不能在代码中直接使用。

标准入口点。Standard entry point.

GetHashCode()

作为默认哈希函数。Serves as the default hash function.

(继承自 Object)
GetType()

获取当前实例的 TypeGets the Type of the current instance.

(继承自 Object)
MemberwiseClone()

创建当前 Object 的浅表副本。Creates a shallow copy of the current Object.

(继承自 Object)
ToString()

返回表示当前对象的字符串。Returns a string that represents the current object.

(继承自 Object)

适用于