정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

DataTemplate 클래스

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

네임스페이스:  System.Windows
어셈블리:  System.Windows(System.Windows.dll)

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

XAML 값

templateContent

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

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

  이름설명
Public 메서드Windows Phone용 Silverlight에서 지원DataTemplate() DataType 속성을 초기화하지 않고 DataTemplate 클래스의 새 인스턴스를 초기화합니다.
Public 메서드DataTemplate(Object) DataType 속성을 지정된 값으로 설정하여 DataTemplate 클래스의 새 인스턴스를 초기화합니다.
위쪽

  이름설명
Public 속성DataTypeDataTemplate을 적용할 형식을 가져오거나 설정합니다.
Public 속성Windows Phone용 Silverlight에서 지원Dispatcher이 개체와 관련된 Dispatcher를 가져옵니다. (DependencyObject에서 상속됨)
위쪽

  이름설명
Public 메서드Windows Phone용 Silverlight에서 지원CheckAccess호출 스레드에서 이 개체에 액세스할 수 있는지 여부를 확인합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원ClearValue종속성 속성의 로컬 값을 지웁니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원Equals(Object)지정된 Object가 현재 Object와 같은지 여부를 확인합니다. (Object에서 상속됨)
Protected 메서드Windows Phone용 Silverlight에서 지원Finalize가비지 수집에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetAnimationBaseValueSilverlight 종속성 속성에 대해 설정되어 있고 애니메이션이 활성 상태가 아닐 때 적용되는 기준 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetHashCode특정 형식에 대한 해시 함수 역할을 합니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원GetValue DependencyObject 에서 종속성 속성의 현재 유효 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원LoadContent DataTemplate UIElement 개체를 만듭니다.
Protected 메서드Windows Phone용 Silverlight에서 지원MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원ReadLocalValue로컬 값이 설정된 경우, 종속성 속성의 로컬 값을 반환합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원SetValue DependencyObject 에 종속성 속성의 로컬 값을 설정합니다. (DependencyObject에서 상속됨)
Public 메서드Windows Phone용 Silverlight에서 지원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을 참조하십시오.

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

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

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


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

    <ListBox ItemsSource="{StaticResource customers}" Width="350" Margin="0,5,0,10">
        <ListBox.ItemTemplate>
            <DataTemplate>
                <StackPanel Orientation="Horizontal">
                    <TextBlock Padding="5,0,5,0"
          Text="{Binding FirstName}" />
                    <TextBlock Text="{Binding LastName}" />
                    <TextBlock Text=", " />
                    <TextBlock Text="{Binding Address}" />
                </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"));
    }

}


Silverlight

5, 4, 3에서 지원

Windows Phone용 Silverlight

Windows Phone OS 7.1, Windows Phone OS 7.0에서 지원

Silverlight에서 지원되는 운영 체제 및 브라우저에 대한 자세한 내용은 지원되는 운영 체제 및 브라우저을 참조하십시오.

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

커뮤니티 추가 항목

표시:
© 2014 Microsoft