DataTemplate.DataType DataTemplate.DataType DataTemplate.DataType DataTemplate.DataType Property

Definición

Obtiene o establece el tipo para el que está pensado este elemento DataTemplate.Gets or sets the type for which this DataTemplate is intended.

public:
 property System::Object ^ DataType { System::Object ^ get(); void set(System::Object ^ value); };
[System.Windows.Markup.Ambient]
public object DataType { get; set; }
member this.DataType : obj with get, set
Public Property DataType As Object

Valor de propiedad

El valor predeterminado es null.The default value is null.

Comentarios

Esta propiedad es muy similar a la TargetType propiedad de la Style clase.This property is very similar to the TargetType property of the Style class. Al establecer esta propiedad para el tipo de datos sin especificar un x:Key, el DataTemplate se aplica automáticamente a los objetos de datos de ese tipo.When you set this property to the data type without specifying an x:Key, the DataTemplate gets applied automatically to data objects of that type. Tenga en cuenta que al hacer que el x:Key se establece implícitamente.Note that when you do that the x:Key is set implicitly. Por lo tanto, si se asigna esta DataTemplate una x:Key valor, se va a reemplazar implícito x:Key y DataTemplate no se aplicaría automáticamente.Therefore, if you assign this DataTemplate an x:Key value, you are overriding the implicit x:Key and the DataTemplate would not be applied automatically.

Tenga en cuenta también que si va a enlazar un ContentControl a una colección de Task objetos, el ContentControl no usa el DataTemplate automáticamente.Also note that if you are binding a ContentControl to a collection of Task objects, the ContentControl does not use the DataTemplate automatically. Esto es porque el enlace en un ContentControl necesita más información para distinguir si desea enlazar a una colección completa o los objetos individuales.This is because the binding on a ContentControl needs more information to distinguish whether you want to bind to an entire collection or the individual objects. Si su ContentControl seguimiento de la selección de un ItemsControl tipo, puede establecer el Path propiedad de la ContentControl enlazar a "/" para indicar que estás interesado en el elemento actual.If your ContentControl is tracking the selection of an ItemsControl type, you can set the Path property of the ContentControl binding to "/" to indicate that you are interested in the current item. Como ejemplo, vea Cómo: Enlazar a una colección y mostrar información basada en la selección.For an example, see How to: Bind to a Collection and Display Information Based on Selection. En caso contrario, deberá especificar el DataTemplate explícitamente estableciendo la ContentTemplate propiedad.Otherwise, you need to specify the DataTemplate explicitly by setting the ContentTemplate property.

El DataType propiedad resulta especialmente útil cuando tenga un CompositeCollection de diferentes tipos de objetos de datos.The DataType property is particularly useful when you have a CompositeCollection of different types of data objects.

Si esta propiedad tiene como destino un elemento XML que no está en el espacio de nombres predeterminado, debe preceder el nombre del elemento con el espacio de nombres ni un designador de espacio de nombres.If this property targets an XML element that is not in the default namespace, you must precede the element name with the namespace or a namespace designator. Para XML que se exponen a través de LINQ para XML, el espacio de nombres aparece entre llaves, precedidas por una secuencia de escape de llaves:For XML exposed through LINQ for XML, the namespace appears in braces, preceded by a brace escape sequence:

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

Para XML expuesto a través de XPath, el nombre del elemento está precedido por un designador de espacio de nombres establecido por una instancia de XmlNamespaceMapping:For XML exposed through XPath, the element name is preceded by a namespace designator established by an instance of XmlNamespaceMapping:

<DataTemplate DataType="mn:Details">  

Uso de atributos XAMLXAML Attribute Usage

<object DataType="typeName"/>  

Valores XAMLXAML Values

typeNametypeName
Si la plantilla está pensada para los datos de objetos, esta propiedad contiene el nombre de tipo del objeto de datos (como una cadena).If the template is intended for object data, this property contains the type name of the data object (as a string). Para hacer referencia al nombre del tipo de la clase, use la x: Type Markup Extension.To refer to the type name of the class, use the x:Type Markup Extension. Si la plantilla está pensada para XMLXML datos, esta propiedad contienen el nombre del elemento XML.If the template is intended for XMLXML data, this property contains the XML element name. Vea los comentarios de documentación para obtener más información acerca de cómo especificar un espacio de nombres no predeterminado para el elemento XML.See the documentation remarks for details about specifying a non-default namespace for the XML element.

Se aplica a

Consulte también: