TaskItem Klasse

Definition

Definiert ein einzelnes Element des Projekts bei der Übergabe an eine Aufgabe.Defines a single item of the project as it is passed into a task.

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

Hinweise

TaskItem-Objekte entsprechen nicht exakt den 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()

Initialisiert eine neue Instanz der TaskItem-Klasse.Initializes a new instance of the TaskItem class.

TaskItem(ITaskItem)

Initialisiert eine neue Instanz der TaskItem-Klasse unter Verwendung des angegebenen Quell-ITaskItem.Initializes a new instance of the TaskItem class using the specified source ITaskItem.

TaskItem(String)

Initialisiert eine neue Instanz der TaskItem-Klasse unter Verwendung der angegebenen Elementspezifikations-Zeichenfolge.Initializes a new instance of the TaskItem class using the specified item-specification string.

TaskItem(String, IDictionary)

Initialisiert eine neue Instanz der TaskItem-Klasse unter Verwendung der angegebenen Elementspezifikations-Zeichenfolge und Metadaten.Initializes a new instance of the TaskItem class using the specified item-specification string and its metadata.

Eigenschaften

ItemSpec

Ruft die Elementspezifikation ab oder legt sie fest.Gets or sets the item specification.

MetadataCount

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

MetadataNames

Ruft die Namen sämtlicher Metadaten für das Element ab.Gets the names of all the metadata on the item.

Methoden

CloneCustomMetadata()

Klont die Auflistung von benutzerdefinierten Metadaten für die Elementspezifikation.Clones the collection of custom metadata for the item specification.

CopyMetadataTo(ITaskItem)

Kopiert die Elementspezifikations-Metadaten in das angegebene Zielaufgabenelement.Copies the item-specification metadata to the specified destination task item.

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()

Dient als die Standard-HashfunktionServes as the default hash function.

(Geerbt von Object)
GetLifetimeService()

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)

Ruft die angegebenen Metadaten für das Element ab.Retrieves the specified metadata on the item.

GetType()

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

(Geerbt von Object)
InitializeLifetimeService()

Gewährt bei Überschreibung in einer abgeleiteten Klasse Aufgabenelementen eine unbegrenzte Leasezeit.When overridden in a derived class, gives task items infinite lease time.

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)

Entfernt die angegebenen Metadaten von dem Element.Removes the specified metadata on the item.

SetMetadata(String, String)

Legt den Wert der angegebenen Metadaten für das Element fest oder ändert diesen.Sets or modifies the value of the specified metadata on the item.

ToString()

Ruft die Elementspezifikation ab.Gets the item specification.

Operatoren

Explicit(TaskItem to String)

Ermöglicht eine explizite Typumwandlung von einem TaskItem in einen String und gibt die ItemSpec für dieses Element zurück.Allows an explicit type cast from a TaskItem to a String, and returns the ItemSpec for that 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

ITaskItem2-Implementierung, die den Include-Wert des Elements abruft oder festlegt.ITaskItem2 implementation which gets or sets the item include value. Bei datenträgerbasierten Elementen ist dies der Dateipfad.For disk-based items this would be the file path.

ITaskItem2.GetMetadataValueEscaped(String)

ITaskItem2-Implementierung, die die Abfrage der Werte der Metadaten für das Element ermöglicht.ITaskItem2 implementation which allows the values of metadata on the item to be queried.

ITaskItem2.SetMetadataValueLiteral(String, String)

ITaskItem2-Implementierung, die zulässt, dass benutzerdefinierte Metadaten für das Element festgelegt werden.ITaskItem2 implementation which allows a piece of custom metadata to be set on the item. Geht davon aus, dass der übergebene Wert ohne Escapezeichen ist, und versieht den Wert entsprechend mit Escapezeichen, um seinen Wert beizubehalten.Assumes that the value passed in is unescaped, and escapes the value as necessary in order to maintain its value.

Gilt für: