DataTemplate.DataType Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o tipo para o qual isto DataTemplate se destina.
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, setPublic Property DataType As ObjectValor de Propriedade
O valor predefinido é null.
- Atributos
Observações
Esta propriedade é muito semelhante à TargetType propriedade da Style classe. Quando defines esta propriedade para o tipo de dados sem especificar um x:Key, o DataTemplate é aplicado automaticamente a objetos de dados desse tipo. Note que, ao fazer isso, o x:Key é definido implicitamente. Portanto, se atribuires um valor a DataTemplatex:Key, estás a substituir o implícito x:Key e o DataTemplate não seria aplicado automaticamente.
Note também que, se estiver a ligar a ContentControl a a a uma coleção de Task objetos, o ContentControl não usa o DataTemplate automaticamente. Isso ocorre porque a associação em um ContentControl precisa de mais informações para distinguir se você deseja vincular a uma coleção inteira ou aos objetos individuais. Se o seu ContentControl estiver acompanhando a seleção de um tipo de ItemsControl, pode definir a propriedade Path da vinculação ContentControl para "/" a fim de indicar que está interessado no item atual. Para um exemplo, veja Como: Vincular a uma Coleção e Exibir Informação com Base na Seleção. Caso contrário, você precisará especificar o DataTemplate explicitamente definindo a ContentTemplate propriedade.
A DataType propriedade é particularmente útil quando você tem um CompositeCollection de diferentes tipos de objetos de dados.
Se esta propriedade tiver como alvo um elemento XML que não esteja no namespace padrão, deve preceder o nome do elemento com o namespace ou um designador de namespace. Para XML exposto através do LINQ para XML, o espaço de nomes aparece entre colchetes, precedido por uma sequência de escape entre colchetes:
<DataTemplate DataType="{}{http://myNamespace}Details">
Para XML exposto através do XPath, o nome do elemento é precedido por um designador de espaço de nomes estabelecido por uma instância de XmlNamespaceMapping:
<DataTemplate DataType="mn:Details">
Uso de atributos XAML
<object DataType="typeName"/>
Valores XAML
tipoNome Se o template for destinado a dados de objetos, esta propriedade contém o nome do tipo do objeto de dados (como uma cadeia de caracteres). Para se referir ao nome do tipo da classe, use a Extensão de Marcação x:Tipo. Se o modelo for destinado a dados XML, esta propriedade contém o nome do elemento XML. Consulte as observações da documentação para detalhes sobre a especificação de um namespace não padrão para o elemento XML.
