DataTemplateSelector.SelectTemplate(Object, DependencyObject) Método

Definição

Quando substituído em uma classe derivada, retorna um DataTemplate com base em lógica personalizada.When overridden in a derived class, returns a DataTemplate based on custom logic.

public:
 virtual System::Windows::DataTemplate ^ SelectTemplate(System::Object ^ item, System::Windows::DependencyObject ^ container);
public virtual System.Windows.DataTemplate SelectTemplate (object item, System.Windows.DependencyObject container);
abstract member SelectTemplate : obj * System.Windows.DependencyObject -> System.Windows.DataTemplate
override this.SelectTemplate : obj * System.Windows.DependencyObject -> System.Windows.DataTemplate
Public Overridable Function SelectTemplate (item As Object, container As DependencyObject) As DataTemplate

Parâmetros

item
Object

O objeto de dados para o qual você seleciona o modelo.The data object for which to select the template.

container
DependencyObject

O objeto associado aos dados.The data-bound object.

Retornos

Retorna um DataTemplate ou null.Returns a DataTemplate or null. O valor padrão é null.The default value is null.

Exemplos

Neste exemplo, a origem da associação é uma lista de Task objetos.In this example, the binding source is a list of Task objects. Uma das propriedades de um Task objeto é. PriorityOne of the properties of a Task object is Priority. Há dois modelos de myTaskTemplate dados definidos e. importantTaskTemplateThere are two data templates defined, myTaskTemplate and importantTaskTemplate.

Para fornecer a lógica para escolher DataTemplate qual usar com base Priority no valor do objeto de dados, crie uma subclasse de DataTemplateSelector e substitua o SelectTemplate método.To supply logic to choose which DataTemplate to use based on the Priority value of the data object, create a subclass of DataTemplateSelector and override the SelectTemplate method. No exemplo a seguir, o SelectTemplate método fornece a lógica para retornar o modelo apropriado com base no valor Priority da propriedade.In the following example, the SelectTemplate method provides logic to return the appropriate template based on the value of the Priority property. O modelo a ser retornado é encontrado nos recursos do elemento enveloping Window .The template to return is found in the resources of the enveloping Window element.

using System.Windows;
using System.Windows.Controls;

namespace SDKSample
{
    public class TaskListDataTemplateSelector : DataTemplateSelector
    {
        public override DataTemplate
            SelectTemplate(object item, DependencyObject container)
        {
            FrameworkElement element = container as FrameworkElement;

            if (element != null && item != null && item is Task)
            {
                Task taskitem = item as Task;

                if (taskitem.Priority == 1)
                    return
                        element.FindResource("importantTaskTemplate") as DataTemplate;
                else
                    return
                        element.FindResource("myTaskTemplate") as DataTemplate;
            }

            return null;
        }
    }
}

Namespace SDKSample
    Public Class TaskListDataTemplateSelector
        Inherits DataTemplateSelector
        Public Overrides Function SelectTemplate(ByVal item As Object, ByVal container As DependencyObject) As DataTemplate

            Dim element As FrameworkElement
            element = TryCast(container, FrameworkElement)

            If element IsNot Nothing AndAlso item IsNot Nothing AndAlso TypeOf item Is Task Then

                Dim taskitem As Task = TryCast(item, Task)

                If taskitem.Priority = 1 Then
                    Return TryCast(element.FindResource("importantTaskTemplate"), DataTemplate)
                Else
                    Return TryCast(element.FindResource("myTaskTemplate"), DataTemplate)
                End If
            End If

            Return Nothing
        End Function
    End Class
End Namespace

Em seguida, podemos declarar o TaskListDataTemplateSelector como um recurso:We can then declare the TaskListDataTemplateSelector as a resource:

<Window.Resources>
<local:TaskListDataTemplateSelector x:Key="myDataTemplateSelector"/>
</Window.Resources>

Para usar o recurso de seletor de modelo, atribua ItemTemplateSelector -o à ListBoxPropriedade do.To use the template selector resource, assign it to the ItemTemplateSelector property of the ListBox. O ListBox chama o SelectTemplate método do TaskListDataTemplateSelector para cada um dos itens na coleção subjacente.The ListBox calls the SelectTemplate method of the TaskListDataTemplateSelector for each of the items in the underlying collection. A chamada passa o objeto de dados como o parâmetro de item.The call passes the data object as the item parameter. O DataTemplate que é retornado pelo método é então aplicado a esse objeto de dados.The DataTemplate that is returned by the method is then applied to that data object.

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}"
         ItemTemplateSelector="{StaticResource myDataTemplateSelector}"
         HorizontalContentAlignment="Stretch"/>

Para ver a amostra completa, consulte Amostra da introdução à modelagem de dados.For the complete sample, see Introduction to Data Templating Sample.

Comentários

Normalmente, você usa um seletor de modelo quando tem mais de um modelo de dados definido para o mesmo tipo de objeto.Typically, you use a template selector when you have more than one data template defined for the same type of objects. Por exemplo, se sua fonte de associação for listar uma lista de objetos de aluno e você quiser aplicar um modelo específico aos alunos em tempo de parcial.For example, if your binding source is list a list of student objects and you want to apply a particular template to the part-time students. Você pode fazer isso criando uma classe que herda de DataTemplateSelector e substituindo o SelectTemplate método.You can do this by creating a class that inherits from DataTemplateSelector and overriding the SelectTemplate method. Depois que sua classe for definida, você poderá atribuir uma instância da classe à propriedade seletor de modelo do elemento.Once your class is defined you can assign an instance of the class to the template selector property of your element.

Aplica-se a