DataGridTemplateColumn Klasse

Definition

Stellt eine DataGrid-Spalte dar, in deren Zellen von Vorlagen angegebene Inhalte gehostet werden.Represents a DataGrid column that hosts template-specified content in its cells.

public ref class DataGridTemplateColumn : System::Windows::Controls::DataGridColumn
public class DataGridTemplateColumn : System.Windows.Controls.DataGridColumn
type DataGridTemplateColumn = class
    inherit DataGridColumn
Public Class DataGridTemplateColumn
Inherits DataGridColumn
Vererbung

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein DataGridTemplateColumn erstellt wird.The following example shows how to create a DataGridTemplateColumn.

<Grid>
    <Grid.Resources>
        <!--DataTemplate for Published Date column defined in Grid.Resources.  PublishDate is a property on the ItemsSource of type DateTime -->
        <DataTemplate x:Key="DateTemplate" >
            <StackPanel Width="20" Height="30">
                <Border Background="LightBlue" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:MMM}}" FontSize="8" HorizontalAlignment="Center" />
                </Border>
                <Border Background="White" BorderBrush="Black" BorderThickness="1">
                    <TextBlock Text="{Binding PublishDate, StringFormat={}{0:yyyy}}" FontSize="8" FontWeight="Bold" HorizontalAlignment="Center" />
                </Border>
            </StackPanel>
        </DataTemplate>
        <!--DataTemplate for the Published Date column when in edit mode. -->
        <DataTemplate x:Key="EditingDateTemplate">
            <DatePicker SelectedDate="{Binding PublishDate}"  />
        </DataTemplate>
    </Grid.Resources>
    <DataGrid Name="DG1" ItemsSource="{Binding}" AutoGenerateColumns="False" >
        <DataGrid.Columns>
            <!--Custom column that shows the published date-->
            <DataGridTemplateColumn Header="Publish Date" CellTemplate="{StaticResource DateTemplate}" CellEditingTemplate="{StaticResource EditingDateTemplate}" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Die folgende Abbildung zeigt die Ausgabe des vorherigen XAML-Code.The following illustration shows the output from the previous XAML.

![Eine Spalte mit einem DataTemplate] (~/add/media/ndp-wpf-templatecolumn.png "Eine Spalte mit einem DataTemplate")A column using a DataTemplate

Hinweise

Mithilfe DataGridTemplateColumn des-Typs können Sie eigene Spaltentypen erstellen, indem Sie die Zellen Vorlagen angeben, die beim Anzeigen und Bearbeiten von Werten verwendet werden sollen.The DataGridTemplateColumn type enables you to create your own column types by specifying the cell templates to use when displaying and editing values. Legen Sie die CellTemplate -Eigenschaft fest, um die Vorlage anzugeben, die zum Anzeigen des Inhalts einer Zelle verwendet wird, die sich nicht im Bearbeitungsmodus befindet.To specify the template that is used to display the contents of a cell that is not in editing mode, set the CellTemplate property. Um die Vorlage anzugeben, die zum Anzeigen der Inhalte einer Zelle im Bearbeitungsmodus verwendet wird, legen Sie die CellEditingTemplate -Eigenschaft fest.To specify the template that is used to display the contents of a cell that is in editing mode, set the CellEditingTemplate property. Weitere Informationen zu Vorlagen finden Sie unter Übersicht über Daten Vorlagen und formatieren undVorlagen.For more information about templates, see Data Templating Overview and Styling and Templating.

Der praktische bereitstellt die folgenden vordefinierten Spaltentypen bereit: DataGridFor convenience, DataGrid provides the following pre-defined column types:

SpaltentypColumn Type DatenanzeigeData Display
DataGridHyperlinkColumn Verwenden Sie, um URI-Daten anzuzeigen.Use to display URI data.
DataGridComboBoxColumn Verwenden Sie, um Enumerationsdaten anzuzeigen.Use to display enumeration data.
DataGridTextColumn Verwenden Sie, um Text anzuzeigen.Use to display text.
DataGridCheckBoxColumn Verwenden Sie, um boolesche Daten anzuzeigen.Use to display Boolean data.

Konstruktoren

DataGridTemplateColumn()

Initialisiert eine neue Instanz der DataGridTemplateColumn-Klasse.Initializes a new instance of the DataGridTemplateColumn class.

Felder

CellEditingTemplateProperty

Bezeichnet die CellEditingTemplate-Abhängigkeitseigenschaft.Identifies the CellEditingTemplate dependency property.

CellEditingTemplateSelectorProperty

Bezeichnet die CellEditingTemplateSelector-Abhängigkeitseigenschaft.Identifies the CellEditingTemplateSelector dependency property.

CellTemplateProperty

Bezeichnet die CellTemplate-Abhängigkeitseigenschaft.Identifies the CellTemplate dependency property.

CellTemplateSelectorProperty

Bezeichnet die CellEditingTemplateSelector-Abhängigkeitseigenschaft.Identifies the CellEditingTemplateSelector dependency property.

Eigenschaften

ActualWidth

Ruft die aktuelle Breite der Spalte in Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit) ab.Gets the current width of the column, in Geräteunabhängige Einheiten (1/96 Zoll pro Einheit)device-independent units (1/96th inch per unit).

(Geerbt von DataGridColumn)
CanUserReorder

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, oder der Benutzer die Anzeigeposition von Spalten durch Ziehen der Spaltenüberschrift ändern kann.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Geerbt von DataGridColumn)
CanUserResize

Ruft einen Wert ab, der angibt, ob der Benutzer die Spaltenbreiten mithilfe der Maus anpassen kann, oder legt diesen fest.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Geerbt von DataGridColumn)
CanUserSort

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob der Benutzer die Spalte durch Klicken auf die Spaltenüberschrift sortieren kann.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Geerbt von DataGridColumn)
CellEditingTemplate

Ruft die Vorlage ab, die zum Anzeigen des Inhalts einer Zelle verwendet werden soll, die sich im Bearbeitungsmodus befindet, oder legt diese fest.Gets or sets the template to use to display the contents of a cell that is in editing mode.

CellEditingTemplateSelector

Ruft das Objekt ab, das festlegt, welche Vorlage zum Anzeigen der Inhalte einer Zelle im Bearbeitungsmodus verwendet wird, oder legt dieses fest.Gets or sets the object that determines which template to use to display the contents of a cell that is in editing mode.

CellStyle

Ruft die Formatvorlage ab, die zum Rendern von Zellen in der Spalte verwendet wird, oder legt sie fest.Gets or sets the style that is used to render cells in the column.

(Geerbt von DataGridColumn)
CellTemplate

Ruft die Vorlage zum Anzeigen der Inhalte einer nicht im Bearbeitungsmodus befindlichen Zelle ab, oder legt diese fest.Gets or sets the template to use to display the contents of a cell that is not in editing mode.

CellTemplateSelector

Ruft das Objekt ab, das festlegt, welche Vorlage zum Anzeigen der Inhalte einer nicht im Bearbeitungsmodus befindlichen Zelle verwendet wird, oder legt dieses fest.Gets or sets the object that determines which template to use to display the contents of a cell that is not in editing mode.

ClipboardContentBinding

Ruft das Bindungsobjekt ab, das beim Abrufen oder Festlegen von Zelleninhalt für die Zwischenablage verwendet werden soll, oder legt dieses fest.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Geerbt von DataGridColumn)
DataGridOwner

Ruft das DataGrid-Steuerelement ab, das diese Spalte enthält.Gets the DataGrid control that contains this column.

(Geerbt von DataGridColumn)
DependencyObjectType

Ruft den DependencyObjectType ab, der den CLRCLR-Typ dieser Instanz umschließt.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Geerbt von DependencyObject)
Dispatcher

Ruft den Dispatcher ab, der diesem DispatcherObject zugeordnet ist.Gets the Dispatcher this DispatcherObject is associated with.

(Geerbt von DispatcherObject)
DisplayIndex

Ruft die Anzeigeposition der Spalte relativ zu den anderen Spalten im DataGrid ab oder legt diese fest.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Geerbt von DataGridColumn)
DragIndicatorStyle

Ruft das Formatobjekt ab, das bei einem Ziehvorgang für den Spaltenheader übernommen werden soll, oder legt es fest.Gets or sets the style object to apply to the column header during a drag operation.

(Geerbt von DataGridColumn)
Header

Ruft den Inhalt der Spaltenüberschrift ab bzw. legt diesen fest.Gets or sets the content of the column header.

(Geerbt von DataGridColumn)
HeaderStringFormat

Ruft das Formatmuster ab, das auf den Inhalt des Spaltenheaders angewendet werden soll, oder legt dieses fest.Gets or sets the format pattern to apply to the content of the column header.

(Geerbt von DataGridColumn)
HeaderStyle

Ruft den Stil ab, der beim Rendern des Spaltenheaders verwendet wird, oder legt diesen fest.Gets or sets the style that is used when rendering the column header.

(Geerbt von DataGridColumn)
HeaderTemplate

Ruft die Vorlage ab, die die optische Darstellung des Spaltenheaders festlegt, oder legt diese fest.Gets or sets the template that defines the visual representation of the column header.

(Geerbt von DataGridColumn)
HeaderTemplateSelector

Ruft das Objekt ab, das die für den Spaltenheader zu verwendende Vorlage festlegt, oder legt dieses fest.Gets or sets the object that selects which template to use for the column header.

(Geerbt von DataGridColumn)
IsAutoGenerated

Ruft einen Wert ab, der angibt, ob die Spalte automatisch generiert wird.Gets a value that indicates whether the column is auto-generated.

(Geerbt von DataGridColumn)
IsFrozen

Ruft einen Wert ab, der angibt, ob horizontale Bildläufe in der Spalte verhindert werden.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Geerbt von DataGridColumn)
IsReadOnly

Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob Zellen in der Spalte bearbeitet werden können.Gets or sets a value that indicates whether cells in the column can be edited.

(Geerbt von DataGridColumn)
IsSealed

Ruft einen Wert ab, der angibt, ob diese Instanz derzeit versiegelt (schreibgeschützt) ist.Gets a value that indicates whether this instance is currently sealed (read-only).

(Geerbt von DependencyObject)
MaxWidth

Ruft die Einschränkung für die maximale Breite der Spalte ab oder legt diese fest.Gets or sets the maximum width constraint of the column.

(Geerbt von DataGridColumn)
MinWidth

Ruft die Einschränkung für die Mindestbreite der Spalte ab oder legt diese fest.Gets or sets the minimum width constraint of the column.

(Geerbt von DataGridColumn)
SortDirection

Ruft die Sortierrichtung (auf- oder absteigend) der Spalte ab, oder legt diese fest.Gets or sets the sort direction (ascending or descending) of the column.

(Geerbt von DataGridColumn)
SortMemberPath

Ruft einen Eigenschaftennamen oder eine durch Punkte getrennte Hierarchie von Eigenschaftennamen ab, die das zu sortierende Element angibt, bzw. legt diese/n fest.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Geerbt von DataGridColumn)
Visibility

Ruft die Sichtbarkeit der Spalte ab bzw. legt diese fest.Gets or sets the visibility of the column.

(Geerbt von DataGridColumn)
Width

Ruft die Spaltenbreite oder den Modus zum automatischen Festlegen der Größe ab bzw. legt diese/n fest.Gets or sets the column width or automatic sizing mode.

(Geerbt von DataGridColumn)

Methoden

CancelCellEdit(FrameworkElement, Object)

Führt dazu, dass die zu bearbeitende Zelle auf den originalen, unbearbeiteten Wert zurückgesetzt wird.Causes the cell being edited to revert to the original, unedited value.

(Geerbt von DataGridColumn)
CheckAccess()

Bestimmt, ob der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Determines whether the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)
ClearValue(DependencyProperty)

Löscht den lokalen Wert einer Eigenschaft.Clears the local value of a property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyProperty-Bezeichner angegeben.The property to be cleared is specified by a DependencyProperty identifier.

(Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)

Löscht den lokalen Wert einer schreibgeschützten Eigenschaft.Clears the local value of a read-only property. Die Eigenschaft, deren Wert gelöscht werden soll, wird durch einen DependencyPropertyKey angegeben.The property to be cleared is specified by a DependencyPropertyKey.

(Geerbt von DependencyObject)
CoerceValue(DependencyProperty)

Erzwingt den Wert der angegebenen Abhängigkeitseigenschaft.Coerces the value of the specified dependency property. Dies erfolgt durch den Aufruf einer beliebigen CoerceValueCallback-Funktion, die in den Metadaten für die Abhängigkeitseigenschaft angegeben ist, während sie beim aufrufenden DependencyObject beendet wird.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Geerbt von DependencyObject)
CommitCellEdit(FrameworkElement)

Führt jede erforderliche Validierung vor dem Beenden des Zellbearbeitungsmodus aus.Performs any required validation before exiting cell editing mode.

(Geerbt von DataGridColumn)
Equals(Object)

Bestimmt, ob ein angegebenes DependencyObject dem aktuellen DependencyObject entspricht.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Geerbt von DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Ruft ein Element ab, das von der CellEditingTemplate definiert wird, die an den Binding-Eigenschaftswert der Spalte gebunden ist.Gets an element defined by the CellEditingTemplate that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Ruft ein Element ab, das von der CellTemplate definiert wird, die an den Binding-Eigenschaftswert der Spalte gebunden ist.Gets an element defined by the CellTemplate that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Ruft den Content-Eigenschaftswert der Zelle an der Schnittstelle dieser Spalte und der angegebenen Zeile ab.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Geerbt von DataGridColumn)
GetCellContent(Object)

Ruft den Content-Eigenschaftswert der Zelle an der Schnittstelle dieser Spalte und der Zeile ab, die das angegebene Datenelement darstellt.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Geerbt von DataGridColumn)
GetHashCode()

Ruft einen Hashcode für diese DependencyObject ab.Gets a hash code for this DependencyObject.

(Geerbt von DependencyObject)
GetLocalValueEnumerator()

Erstellt einen spezialisierten Enumerator, mit dem bestimmt wird, welche Abhängigkeitseigenschaften dieses DependencyObject über lokal festgelegte Werte verfügen.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Geerbt von DependencyObject)
GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Geerbt von Object)
GetValue(DependencyProperty)

Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObject zurück.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)

Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus.Re-evaluates the effective value for the specified dependency property.

(Geerbt von DependencyObject)
MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Geerbt von Object)
NotifyPropertyChanged(String)

Benachrichtigt DataGrid, das diese Spalte enthält, dass sich eine Spalteneigenschaft geändert hat.Notifies the DataGrid that contains this column that a column property has changed.

(Geerbt von DataGridColumn)
OnCoerceIsReadOnly(Boolean)

Bestimmt den Wert der IsReadOnly-Eigenschaft auf der Grundlage der Eigenschaftsregeln für das DataGrid, das diese Spalte enthält.Determines the value of the IsReadOnly property based on the property rules of the DataGrid that contains this column.

(Geerbt von DataGridColumn)
OnCopyingCellClipboardContent(Object)

Löst das Ereignis CopyingCellClipboardContent aus.Raises the CopyingCellClipboardContent event.

(Geerbt von DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Löst das Ereignis PastingCellClipboardContent aus.Raises the PastingCellClipboardContent event.

(Geerbt von DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Wird immer dann aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für dieses DependencyObject aktualisiert wurde.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. Welche spezifische Abhängigkeitseigenschaft geändert wird, wird in den Ereignisdaten gemeldet.The specific dependency property that changed is reported in the event data.

(Geerbt von DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Legt beim Überschreiben in einer abgeleiteten Klasse den Bearbeitungsbedarf entsprechend dem Zelleninhalt fest.When overridden in a derived class, sets cell content as needed for editing.

(Geerbt von DataGridColumn)
ReadLocalValue(DependencyProperty)

Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, wenn dieser vorhanden ist.Returns the local value of a dependency property, if it exists.

(Geerbt von DependencyObject)
RefreshCellContent(FrameworkElement, String)

Aktualisiert den Inhalt einer Zelle in der Spalte als Reaktion auf die Änderung eines Vorlageneigenschaftswerts.Refreshes the contents of a cell in the column in response to a template property value change.

SetCurrentValue(DependencyProperty, Object)

Legt den Wert einer Abhängigkeitseigenschaft fest, ohne deren Wertquelle zu ändern.Sets the value of a dependency property without changing its value source.

(Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)

Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch ihren Bezeichner angegeben ist.Sets the local value of a dependency property, specified by its dependency property identifier.

(Geerbt von DependencyObject)
SetValue(DependencyPropertyKey, Object)

Legt den lokalen Wert einer schreibgeschützten Abhängigkeitseigenschaft fest, die durch den DependencyPropertyKey-Bezeichner der Abhängigkeitseigenschaft angegeben ist.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert der bereitgestellten Abhängigkeitseigenschaft serialisieren sollen.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Geerbt von DependencyObject)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Geerbt von Object)
VerifyAccess()

Erzwingt, dass der aufrufende Thread auf dieses DispatcherObject zugreifen kann.Enforces that the calling thread has access to this DispatcherObject.

(Geerbt von DispatcherObject)

Ereignisse

CopyingCellClipboardContent

Tritt auf, nachdem der Inhalt der Zellenzwischenablage vorbereitet wurde.Occurs after the cell clipboard content is prepared.

(Geerbt von DataGridColumn)
PastingCellClipboardContent

Tritt auf, bevor der Zwischenablageinhalt in die Zelle verschoben wird.Occurs before the clipboard content is moved to the cell.

(Geerbt von DataGridColumn)

Gilt für:

Siehe auch