DataTemplate.DataType Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o tipo para o qual isso 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, set
Public Property DataType As Object
Valor da propriedade
O valor padrão é null.
- Atributos
Comentários
Essa propriedade é muito semelhante à TargetType propriedade da Style classe. Quando você define essa propriedade para o tipo de dados sem especificar um x:Key, ela DataTemplate é aplicada automaticamente a objetos de dados desse tipo. Observe que, quando você faz isso, ele x:Key é definido implicitamente. Portanto, se você atribuir esse DataTemplate um valor x:Key, você substituirá o x:Key implícito e o DataTemplate não será aplicado automaticamente.
Observe também que, se você estiver associando um ContentControl a uma coleção de Task objetos, ele ContentControl não usará o DataTemplate automaticamente. Isso ocorre porque a associação em um ContentControl precisa de mais informações para distinguir se você deseja associar a uma coleção inteira ou a objetos individuais. Se o ContentControl estiver monitorando a seleção de um tipo ItemsControl, você pode definir a propriedade Path da associação ContentControl como "/" para indicar seu interesse no item atual. Para obter um exemplo, consulte Como associar a uma coleção e exibir informações com base na seleção. Caso contrário, você precisará especificar o DataTemplate explicitamente definindo a propriedade ContentTemplate.
A propriedade DataType é particularmente útil quando você tem um CompositeCollection de diferentes tipos de objetos de dados.
Se essa propriedade for direcionada a um elemento XML que não esteja no namespace padrão, você deverá preceder o nome do elemento com o namespace ou um designador de namespace. Para XML exposto por meio do LINQ para XML, o namespace aparece em chaves, precedida por uma sequência de escape de chave:
<DataTemplate DataType="{}{http://myNamespace}Details">
Para XML exposto por meio do XPath, o nome do elemento é precedido por um designador de namespace estabelecido por uma instância de XmlNamespaceMapping:
<DataTemplate DataType="mn:Details">
Uso do atributo XAML
<object DataType="typeName"/>
Valores XAML
Typename Se o modelo for destinado a dados de objeto, essa propriedade conterá o nome do tipo do objeto de dados (como uma cadeia de caracteres). Para fazer referência ao nome do tipo da classe, use a Extensão de Marcação x:Type. Se o modelo for destinado a dados XML, essa propriedade conterá o nome do elemento XML. Consulte as observações da documentação para obter detalhes sobre como especificar um namespace não padrão para o elemento XML.