TaskItem TaskItem TaskItem TaskItem Class

Definition

Определяет отдельный элемент проекта при передаче в задачу. Defines a single item of the project as it is passed into a task.

public ref class TaskItem sealed : MarshalByRefObject, Microsoft::Build::Framework::ITaskItem2
public sealed class TaskItem : MarshalByRefObject, Microsoft.Build.Framework.ITaskItem2
type TaskItem = class
    inherit MarshalByRefObject
    interface ITaskItem
    interface ITaskItem2
Public NotInheritable Class TaskItem
Inherits MarshalByRefObject
Implements ITaskItem2
Inheritance
Implements

Remarks

TaskItem объекты не совсем соответствовать элементов в файлах проекта.TaskItem objects do not exactly correspond to item elements in project files. В противном случае задачи имели бы доступ к данным, который не был явно указан в задачу в файле проекта.If they did, then tasks would have access to data that was not explicitly passed into the task through the project file. Это не проблема безопасности, но связана с ясности файл проекта и прозрачности.This is not a security issue, but rather an issue with project file clarity and transparency.

Этот класс должен быть запрещено, поскольку подсистема построения создает собственную копию этого типа.This class has to be sealed since the build engine instantiates its own copy of this type. Если стороннее были расширить этот класс, то обработчик построения даст нежелательные изменения.If a third party were to extend this class, then the build engine will yield an undesired behavior.

Constructors

TaskItem() TaskItem() TaskItem() TaskItem()

Инициализирует новый экземпляр класса TaskItem. Initializes a new instance of the TaskItem class.

TaskItem(ITaskItem) TaskItem(ITaskItem) TaskItem(ITaskItem) TaskItem(ITaskItem)

Инициализирует новый экземпляр класса TaskItem с использованием указанного источника ITaskItem. Initializes a new instance of the TaskItem class using the specified source ITaskItem.

TaskItem(String) TaskItem(String) TaskItem(String) TaskItem(String)

Инициализирует новый экземпляр класса TaskItem с помощью указанной строки спецификации элемента. Initializes a new instance of the TaskItem class using the specified item-specification string.

TaskItem(String, IDictionary) TaskItem(String, IDictionary) TaskItem(String, IDictionary) TaskItem(String, IDictionary)

Инициализирует новый экземпляр класса TaskItem с помощью указанной строки спецификации элемента и метаданных. Initializes a new instance of the TaskItem class using the specified item-specification string and its metadata.

Properties

ItemSpec ItemSpec ItemSpec ItemSpec

Получает или задает спецификацию элемента. Gets or sets the item specification.

MetadataCount MetadataCount MetadataCount MetadataCount

Возвращает количество метаданных, заданных в элементе. Gets the number of metadata set on the item.

MetadataNames MetadataNames MetadataNames MetadataNames

Получает имена всех метаданных элемента. Gets the names of all the metadata on the item.

Methods

CloneCustomMetadata() CloneCustomMetadata() CloneCustomMetadata() CloneCustomMetadata()

Клонирует коллекцию пользовательских метаданных для спецификации элемента. Clones the collection of custom metadata for the item specification.

CopyMetadataTo(ITaskItem) CopyMetadataTo(ITaskItem) CopyMetadataTo(ITaskItem) CopyMetadataTo(ITaskItem)

Копирует метаданные спецификации элемента в указанный элемент целевой задачи. Copies the item-specification metadata to the specified destination task item.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту. Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию. Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetMetadata(String) GetMetadata(String) GetMetadata(String) GetMetadata(String)

Извлекает указанные метаданные в элементе. Retrieves the specified metadata on the item.

GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра. Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

При переопределении в производном классе предоставляет элементам задач неограниченный срок аренды. When overridden in a derived class, gives task items infinite lease time.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Создает неполную копию текущего объекта MarshalByRefObject. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
RemoveMetadata(String) RemoveMetadata(String) RemoveMetadata(String) RemoveMetadata(String)

Удаляет указанные метаданные в элементе. Removes the specified metadata on the item.

SetMetadata(String, String) SetMetadata(String, String) SetMetadata(String, String) SetMetadata(String, String)

Задает или изменяет значение заданных метаданных для элемента. Sets or modifies the value of the specified metadata on the item.

ToString() ToString() ToString() ToString()

Получает спецификацию элемента. Gets the item specification.

Operators

Explicit(TaskItem to String) Explicit(TaskItem to String) Explicit(TaskItem to String) Explicit(TaskItem to String)

Разрешает явное приведение типа TaskItem к String и возвращает ItemSpec для данного элемента. Allows an explicit type cast from a TaskItem to a String, and returns the ItemSpec for that item.

Explicit Interface Implementations

ITaskItem2.CloneCustomMetadataEscaped() ITaskItem2.CloneCustomMetadataEscaped() ITaskItem2.CloneCustomMetadataEscaped() ITaskItem2.CloneCustomMetadataEscaped()

Реализация ITaskItem2, возвращающая клон метаданных для данного объекта. ITaskItem2 implementation which returns a clone of the metadata on this object. Возвращаемые значения имеют исходную экранированную форму. Values returned are in their original escaped form.

ITaskItem2.EvaluatedIncludeEscaped ITaskItem2.EvaluatedIncludeEscaped ITaskItem2.EvaluatedIncludeEscaped ITaskItem2.EvaluatedIncludeEscaped

Реализация ITaskItem2, получающая или задающая значение Include для элемента. ITaskItem2 implementation which gets or sets the item include value. Для элементов на диске это будет путь файла. For disk-based items this would be the file path.

ITaskItem2.GetMetadataValueEscaped(String) ITaskItem2.GetMetadataValueEscaped(String) ITaskItem2.GetMetadataValueEscaped(String) ITaskItem2.GetMetadataValueEscaped(String)

Реализация ITaskItem2, позволяющая запрашивать значения метаданных для элемента. ITaskItem2 implementation which allows the values of metadata on the item to be queried.

ITaskItem2.SetMetadataValueLiteral(String, String) ITaskItem2.SetMetadataValueLiteral(String, String) ITaskItem2.SetMetadataValueLiteral(String, String) ITaskItem2.SetMetadataValueLiteral(String, String)

Реализация ITaskItem2, позволяющая задавать часть пользовательских метаданных для элемента. ITaskItem2 implementation which allows a piece of custom metadata to be set on the item. Предполагает, что передаваемое значение не является экранированным, и при необходимости экранирует значение для его сохранения. Assumes that the value passed in is unescaped, and escapes the value as necessary in order to maintain its value.

Applies to