Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase DataTemplateSelector

 

Publicado: octubre de 2016

Proporciona una manera de elegir un elemento DataTemplate según el objeto de datos y el elemento enlazado a datos.

Espacio de nombres:   System.Windows.Controls
Ensamblado:  PresentationFramework (en PresentationFramework.dll)

System.Object
  System.Windows.Controls.DataTemplateSelector

public class DataTemplateSelector

NombreDescripción
System_CAPS_pubmethodDataTemplateSelector()

Inicializa una nueva instancia de la clase DataTemplateSelector.

NombreDescripción
System_CAPS_pubmethodEquals(Object)

Determina si el objeto especificado es igual al objeto actual.(Heredado de Object).

System_CAPS_protmethodFinalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.(Heredado de Object).

System_CAPS_pubmethodGetHashCode()

Sirve como la función hash predeterminada.(Heredado de Object).

System_CAPS_pubmethodGetType()

Obtiene el Type de la instancia actual.(Heredado de Object).

System_CAPS_protmethodMemberwiseClone()

Crea una copia superficial del Object actual.(Heredado de Object).

System_CAPS_pubmethodSelectTemplate(Object, DependencyObject)

Si se reemplaza en una clase derivada, devuelve un valor DataTemplate basado en una lógica personalizada.

System_CAPS_pubmethodToString()

Devuelve una cadena que representa el objeto actual.(Heredado de Object).

Typically, you create a T:System.Windows.Controls.DataTemplateSelector when you have more than one T:System.Windows.DataTemplate for the same type of objects and you want to supply your own logic to choose a T:System.Windows.DataTemplate to apply based on the properties of each data object. Note that if you have objects of different types you can set the P:System.Windows.DataTemplate.DataType property on the T:System.Windows.DataTemplate. If you do that then there is no need to create a T:System.Windows.Controls.DataTemplateSelector. Furthermore, if you have objects of the same type but with different properties, you can also consider using a T:System.Windows.DataTrigger or a data converter. For more information, see Data Templating Overview.

To create a template selector, create a class that inherits from T:System.Windows.Controls.DataTemplateSelector and override the M:System.Windows.Controls.DataTemplateSelector.SelectTemplate(System.Object,System.Windows.DependencyObject) method. Once your class is defined you can assign an instance of the class to the template selector property of your element.

In this example, the binding source is a list of Task objects. One of the properties of a Task object is Priority. There are two data templates defined, myTaskTemplate and importantTaskTemplate.

To supply logic to choose which T:System.Windows.DataTemplate to use based on the Priority value of the data object, create a subclass of T:System.Windows.Controls.DataTemplateSelector and override the M:System.Windows.Controls.DataTemplateSelector.SelectTemplate(System.Object,System.Windows.DependencyObject) method. In the following example, the M:System.Windows.Controls.DataTemplateSelector.SelectTemplate(System.Object,System.Windows.DependencyObject) method provides logic to return the appropriate template based on the value of the Priority property. The template to return is found in the resources of the enveloping T:System.Windows.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;
        }
    }
}

We can then declare the TaskListDataTemplateSelector as a resource:

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

To use the template selector resource, assign it to the P:System.Windows.Controls.ItemsControl.ItemTemplateSelector property of the T:System.Windows.Controls.ListBox. The T:System.Windows.Controls.ListBox calls the M:System.Windows.Controls.DataTemplateSelector.SelectTemplate(System.Object,System.Windows.DependencyObject) method of the TaskListDataTemplateSelector for each of the items in the underlying collection. The call passes the data object as the item parameter. The T:System.Windows.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"/>

For the complete sample, see Introduction to Data Templating Samplehttp://go.microsoft.com/fwlink/?LinkID=160009.

.NET Framework
Disponible desde 3.0

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: