DataTemplate 클래스

정의

네임스페이스:

System.Windows

어셈블리:

PresentationFramework.dll

데이터 개체의 표시 구조에 대해 설명합니다.

public ref class DataTemplate : System::Windows::FrameworkTemplate

[System.Windows.Markup.DictionaryKeyProperty("DataTemplateKey")]
public class DataTemplate : System.Windows.FrameworkTemplate

[<System.Windows.Markup.DictionaryKeyProperty("DataTemplateKey")>]
type DataTemplate = class
    inherit FrameworkTemplate

Public Class DataTemplate
Inherits FrameworkTemplate

상속

Object

DispatcherObject

FrameworkTemplate

DataTemplate

파생

System.Windows.Controls.ItemContainerTemplate

System.Windows.HierarchicalDataTemplate

특성

DictionaryKeyPropertyAttribute

예제

다음 예제에서는 인라인을 DataTemplate 만드는 방법을 보여줍니다. 각 DataTemplate 데이터 항목이 에 세 TextBlock 개의 요소 StackPanel로 표시되도록 지정합니다. 이 예제에서 데이터 개체는 .라는 Task클래스입니다. 이 템플릿의 각 TextBlock 요소는 클래스의 Task 속성에 바인딩됩니다.

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}">
   <ListBox.ItemTemplate>
     <DataTemplate>
       <StackPanel>
         <TextBlock Text="{Binding Path=TaskName}" />
         <TextBlock Text="{Binding Path=Description}"/>
         <TextBlock Text="{Binding Path=Priority}"/>
       </StackPanel>
     </DataTemplate>
   </ListBox.ItemTemplate>
 </ListBox>

다음 예제와 같이 재사용 가능한 개체가 될 수 있도록 리소스 섹션에서 정의하는 DataTemplate 것이 더 일반적입니다.

<Window.Resources>

<DataTemplate x:Key="myTaskTemplate">
  <StackPanel>
    <TextBlock Text="{Binding Path=TaskName}" />
    <TextBlock Text="{Binding Path=Description}"/>
    <TextBlock Text="{Binding Path=Priority}"/>
  </StackPanel>
</DataTemplate>

</Window.Resources>

이제 다음 예제와 같이 myTaskTemplate을 리소스로 사용할 수 있습니다.

<ListBox Width="400" Margin="10"
         ItemsSource="{Binding Source={StaticResource myTodoList}}"
         ItemTemplate="{StaticResource myTaskTemplate}"/>

전체 샘플을 보려면 Introduction to Data Templating Sample(데이터 템플릿 샘플 소개)을 참조하세요.

설명

데이터 DataTemplate 개체의 시각화를 지정하는 데 사용합니다. DataTemplate개체는 전체 컬렉션에 바인딩 ListBox 할 ItemsControl 때 특히 유용합니다. 특정 지침이 ListBox 없으면 컬렉션에 있는 개체의 문자열 표현이 표시됩니다. 이 경우 a를 DataTemplate 사용하여 데이터 개체의 모양을 정의할 수 있습니다. 콘텐츠 DataTemplate 는 데이터 개체의 시각적 구조가 됩니다.

자세한 내용은 데이터 템플릿 개요를 참조하세요.

생성자

DataTemplate()	DataTemplate 클래스의 새 인스턴스를 초기화합니다.
DataTemplate(Object)	지정된 DataTemplate 속성을 사용하여 DataType 클래스의 새 인스턴스를 초기화합니다.

속성

DataTemplateKey	DataTemplate의 기본 키를 가져옵니다.
DataType	이 DataTemplate이 사용되는 형식을 가져오거나 설정합니다.
Dispatcher	이 Dispatcher와 연결된 DispatcherObject를 가져옵니다. (다음에서 상속됨 DispatcherObject)
HasContent	이 템플릿의 콘텐츠가 최적화되어 있는지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FrameworkTemplate)
IsSealed	이 개체가 변경할 수 없는 변경 불가능 상태인지 여부를 나타내는 값을 가져옵니다. (다음에서 상속됨 FrameworkTemplate)
Resources	이 템플릿의 범위 내에서 사용할 수 있는 리소스의 컬렉션을 가져오거나 설정합니다. (다음에서 상속됨 FrameworkTemplate)
Template	작성자가 템플릿을 정의하거나 적용할 때 해당 템플릿의 XAML 노드를 기록/재생하는 개체에 대한 참조를 가져오거나 설정합니다. (다음에서 상속됨 FrameworkTemplate)
Triggers	하나 이상의 조건에 따라 속성 값을 적용하거나 작업을 수행하는 트리거의 컬렉션을 가져옵니다.
VisualTree	템플릿의 루트 노드를 가져오거나 설정합니다. (다음에서 상속됨 FrameworkTemplate)

메서드

CheckAccess()	호출 스레드가 이 DispatcherObject에 액세스할 수 있는지 여부를 확인합니다. (다음에서 상속됨 DispatcherObject)
Equals(Object)	지정된 개체가 현재 개체와 같은지 확인합니다. (다음에서 상속됨 Object)
FindName(String, FrameworkElement)	이 템플릿 내에 정의된 지정한 이름과 연결된 요소를 찾습니다. (다음에서 상속됨 FrameworkTemplate)
GetHashCode()	기본 해시 함수로 작동합니다. (다음에서 상속됨 Object)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
LoadContent()	템플릿의 콘텐츠를 개체의 인스턴스로 로드하고 콘텐츠의 루트 요소를 반환합니다. (다음에서 상속됨 FrameworkTemplate)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
RegisterName(String, Object)	현재 이름 범위에 새 이름/개체 쌍을 등록합니다. (다음에서 상속됨 FrameworkTemplate)
Seal()	템플릿을 변경할 수 없도록 잠급니다. (다음에서 상속됨 FrameworkTemplate)
ShouldSerializeResources(XamlDesignerSerializationManager)	이 클래스의 인스턴스에서 serialization 프로세스를 통해 Resources 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 FrameworkTemplate)
ShouldSerializeVisualTree()	이 클래스의 인스턴스에서 serialization 프로세스를 통해 VisualTree 속성의 값을 serialize해야 하는지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 FrameworkTemplate)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)
UnregisterName(String)	XAML 이름 범위에서 이름/개체 매핑을 제거합니다. (다음에서 상속됨 FrameworkTemplate)
ValidateTemplatedParent(FrameworkElement)	규칙 집합에 대해 템플릿 부모를 확인합니다.
VerifyAccess()	호출 스레드에서 이 DispatcherObject에 액세스할 수 있는지 확인합니다. (다음에서 상속됨 DispatcherObject)

명시적 인터페이스 구현

INameScope.FindName(String)	지정된 식별 이름이 있는 개체를 반환합니다. (다음에서 상속됨 FrameworkTemplate)
IQueryAmbient.IsAmbientPropertyAvailable(String)	지정된 앰비언트 속성을 현재 범위에서 사용할 수 있는지 여부를 쿼리합니다. (다음에서 상속됨 FrameworkTemplate)

추가 정보

• Binding
• DataTemplateSelector
• HierarchicalDataTemplate
• 데이터 바인딩 데모