DataGridTextColumn Klasse

Referenz

Definition

Namespace:: System.Windows.Controls

Assembly:: PresentationFramework.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine DataGrid Spalte dar, die Textinhalte in ihren Zellen hostet.

public ref class DataGridTextColumn : System::Windows::Controls::DataGridBoundColumn

public class DataGridTextColumn : System.Windows.Controls.DataGridBoundColumn

type DataGridTextColumn = class
    inherit DataGridBoundColumn

Public Class DataGridTextColumn
Inherits DataGridBoundColumn

Vererbung: Object

DispatcherObject

DependencyObject

DataGridColumn

DataGridBoundColumn
DataGridTextColumn

Beispiele

Im folgenden Beispiel wird eine DataGrid erstellt, die benutzerdefinierte Textspalten enthält und XML-Daten als Quelle verwendet. Die Abbildung weiter oben in diesem Thema zeigt, wie dieser Code angezeigt wird. Weitere Informationen zum Binden an XML-Daten finden Sie unter How to: Bind to XML Data Using an XMLDataProvider and XPath Queries.

<Window.Resources>
    <XmlDataProvider x:Key="customerdata" Source="customers.xml" XPath="Data" />
</Window.Resources>
<Grid>
    <DataGrid AutoGenerateColumns="False" ItemsSource="{Binding Source={StaticResource customerdata}, XPath=Customer}">
        <DataGrid.Columns>
            <DataGridTextColumn Header="First Name" Binding="{Binding XPath=@FirstName}" FontFamily="Arial" FontStyle="Italic" />
            <DataGridTextColumn Header="Last Name" Binding="{Binding XPath=@LastName}" FontFamily="Arial" FontWeight="Bold" />
        </DataGrid.Columns>
    </DataGrid>
</Grid>

Hinweise

Verwenden Sie DataGridTextColumn, um Datenspalten als Text anzuzeigen. Die folgende Abbildung zeigt ein Beispiel für zwei DataGridTextColumn Typen.

Two DataGridTextColumns

Um eine Spalte zu erstellen, fügen Sie sie der Columns Auflistung hinzu. Um die Spalte aufzufüllen, binden Sie die Spalte mithilfe der Binding-Eigenschaft an die Daten. Die Binding-Eigenschaft wird auf das in der Spalte erstellte TextBlock- oder TextBox-Element angewendet. Die DataContext für das Element in jeder Zelle ist das Datenelement für die Zeile, in der sich die Zelle befindet. Um die Bindung einzurichten, müssen Sie daher nur die Binding.Pathfestlegen. Optional können Sie eine Binding.Converter angeben, wenn Sie die Daten oder die StringFormatkonvertieren möchten. Weitere Informationen zur Datenbindung finden Sie unter Data Binding (WPF).

Hinweis erstelltDataGridTextColumn ein TextBlock-Element im Nichtbearbeitungsmodus und ein TextBox Element im Bearbeitungsmodus.

Sie können die DataGridTextColumn anpassen, indem Sie Eigenschaften wie Width, Header, FontSizeund IsReadOnlyfestlegen.

Wenn Sie andere Datentypen anzeigen möchten, stellt DataGrid die folgenden Spaltentypen bereit:

Spaltentyp	Datenanzeige
DataGridHyperlinkColumn	Wird zum Anzeigen von URI-Daten verwendet.
DataGridComboBoxColumn	Wird zum Anzeigen von Enumerationsdaten verwendet.
DataGridCheckBoxColumn	Wird verwendet, um boolesche Daten anzuzeigen.

Wenn Sie andere Steuerelemente in Ihrer DataGridverwenden möchten, können Sie eigene Spaltentypen mithilfe von DataGridTemplateColumnerstellen.

Konstruktoren

DataGridTextColumn()

Initialisiert eine neue Instanz der DataGridTextColumn Klasse.

Felder

FontFamilyProperty	Identifies the FontFamily dependency property.
FontSizeProperty	Identifies the FontSize dependency property.
FontStyleProperty	Identifies the FontStyle dependency property.
FontWeightProperty	Identifies the FontWeight dependency property.
ForegroundProperty	Identifies the Foreground dependency property.

Eigenschaften

ActualWidth	Ruft die aktuelle Breite der Spalte in geräteunabhängigen Einheiten (1/96. Zoll pro Einheit) ab. (Geerbt von DataGridColumn)
Binding	Dient zum Abrufen oder Festlegen der Bindung, die die Spalte einer Eigenschaft in der Datenquelle zuordnet. (Geerbt von DataGridBoundColumn)
CanUserReorder	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Position der Spaltenanzeige ändern kann, indem die Spaltenüberschrift gezogen wird. (Geerbt von DataGridColumn)
CanUserResize	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Spaltenbreite mithilfe der Maus anpassen kann. (Geerbt von DataGridColumn)
CanUserSort	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer die Spalte sortieren kann, indem er auf die Spaltenüberschrift klickt. (Geerbt von DataGridColumn)
CellStyle	Dient zum Abrufen oder Festlegen der Formatvorlage, die zum Rendern von Zellen in der Spalte verwendet wird. (Geerbt von DataGridColumn)
ClipboardContentBinding	Dient zum Abrufen oder Festlegen des Bindungsobjekts, das beim Abrufen oder Festlegen von Zellinhalten für die Zwischenablage verwendet werden soll. (Geerbt von DataGridBoundColumn)
DataGridOwner	Ruft das DataGrid-Steuerelement ab, das diese Spalte enthält. (Geerbt von DataGridColumn)
DefaultEditingElementStyle	Der Standardwert der eigenschaft EditingElementStyle.
DefaultElementStyle	Der Standardwert der eigenschaft ElementStyle.
DependencyObjectType	Ruft die DependencyObjectType ab, die den CLR-Typ dieser Instanz umschließt. (Geerbt von DependencyObject)
Dispatcher	Ruft die Dispatcher dieser DispatcherObject zugeordnet ist. (Geerbt von DispatcherObject)
DisplayIndex	Dient zum Abrufen oder Festlegen der Anzeigeposition der Spalte relativ zu den anderen Spalten im DataGrid. (Geerbt von DataGridColumn)
DragIndicatorStyle	Dient zum Abrufen oder Festlegen des Formatvorlagenobjekts, das während eines Ziehvorgangs auf die Spaltenüberschrift angewendet werden soll. (Geerbt von DataGridColumn)
EditingElementStyle	Ruft die Formatvorlage ab, die beim Rendern des Elements, das in der Spalte für eine Zelle im Bearbeitungsmodus angezeigt wird, verwendet wird, oder legt diese fest. (Geerbt von DataGridBoundColumn)
ElementStyle	Dient zum Abrufen oder Festlegen der Formatvorlage, die beim Rendern des Elements verwendet wird, das in der Spalte für eine Zelle angezeigt wird, die sich nicht im Bearbeitungsmodus befindet. (Geerbt von DataGridBoundColumn)
FontFamily	Dient zum Abrufen oder Festlegen der Schriftfamilie für den Inhalt von Zellen in der Spalte.
FontSize	Dient zum Abrufen oder Festlegen des Schriftgrads für den Inhalt von Zellen in der Spalte.
FontStyle	Dient zum Abrufen oder Festlegen des Schriftschnitts für den Inhalt von Zellen in der Spalte.
FontWeight	Dient zum Abrufen oder Festlegen der Schriftbreite für den Inhalt von Zellen in der Spalte.
Foreground	Dient zum Abrufen oder Festlegen der Brush, die zum Zeichnen des Textinhalts von Zellen in der Spalte verwendet wird.
Header	Dient zum Abrufen oder Festlegen des Inhalts der Spaltenüberschrift. (Geerbt von DataGridColumn)
HeaderStringFormat	Dient zum Abrufen oder Festlegen des Formatmusters, das auf den Inhalt der Spaltenüberschrift angewendet werden soll. (Geerbt von DataGridColumn)
HeaderStyle	Ruft die Formatvorlage ab, die beim Rendern der Spaltenüberschrift verwendet wird, oder legt diese fest. (Geerbt von DataGridColumn)
HeaderTemplate	Dient zum Abrufen oder Festlegen der Vorlage, die die visuelle Darstellung der Spaltenüberschrift definiert. (Geerbt von DataGridColumn)
HeaderTemplateSelector	Dient zum Abrufen oder Festlegen des Objekts, das auswählt, welche Vorlage für die Spaltenüberschrift verwendet werden soll. (Geerbt von DataGridColumn)
IsAutoGenerated	Ruft einen Wert ab, der angibt, ob die Spalte automatisch generiert wird. (Geerbt von DataGridColumn)
IsFrozen	Ruft einen Wert ab, der angibt, ob die Spalte daran gehindert wird, horizontal zu scrollen. (Geerbt von DataGridColumn)
IsReadOnly	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob Zellen in der Spalte bearbeitet werden können. (Geerbt von DataGridColumn)
IsSealed	Ruft einen Wert ab, der angibt, ob diese Instanz aktuell versiegelt ist (schreibgeschützt). (Geerbt von DependencyObject)
MaxWidth	Ruft die Maximale Breiteeinschränkung der Spalte ab oder legt sie fest. (Geerbt von DataGridColumn)
MinWidth	Dient zum Abrufen oder Festlegen der Minimalbreiteneinschränkung der Spalte. (Geerbt von DataGridColumn)
SortDirection	Dient zum Abrufen oder Festlegen der Sortierrichtung (aufsteigend oder absteigend) der Spalte. (Geerbt von DataGridColumn)
SortMemberPath	Dient zum Abrufen oder Festlegen eines Eigenschaftsnamens oder einer durch Punkt getrennten Hierarchie von Eigenschaftsnamen, die das Element angibt, nach dem sortiert werden soll. (Geerbt von DataGridColumn)
Visibility	Ruft die Sichtbarkeit der Spalte ab oder legt sie fest. (Geerbt von DataGridColumn)
Width	Dient zum Abrufen oder Festlegen der Spaltenbreite oder des automatischen Größenanpassungsmodus. (Geerbt von DataGridColumn)

Methoden

CancelCellEdit(FrameworkElement, Object)	Bewirkt, dass die bearbeitete Spaltenzelle auf den angegebenen Wert zurückgesetzt wird.
CancelCellEdit(FrameworkElement, Object)	Bewirkt, dass die bearbeitete Zelle auf den ursprünglichen, unbearbeiteten Wert zurückgesetzt wird. (Geerbt von DataGridColumn)
CheckAccess()	Bestimmt, ob der aufrufende Thread Zugriff auf diese DispatcherObjecthat. (Geerbt von DispatcherObject)
ClearValue(DependencyProperty)	Löscht den lokalen Wert einer Eigenschaft. Die zu löschende Eigenschaft wird durch einen DependencyProperty Bezeichner angegeben. (Geerbt von DependencyObject)
ClearValue(DependencyPropertyKey)	Löscht den lokalen Wert einer schreibgeschützten Eigenschaft. Die zu löschende Eigenschaft wird durch eine DependencyPropertyKeyangegeben. (Geerbt von DependencyObject)
CoerceValue(DependencyProperty)	Wandelt den Wert der angegebenen Abhängigkeitseigenschaft um. Dies wird erreicht, indem alle in Eigenschaftsmetadaten für die Abhängigkeitseigenschaft angegebenen CoerceValueCallback Funktion aufgerufen werden, wie sie für die aufrufende DependencyObjectvorhanden ist. (Geerbt von DependencyObject)
CommitCellEdit(FrameworkElement)	Führt vor dem Beenden des Bearbeitungsmodus alle erforderlichen Überprüfungen aus.
CommitCellEdit(FrameworkElement)	Führt vor dem Beenden des Zellbearbeitungsmodus eine erforderliche Überprüfung durch. (Geerbt von DataGridColumn)
Equals(Object)	Bestimmt, ob eine angegebene DependencyObject dem aktuellen DependencyObjectentspricht. (Geerbt von DependencyObject)
GenerateEditingElement(DataGridCell, Object)	Ruft ein TextBox-Steuerelement ab, das an den Binding Eigenschaftswert der Spalte gebunden ist.
GenerateElement(DataGridCell, Object)	Ruft ein schreibgeschütztes TextBlock-Steuerelement ab, das an den Binding Eigenschaftswert der Spalte gebunden ist.
GetCellContent(DataGridRow)	Ruft den wert der Content Eigenschaft für die Zelle am Schnittpunkt dieser Spalte und der angegebenen Zeile ab. (Geerbt von DataGridColumn)
GetCellContent(Object)	Ruft den Content Eigenschaftswert für die Zelle an der Schnittmenge dieser Spalte und die Zeile ab, die das angegebene Datenelement darstellt. (Geerbt von DataGridColumn)
GetHashCode()	Ruft einen Hashcode für diese DependencyObjectab. (Geerbt von DependencyObject)
GetLocalValueEnumerator()	Erstellt einen speziellen Enumerator zum Bestimmen, welche Abhängigkeitseigenschaften lokal für dieses DependencyObjectfestgelegt sind. (Geerbt von DependencyObject)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
GetValue(DependencyProperty)	Gibt den aktuellen effektiven Wert einer Abhängigkeitseigenschaft für diese Instanz eines DependencyObjectzurück. (Geerbt von DependencyObject)
InvalidateProperty(DependencyProperty)	Wertet den effektiven Wert für die angegebene Abhängigkeitseigenschaft erneut aus. (Geerbt von DependencyObject)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
NotifyPropertyChanged(String)	Benachrichtigt die DataGrid, die diese Spalte enthält, dass eine Spalteneigenschaft geändert wurde. (Geerbt von DataGridColumn)
OnBindingChanged(BindingBase, BindingBase)	Benachrichtigt den DataGrid, wenn sich der Wert der Binding Eigenschaft ändert. (Geerbt von DataGridBoundColumn)
OnCoerceIsReadOnly(Boolean)	Bestimmt den Wert der IsReadOnly -Eigenschaft basierend auf Eigenschaftsregeln aus dem Datenraster, das diese Spalte enthält. (Geerbt von DataGridBoundColumn)
OnCopyingCellClipboardContent(Object)	Löst das CopyingCellClipboardContent-Ereignis aus. (Geerbt von DataGridColumn)
OnPastingCellClipboardContent(Object, Object)	Löst das PastingCellClipboardContent-Ereignis aus. (Geerbt von DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)	Wird immer aufgerufen, wenn der effektive Wert einer Abhängigkeitseigenschaft für diese DependencyObject aktualisiert wurde. Die spezifische Abhängigkeitseigenschaft, die geändert wurde, wird in den Ereignisdaten gemeldet. (Geerbt von DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)	Wird aufgerufen, wenn eine Zelle in der Spalte in den Bearbeitungsmodus wechselt.
ReadLocalValue(DependencyProperty)	Gibt den lokalen Wert einer Abhängigkeitseigenschaft zurück, sofern vorhanden. (Geerbt von DependencyObject)
RefreshCellContent(FrameworkElement, String)	Aktualisiert den Inhalt einer Zelle in der Spalte als Reaktion auf eine Änderung des Spalteneigenschaftswerts.
SetCurrentValue(DependencyProperty, Object)	Legt den Wert einer Abhängigkeitseigenschaft fest, ohne die Wertquelle zu ändern. (Geerbt von DependencyObject)
SetValue(DependencyProperty, Object)	Legt den lokalen Wert einer Abhängigkeitseigenschaft fest, die durch den Bezeichner der Abhängigkeitseigenschaft angegeben wird. (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 wird. (Geerbt von DependencyObject)
ShouldSerializeProperty(DependencyProperty)	Gibt einen Wert zurück, der angibt, ob Serialisierungsprozesse den Wert für die bereitgestellte Abhängigkeitseigenschaft serialisieren sollen. (Geerbt von DependencyObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
VerifyAccess()	Erzwingt, dass der aufrufende Thread Zugriff auf diese DispatcherObjecthat. (Geerbt von DispatcherObject)

Ereignisse

CopyingCellClipboardContent	Tritt auf, nachdem der Inhalt der Zellenablage vorbereitet wurde. (Geerbt von DataGridColumn)
PastingCellClipboardContent	Tritt auf, bevor der Inhalt der Zwischenablage in die Zelle verschoben wird. (Geerbt von DataGridColumn)

Gilt für:

Freigeben über