내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

DataTemplate 클래스

2013-12-13

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

Namespace:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)
XMLNS for XAML: xmlns에 매핑되지 않습니다.

public class DataTemplate : FrameworkTemplate
<DataTemplate ...>
  templateContent
</DataTemplate>

XAML 값

templateContent

DataTemplate을 정의하는 개체 트리입니다. 트리에는 루트 요소 하나가 있어야 하며 해당 루트 요소는 0개 이상의 자식 요소를 가질 수 있습니다.

DataTemplate 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드DataTemplateDataTemplate 클래스의 새 인스턴스를 초기화합니다.
맨 위

  이름설명
Public 속성Dispatcher이 개체와 관련된 Dispatcher를 가져옵니다. (DependencyObject에서 상속됨)
맨 위

  이름설명
Public 메서드CheckAccess호출 스레드에서 이 개체에 액세스할 수 있는지 여부를 확인합니다. (DependencyObject에서 상속됨)
Public 메서드ClearValue종속성 속성의 로컬 값을 지웁니다. (DependencyObject에서 상속됨)
Public 메서드Equals(Object)지정한 Object가 현재 Object와 같은지 확인합니다. (Object에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetAnimationBaseValueWindows Phone 종속성 속성에 대해 설정되어 있고 애니메이션이 활성 상태가 아닐 때 적용되는 기준 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드GetValueDependencyObject에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드LoadContentDataTemplateUIElement 개체를 만듭니다.
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ReadLocalValue로컬 값이 설정된 경우, 종속성 속성의 로컬 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드SetValueDependencyObject에 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
맨 위

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

DataTemplate에서 데이터 바인딩을 사용할 수 있습니다. 예를 들어 ListBoxCustomer 개체의 컬렉션에 바인딩하고 ItemTemplate 속성을 DataTemplate으로 설정하는 경우를 가정합니다. ListBox를 만들 때 컬렉션의 각 Customer에 대해 ListBoxItem을 만들고 ListBoxItemDataContext를 해당 고객으로 설정합니다. 즉, 첫 번째 ListBoxItemDataContext를 첫 번째 고객으로 설정하고, 두 번째 ListBoxItemDataContext를 두 번째 고객으로 설정합니다. 이런 식으로 DataTemplate의 요소를 Customer 개체의 속성에 바인딩할 수 있습니다.

또한 DataTemplate을 사용하여 UIElement 개체를 여러 ContentControl 개체 간에서 공유할 수 있습니다. 예를 들어, 응용프로그램의 여러 버튼에 동일한 그래픽을 사용한다고 가정합니다. 이 경우 그래픽을 포함하는 DataTemplate을 만들고 이를 버튼의 ContentTemplate으로 사용합니다. 자세한 내용은 ContentControl.ContentTemplate을 참조하세요.

DataTemplateobject.ItemTemplate 속성 요소의 직계 자식으로 설정할 수 있습니다. 또한 DataTemplate을 리소스로 정의한 다음 해당 리소스를 ItemTemplate 속성의 값으로 참조할 수 있습니다.

XAML에서 데이터 템플릿을 만들 콘텐츠를 정의하기 위해 사용하는 경우에는 설정 가능한 속성으로 노출되지 않습니다. 이는 DataTemplate 개체 요소의 XAML 처리에서 내부적으로 제공되는 특수한 동작입니다.

다음 예제에서는 DataTemplate을 사용하여 ListBox의 항목을 표시합니다. 이 예제에서 ListBoxCustomer 개체의 컬렉션에 바인딩됩니다. DataTemplate에는 FirstName, LastNameAddress 속성에 바인딩되는 TextBlock 컨트롤이 들어 있습니다. 데이터 바인딩에 대한 자세한 내용은 Windows Phone의 데이터 바인딩을 참조하세요.


<Grid>
    <Grid.Resources>
        <src:Customers x:Key="customers"/>
    </Grid.Resources>

    <ListBox ItemsSource="{StaticResource customers}" Margin="0,5,0,10">
        <ListBox.ItemTemplate>
            <DataTemplate>
                <StackPanel Orientation="Horizontal" >
                    <TextBlock Padding="3,0,3,0"
          Text="{Binding FirstName}" FontSize="{StaticResource PhoneFontSizeSmall}"/>
                    <TextBlock Text="{Binding LastName}" FontSize="{StaticResource PhoneFontSizeSmall}"/>
                    <TextBlock Text=", " FontSize="{StaticResource PhoneFontSizeSmall}"/>
                    <TextBlock Text="{Binding Address}" FontSize="{StaticResource PhoneFontSizeSmall}"/>
                </StackPanel>
            </DataTemplate>
        </ListBox.ItemTemplate>
    </ListBox>
</Grid>


다음 예제에서는 Customer 클래스 및 ListBox가 바인딩되는 컬렉션을 보여 줍니다.


public class Customer
{
    public String FirstName { get; set; }
    public String LastName { get; set; }
    public String Address { get; set; }

    public Customer(String firstName, String lastName, String address)
    {
        this.FirstName = firstName;
        this.LastName = lastName;
        this.Address = address;
    }

}

public class Customers : ObservableCollection<Customer>
{
    public Customers()
    {
        Add(new Customer("Michael", "Anderberg",
                "12 North Third Street, Apartment 45"));
        Add(new Customer("Chris", "Ashton",
                "34 West Fifth Street, Apartment 67"));
        Add(new Customer("Cassie", "Hicks",
                "56 East Seventh Street, Apartment 89"));
        Add(new Customer("Guido", "Pica",
                "78 South Ninth Street, Apartment 10"));
    }

}


Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft