DataTemplate.DataType Eigenschaft

public:
 property System::Object ^ DataType { System::Object ^ get(); void set(System::Object ^ value); };

public object DataType { get; set; }

[System.Windows.Markup.Ambient]
public object DataType { get; set; }

member this.DataType : obj with get, set

[<System.Windows.Markup.Ambient>]
member this.DataType : obj with get, set

Public Property DataType As Object

Eigenschaftswert

Object

Der Standardwert ist null.

Attribute

AmbientAttribute

Hinweise

Diese Eigenschaft ähnelt TargetType der Eigenschaft der Style Klasse sehr. Wenn Sie diese Eigenschaft auf den Datentyp festlegen, ohne eine x:KeyAngabe anzugeben, wird die DataTemplate Automatisch auf Datenobjekte dieses Typs angewendet. Beachten Sie, dass dies x:Key implizit festgelegt ist. Wenn Sie diesen DataTemplate x:Key Wert zuweisen, werden Sie daher die impliziten x:Key und nicht DataTemplate automatisch angewendeten Werte außer Kraft setzen.

Beachten Sie auch, dass sie, wenn Sie eine ContentControl Sammlung von Task Objekten binden, die ContentControl DataTemplate nicht automatisch verwendet werden. Dies liegt daran, dass die Bindung für eine ContentControl weitere Information erforderlich ist, um zu unterscheiden, ob Sie an eine gesamte Auflistung oder die einzelnen Objekte binden möchten. Wenn Sie ContentControl die Auswahl eines ItemsControl Typs nachverfolgen, können Sie die Path Eigenschaft der ContentControl Bindung auf "/" festlegen, um anzugeben, dass Sie an dem aktuellen Element interessiert sind. Ein Beispiel finden Sie unter How to: Bind to a collection and Display Information Based on Selection. Andernfalls müssen Sie die Explizite Angeben, indem Sie die DataTemplate ContentTemplate Eigenschaft festlegen.

Die DataType Eigenschaft ist besonders nützlich, wenn Sie über eine CompositeCollection andere Art von Datenobjekten verfügen.

Wenn diese Eigenschaft auf ein XML-Element abzielt, das sich nicht im Standardnamespace befindet, müssen Sie dem Elementnamen mit dem Namespace oder einem Namespace-Designator vorangehen. Für XML, die über LINQ für XML verfügbar gemacht werden, wird der Namespace in Klammern angezeigt, gefolgt von einer Klammer-Escapesequenz:

<DataTemplate DataType="{}{http://myNamespace}Details">  

Für XML,die über XPath verfügbar gemacht werden, wird der Elementname einem Namespace-Designator vorangestellt, der von einer Instanz von XmlNamespaceMapping:

<DataTemplate DataType="mn:Details">  

Verwendung von XAML-Attributen

<object DataType="typeName"/>  

XAML-Werte

typeName
Wenn die Vorlage für Objektdaten vorgesehen ist, enthält diese Eigenschaft den Typnamen des Datenobjekts (als Zeichenfolge). Um auf den Typnamen der Klasse zu verweisen, verwenden Sie die x:Type Markup Extension. Wenn die Vorlage für XML-Daten vorgesehen ist, enthält diese Eigenschaft den XML-Elementnamen. Weitere Informationen zum Angeben eines nicht standardmäßigen Namespaces für das XML-Element finden Sie in den Dokumentationsnotizen.

Gilt für

Siehe auch

• Einführung in das Beispiel "Daten templating"