TaskItem Klasse

Definition

Diese Klasse stellt ein einzelnes Element des Projekts dar, da es an einen Task übermittelt wird.This class represents a single item of the project, as it is passed into a task. TaskItems-Elemente stimmen nicht exakt mit den item-Elementen in den Projektdateien überein, da die Tasks sonst über Zugriff auf Daten verfügen, die nicht explizit über die Projektdatei an den Task übergeben wurden.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. Dabei handelt es sich nicht um ein Sicherheitsproblem, sondern um ein Problem mit der Klarheit und Transparenz von Projektdateien.It's not a security issue, but more just an issue with project file clarity and transparency.

Hinweis: Diese Klasse muss versiegelt sein.Note: This class has to be sealed. Die Klasse muss versiegelt sein, weil die Engine ihre eigene Kopie dieses Typs instanziiert. Daher würde nicht das gewünschte Verhalten der Engine erzielt werden, wenn jemand die Klasse erweitern würde.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
Vererbung
Vererbung
TaskItem
Implementiert

Hinweise

TaskItem -Objekte entsprechen nicht exakt Element Elementen in Projektdateien.TaskItem objects do not exactly correspond to item elements in project files. Wenn dies der Fall ist, haben Tasks Zugriff auf Daten, die nicht explizit über die Projektdatei an die Aufgabe weitergegeben wurden.If they did, then tasks would have access to data that was not explicitly passed into the task through the project file. Dabei handelt es sich nicht um ein Sicherheitsproblem, sondern um ein Problem mit der Klarheit und Transparenz von Projektdateien.This is not a security issue, but rather an issue with project file clarity and transparency.

Diese Klasse muss versiegelt werden, da die Build-Engine eine eigene Kopie dieses Typs instanziiert.This class has to be sealed since the build engine instantiates its own copy of this type. Wenn die Klasse von einem Drittanbieter erweitert wird, ergibt die Build-Engine ein nicht Gewünschtes Verhalten.If a third party were to extend this class, then the build engine will yield an undesired behavior.

Konstruktoren

TaskItem()

Standardkonstruktor: Dieser wird benötigt, damit der Typ mit COM erstellbar ist.Default constructor -- we need it so this type is COM-createable.

TaskItem(ITaskItem)

Dieser Konstruktor erstellt ein neues TaskItem-Element mit der jeweiligen ITaskItem-Schnittstelle.This constructor creates a new TaskItem, using the given ITaskItem.

TaskItem(String)

Dieser Konstruktor erstellt ein neues Task-Element, wenn die Elementspezifikation angegeben ist.This constructor creates a new task item, given the item spec.

TaskItem(String, IDictionary)

Dieser Konstruktor erstellt ein neues TaskItem-Element mithilfe der angegebenen Elementspezifikation und Metadaten.This constructor creates a new TaskItem, using the given item spec and metadata.

Eigenschaften

ItemSpec

Mit dieser Eigenschaft wird die item-spec-Zeichenfolge abgerufen oder festgelegt.Gets or sets the item-spec.

MetadataCount

Ruft die Anzahl der für das Element festgelegten Metadaten ab.Gets the number of metadata set on the item.

MetadataNames

Mit dieser Eigenschaft werden die Namen aller Metadaten des Elements abgerufen.Gets the names of all the item's metadata.

Methoden

CloneCustomMetadata()

Ruft die Auflistung von benutzerdefinierten Metadaten ab.Get the collection of custom metadata. Dieser Vorgang umfasst keine integrierten Metadaten.This does not include built-in metadata.

CopyMetadataTo(ITaskItem)

Mit dieser Methode werden die Metadaten (aber nicht ItemSpec) in destinationItem kopiert.Copy the metadata (but not the ItemSpec) to destinationItem. Wenn ein bestimmtes Metadatenelement bereits für das Zielelement vorhanden ist, wird dieses nicht überschrieben. Der ursprüngliche Wert wird beibehalten.If a particular metadata already exists on the destination item, then it is not overwritten -- the original value wins.

CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Geerbt von MarshalByRefObject)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Determines whether the specified object is equal to the current object.

(Geerbt von Object)
GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Geerbt von Object)
GetLifetimeService()
Veraltet.

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Geerbt von MarshalByRefObject)
GetMetadata(String)

Diese Methode ruft beliebige Metadaten für das Element ab.Retrieves one of the arbitrary metadata on the item. Wenn keine Metadaten gefunden werden, wird eine leere Zeichenfolge zurückgegeben.If not found, returns empty string.

GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
InitializeLifetimeService()

Diese Methode überschreibt die Klasse, um ihr eine unbegrenzte Leasedauer zu gewähren.Overridden to give this class infinite lease time. Andernfalls liegt eine begrenzte Leasedauer vor (vermutlich 5 Minuten) und Instanzen können ablaufen, wenn die Verarbeitung länger dauert.Otherwise we end up with a limited lease (5 minutes I think) and instances can expire if they take long time processing.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts.Creates a shallow copy of the current MarshalByRefObject object.

(Geerbt von MarshalByRefObject)
RemoveMetadata(String)

Diese Methode entfernt ein arbiträres Metadatenelement des Elements.Removes one of the arbitrary metadata on the item.

SetMetadata(String, String)

Hiermit wird ein beliebiges Metadatenelement für das Element festgelegt.Sets one of the arbitrary metadata on the item.

ToString()

Hiermit wird die item-spec-Zeichenfolge abgerufen.Gets the item-spec.

Operatoren

Explicit(TaskItem to String)

Dieser Operator ermöglicht eine explizite Typumwandlung eines TaskItem-Elements in eine Zeichenfolge, bei der das mit einem Escapezeichen versehene ItemSpec-Element für dieses Element zurückgegeben wird.This allows an explicit typecast from a "TaskItem" to a "string", returning the escaped ItemSpec for this item.

Explizite Schnittstellenimplementierungen

ITaskItem2.CloneCustomMetadataEscaped()

ITaskItem2-Implementierung, die einen Klon der Metadaten für dieses Objekt zurückgibt.ITaskItem2 implementation which returns a clone of the metadata on this object. Zurückgegebene Werte weisen ihre ursprüngliche Form mit Escapezeichen auf.Values returned are in their original escaped form.

ITaskItem2.EvaluatedIncludeEscaped

Hiermit wird dem mit einem Escapezeichen versehenen Include-Parameter oder der „Name“ für das Element abgerufen oder festgelegt.Gets or sets the escaped include, or "name", for the item.

ITaskItem2.GetMetadataValueEscaped(String)

Hiermit wird der mit Escapezeichen versehene Wert der Metadaten mit dem angegebenen Schlüssel zurückgegeben.Returns the escaped value of the metadata with the specified key.

ITaskItem2.SetMetadataValueLiteral(String, String)

Hiermit wird der mit Escapezeichen versehene Wert der Metadaten mit dem angegebenen Namen festgelegt.Sets the escaped value of the metadata with the specified name.

Gilt für: