DataTemplateSelector Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет способ выбора DataTemplate на основе объекта данных и элемента, привязанного к данным.
public ref class DataTemplateSelector
public class DataTemplateSelector
type DataTemplateSelector = class
Public Class DataTemplateSelector
- Наследование
-
DataTemplateSelector
Примеры
В этом примере источник привязки Task — это список объектов. Одним из свойств Task объекта является Priority. Определены два шаблона данных и myTaskTemplateimportantTaskTemplate.
Чтобы заложить логику выбора, какой DataTemplate использовать на основе значения Priority объекта данных, создайте подкласс DataTemplateSelector и переопределите метод SelectTemplate. В следующем примере метод SelectTemplate предоставляет логику для возврата соответствующего шаблона на основе значения свойства Priority. Шаблон для возврата находится в ресурсах охватывающего элемента Window.
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
Затем мы можем объявить TaskListDataTemplateSelector ресурсом.
<Window.Resources>
<local:TaskListDataTemplateSelector x:Key="myDataTemplateSelector"/>
</Window.Resources>
Чтобы использовать ресурс селектора шаблона, назначьте его свойству ItemTemplateSelectorListBox.
ListBox вызывает метод SelectTemplate объекта TaskListDataTemplateSelector для каждого элемента в базовой коллекции. Вызов передает объект данных в качестве параметра элемента. Затем к объекту данных применяется DataTemplate, возвращаемая методом.
<ListBox Width="400" Margin="10"
ItemsSource="{Binding Source={StaticResource myTodoList}}"
ItemTemplateSelector="{StaticResource myDataTemplateSelector}"
HorizontalContentAlignment="Stretch"/>
Полный пример см. в разделе Введение в шаблон данных.
Комментарии
Как правило, создается DataTemplateSelector при наличии нескольких DataTemplate объектов одного типа и вы хотите предоставить собственную логику для DataTemplate применения на основе свойств каждого объекта данных. Обратите внимание, что если у вас есть объекты разных типов, можно задать DataType свойство в .DataTemplate Если это сделать, вам не нужно создавать DataTemplateSelector. Кроме того, если у вас есть объекты одного типа, но с разными свойствами, можно также рассмотреть возможность использования DataTrigger преобразователя данных или преобразователя данных. Дополнительные сведения см. в разделе "Общие сведения о шаблоне данных".
Чтобы создать селектор шаблона, создайте класс, который наследует от DataTemplateSelector метода и переопределит его SelectTemplate . После определения класса можно назначить экземпляр класса свойству селектора шаблона элемента.
Конструкторы
| Имя | Описание |
|---|---|
| DataTemplateSelector() |
Инициализирует новый экземпляр класса DataTemplateSelector. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| SelectTemplate(Object, DependencyObject) |
При переопределении в производном классе возвращается DataTemplate на основе пользовательской логики. |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |