TaskItem Clase

Definición

Esta clase representa un único elemento del proyecto, cuando se pasa a una tarea.This class represents a single item of the project, as it is passed into a task. Los elementos Task no se corresponden exactamente con los elementos Item de los archivos del proyecto, ya que las tareas tendrán acceso a datos que no se han pasado de forma explícita a la tarea a través del archivo del proyecto.TaskItems do not exactly correspond to item elements in project files, because then tasks would have access to data that wasn't explicitly passed into the task via the project file. No se trata de un problema de seguridad, sino de un problema con la claridad y transparencia del archivo del proyecto.It's not a security issue, but more just an issue with project file clarity and transparency.

Nota: Esta clase se debe sellar.Note: This class has to be sealed. Se debe sellar porque el motor crea una instancia de su propia copia de este tipo y, por tanto, si alguien la quisiera extender, no obtendría el comportamiento deseado del motor.It has to be sealed because the engine instantiates it's own copy of this type and thus if someone were to extend it, they would not get the desired behavior from the engine.

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

Comentarios

TaskItem los objetos no corresponden exactamente a los elementos de los archivos de proyecto.TaskItem objects do not exactly correspond to item elements in project files. En caso de que lo hicieran, las tareas tendrían acceso a los datos que no se pasaron explícitamente a la tarea a través del archivo de proyecto.If they did, then tasks would have access to data that was not explicitly passed into the task through the project file. Esto no es un problema de seguridad, sino un problema con la transparencia y la claridad del archivo de proyecto.This is not a security issue, but rather an issue with project file clarity and transparency.

Esta clase debe estar sellada, ya que el motor de compilación crea una instancia de su propia copia de este tipo.This class has to be sealed since the build engine instantiates its own copy of this type. Si un tercero fuera a ampliar esta clase, el motor de compilación producirá un comportamiento no deseado.If a third party were to extend this class, then the build engine will yield an undesired behavior.

Constructores

TaskItem()

Constructor predeterminado: es necesario para que este tipo se pueda crear a través de COM.Default constructor -- we need it so this type is COM-createable.

TaskItem(ITaskItem)

Este constructor crea un objeto TaskItem mediante la interfaz ITaskItem proporcionada.This constructor creates a new TaskItem, using the given ITaskItem.

TaskItem(String)

Este constructor crea un elemento de tarea, dada la especificación del elemento.This constructor creates a new task item, given the item spec.

TaskItem(String, IDictionary)

Este constructor crea un objeto TaskItem mediante la especificación y los metadatos del elemento especificados.This constructor creates a new TaskItem, using the given item spec and metadata.

Propiedades

ItemSpec

Obtiene o establece la especificación del elemento.Gets or sets the item-spec.

MetadataCount

Obtiene el número de metadatos establecidos en el elemento.Gets the number of metadata set on the item.

MetadataNames

Obtiene los nombres de todos los metadatos del elemento.Gets the names of all the item's metadata.

Métodos

CloneCustomMetadata()

Obtiene la colección de metadatos personalizados.Get the collection of custom metadata. No se incluyen los metadatos integrados.This does not include built-in metadata.

CopyMetadataTo(ITaskItem)

Copia los metadatos (pero no el elemento ItemSpec) en destinationItem.Copy the metadata (but not the ItemSpec) to destinationItem. Si ya existen metadatos concretos en el elemento de destino, no se sobrescriben: gana el valor original.If a particular metadata already exists on the destination item, then it is not overwritten -- the original value wins.

CreateObjRef(Type)

Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Heredado de MarshalByRefObject)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetLifetimeService()
Obsoleto.

Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Heredado de MarshalByRefObject)
GetMetadata(String)

Recupera uno de los metadatos arbitrarios del elemento.Retrieves one of the arbitrary metadata on the item. Si no se encuentra, devuelve una cadena vacía.If not found, returns empty string.

GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
InitializeLifetimeService()

Se invalida para asignar a esta clase tiempo de concesión infinito.Overridden to give this class infinite lease time. En caso contrario, se obtiene concesión limitada (supuestamente cinco minutos) y las instancias pueden expirar si tardan mucho tiempo en procesarse.Otherwise we end up with a limited lease (5 minutes I think) and instances can expire if they take long time processing.

MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
MemberwiseClone(Boolean)

Crea una copia superficial del objeto MarshalByRefObject actual.Creates a shallow copy of the current MarshalByRefObject object.

(Heredado de MarshalByRefObject)
RemoveMetadata(String)

Quita uno de los metadatos arbitrarios del elemento.Removes one of the arbitrary metadata on the item.

SetMetadata(String, String)

Establece uno de los metadatos arbitrarios en el elemento.Sets one of the arbitrary metadata on the item.

ToString()

Obtiene la especificación del elemento.Gets the item-spec.

Operadores

Explicit(TaskItem to String)

Esto permite una conversión explícita de un elemento "TaskItem" en una "cadena", y se devuelve el objeto ItemSpec con escape para este elemento.This allows an explicit typecast from a "TaskItem" to a "string", returning the escaped ItemSpec for this item.

Implementaciones de interfaz explícitas

ITaskItem2.CloneCustomMetadataEscaped()

Implementación de ITaskItem2 que devuelve un clon de los metadatos de este objeto.ITaskItem2 implementation which returns a clone of the metadata on this object. Los valores devueltos tienen su forma de escape original.Values returned are in their original escaped form.

ITaskItem2.EvaluatedIncludeEscaped

Obtiene o establece el archivo de inclusión con escape, o "name", para el elemento.Gets or sets the escaped include, or "name", for the item.

ITaskItem2.GetMetadataValueEscaped(String)

Devuelve el valor con escape de los metadatos con la clave especificada.Returns the escaped value of the metadata with the specified key.

ITaskItem2.SetMetadataValueLiteral(String, String)

Establece el valor con escape de los metadatos con el nombre especificado.Sets the escaped value of the metadata with the specified name.

Se aplica a