DataGridTemplateColumn Classe

Definizione

Rappresenta una colonna DataGrid che ospita nelle celle il contenuto specificato dal modello.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
Ereditarietà

Esempio

Nell'esempio riportato di seguito viene illustrato come creare un oggetto DataGridTemplateColumn.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>

La figura seguente mostra l'output del codice XAML precedente.The following illustration shows the output from the previous XAML.

Colonna con DataTemplateA column using a DataTemplate

Commenti

Il DataGridTemplateColumn tipo consente di creare tipi di colonna personalizzati specificando i modelli di cella da utilizzare per la visualizzazione e la modifica dei valori.The DataGridTemplateColumn type enables you to create your own column types by specifying the cell templates to use when displaying and editing values. Per specificare il modello utilizzato per visualizzare il contenuto di una cella che non si trova in modalità di modifica, impostare la CellTemplate Proprietà.To specify the template that is used to display the contents of a cell that is not in editing mode, set the CellTemplate property. Per specificare il modello utilizzato per visualizzare il contenuto di una cella in modalità di modifica, impostare la CellEditingTemplate Proprietà.To specify the template that is used to display the contents of a cell that is in editing mode, set the CellEditingTemplate property. Per ulteriori informazioni sui modelli, vedere Cenni preliminari sui modelli di dati e applicazione di stili e modelli.For more information about templates, see Data Templating Overview and Styling and Templating.

Per praticità, in DataGrid sono disponibili i tipi di colonna predefiniti seguenti:For convenience, DataGrid provides the following pre-defined column types:

Tipo di colonnaColumn Type Visualizzazione dei datiData Display
DataGridHyperlinkColumn Usare per visualizzare i dati URI.Use to display URI data.
DataGridComboBoxColumn Utilizzare per visualizzare i dati di enumerazione.Use to display enumeration data.
DataGridTextColumn Usare per visualizzare il testo.Use to display text.
DataGridCheckBoxColumn Usare per visualizzare i dati booleani.Use to display Boolean data.

Costruttori

DataGridTemplateColumn()

Inizializza una nuova istanza della classe DataGridTemplateColumn.Initializes a new instance of the DataGridTemplateColumn class.

Campi

CellEditingTemplateProperty

Identifica la proprietà di dipendenza CellEditingTemplate.Identifies the CellEditingTemplate dependency property.

CellEditingTemplateSelectorProperty

Identifica la proprietà di dipendenza CellEditingTemplateSelector.Identifies the CellEditingTemplateSelector dependency property.

CellTemplateProperty

Identifica la proprietà di dipendenza CellTemplate.Identifies the CellTemplate dependency property.

CellTemplateSelectorProperty

Identifica la proprietà di dipendenza CellEditingTemplateSelector.Identifies the CellEditingTemplateSelector dependency property.

Proprietà

ActualWidth

Ottiene la larghezza corrente della colonna in unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit).Gets the current width of the column, in unità indipendenti dal dispositivo (1/96 di pollice per unità)device-independent units (1/96th inch per unit).

(Ereditato da DataGridColumn)
CanUserReorder

Recupera o imposta un valore che indica se l'utente può modificare la posizione di visualizzazione delle colonne trascinando le intestazioni delle colonne.Gets or sets a value that indicates whether the user can change the column display position by dragging the column header.

(Ereditato da DataGridColumn)
CanUserResize

Ottiene o imposta un valore che indica se l'utente può regolare la larghezza delle colonne utilizzando il mouse.Gets or sets a value that indicates whether the user can adjust the column width by using the mouse.

(Ereditato da DataGridColumn)
CanUserSort

Recupera o imposta un valore che indica se l'utente può ordinare la colonna facendo clic sull'intestazione.Gets or sets a value that indicates whether the user can sort the column by clicking the column header.

(Ereditato da DataGridColumn)
CellEditingTemplate

Ottiene o imposta il modello da utilizzare per visualizzare il contenuto di una cella in modalità di modifica.Gets or sets the template to use to display the contents of a cell that is in editing mode.

CellEditingTemplateSelector

Ottiene o imposta l'oggetto che determina il modello da utilizzare per visualizzare il contenuto di una cella che si trova in modalità di modifica.Gets or sets the object that determines which template to use to display the contents of a cell that is in editing mode.

CellStyle

Ottiene o imposta lo stile utilizzato per il rendering delle celle nella colonna.Gets or sets the style that is used to render cells in the column.

(Ereditato da DataGridColumn)
CellTemplate

Ottiene o imposta il modello da utilizzare per visualizzare il contenuto di una cella che non si trova in modalità di modifica.Gets or sets the template to use to display the contents of a cell that is not in editing mode.

CellTemplateSelector

Ottiene o imposta l'oggetto che determina il modello da utilizzare per visualizzare il contenuto di una cella che non si trova in modalità di modifica.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

Ottiene o imposta l'oggetto di associazione da utilizzare quando si ottiene o si imposta il contenuto della cella per gli Appunti.Gets or sets the binding object to use when getting or setting cell content for the clipboard.

(Ereditato da DataGridColumn)
DataGridOwner

Ottiene il controllo DataGrid che contiene questa colonna.Gets the DataGrid control that contains this column.

(Ereditato da DataGridColumn)
DependencyObjectType

Ottiene la classe DependencyObjectType che include il tipo CLRCLR di questa istanza.Gets the DependencyObjectType that wraps the CLRCLR type of this instance.

(Ereditato da DependencyObject)
Dispatcher

Ottiene l'oggetto Dispatcher associato a DispatcherObject.Gets the Dispatcher this DispatcherObject is associated with.

(Ereditato da DispatcherObject)
DisplayIndex

Ottiene o imposta la posizione di visualizzazione della colonna relativa alle altre colonne presenti nell'oggetto DataGrid.Gets or sets the display position of the column relative to the other columns in the DataGrid.

(Ereditato da DataGridColumn)
DragIndicatorStyle

Ottiene o imposta l'oggetto stile da applicare all'intestazione di colonna durante un'operazione di trascinamento.Gets or sets the style object to apply to the column header during a drag operation.

(Ereditato da DataGridColumn)
Header

Recupera o imposta il contenuto dell'intestazione della colonna.Gets or sets the content of the column header.

(Ereditato da DataGridColumn)
HeaderStringFormat

Ottiene o imposta il modello di formato da applicare al contenuto dell'intestazione di colonna.Gets or sets the format pattern to apply to the content of the column header.

(Ereditato da DataGridColumn)
HeaderStyle

Ottiene o imposta lo stile utilizzato per il rendering dell'intestazione di colonna.Gets or sets the style that is used when rendering the column header.

(Ereditato da DataGridColumn)
HeaderTemplate

Ottiene o imposta il modello che definisce la rappresentazione visiva dell'intestazione di colonna.Gets or sets the template that defines the visual representation of the column header.

(Ereditato da DataGridColumn)
HeaderTemplateSelector

Ottiene o imposta l'oggetto che consente la selezione del modello da utilizzare per l'intestazione di colonna.Gets or sets the object that selects which template to use for the column header.

(Ereditato da DataGridColumn)
IsAutoGenerated

Ottiene un valore che indica se la colonna viene generata automaticamente.Gets a value that indicates whether the column is auto-generated.

(Ereditato da DataGridColumn)
IsFrozen

Ottiene un valore che indica se non è possibile scorrere la colonna orizzontalmente.Gets a value that indicates whether the column is prevented from scrolling horizontally.

(Ereditato da DataGridColumn)
IsReadOnly

Recupera o imposta un valore che indica se è possibile modificare le celle nella colonna.Gets or sets a value that indicates whether cells in the column can be edited.

(Ereditato da DataGridColumn)
IsSealed

Ottiene un valore che indica se l'istanza è attualmente sealed (di sola lettura).Gets a value that indicates whether this instance is currently sealed (read-only).

(Ereditato da DependencyObject)
MaxWidth

Ottiene o imposta il vincolo di larghezza massima della colonna.Gets or sets the maximum width constraint of the column.

(Ereditato da DataGridColumn)
MinWidth

Ottiene o imposta il vincolo di larghezza minima della colonna.Gets or sets the minimum width constraint of the column.

(Ereditato da DataGridColumn)
SortDirection

Ottiene o imposta il tipo di ordinamento (crescente o decrescente) della colonna.Gets or sets the sort direction (ascending or descending) of the column.

(Ereditato da DataGridColumn)
SortMemberPath

Recupera o imposta un nome di proprietà o una gerarchia di nomi di proprietà separati da punti, che indica il membro in base al quale eseguire l'ordinamento.Gets or sets a property name, or a period-delimited hierarchy of property names, that indicates the member to sort by.

(Ereditato da DataGridColumn)
Visibility

Recupera o imposta la visibilità della colonna.Gets or sets the visibility of the column.

(Ereditato da DataGridColumn)
Width

Recupera o imposta la larghezza della colonna o la modalità di ridimensionamento automatico.Gets or sets the column width or automatic sizing mode.

(Ereditato da DataGridColumn)

Metodi

CancelCellEdit(FrameworkElement, Object)

Provoca la modifica della cella per ripristinare il valore originale, non modificato.Causes the cell being edited to revert to the original, unedited value.

(Ereditato da DataGridColumn)
CheckAccess()

Determina se il thread chiamante ha accesso a DispatcherObject.Determines whether the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)
ClearValue(DependencyProperty)

Cancella il valore locale di una proprietà.Clears the local value of a property. La proprietà da cancellare è specificata da un identificatore DependencyProperty.The property to be cleared is specified by a DependencyProperty identifier.

(Ereditato da DependencyObject)
ClearValue(DependencyPropertyKey)

Cancella il valore locale di una proprietà di sola lettura.Clears the local value of a read-only property. La proprietà da cancellare è specificata da un oggetto DependencyPropertyKey.The property to be cleared is specified by a DependencyPropertyKey.

(Ereditato da DependencyObject)
CoerceValue(DependencyProperty)

Assegna forzatamente il valore della proprietà di dipendenza specificata.Coerces the value of the specified dependency property. Questa operazione viene eseguita richiamando qualsiasi funzione CoerceValueCallback specificata nei metadati della proprietà di dipendenza esistente nell'oggetto DependencyObject chiamante.This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject.

(Ereditato da DependencyObject)
CommitCellEdit(FrameworkElement)

Esegue una convalida richiesta prima di uscire dalla modalità di modifica delle celle.Performs any required validation before exiting cell editing mode.

(Ereditato da DataGridColumn)
Equals(Object)

Determina se l'oggetto DependencyObject specificato equivale all'oggetto DependencyObject corrente.Determines whether a provided DependencyObject is equivalent to the current DependencyObject.

(Ereditato da DependencyObject)
GenerateEditingElement(DataGridCell, Object)

Ottiene un elemento definito dall'oggetto CellEditingTemplate associato al valore della proprietà Binding della colonna.Gets an element defined by the CellEditingTemplate that is bound to the column's Binding property value.

GenerateElement(DataGridCell, Object)

Ottiene un elemento definito dall'oggetto CellTemplate associato al valore della proprietà Binding della colonna.Gets an element defined by the CellTemplate that is bound to the column's Binding property value.

GetCellContent(DataGridRow)

Recupera il valore della proprietà Content per la cella in corrispondenza dell'intersezione della colonna e della riga specificata.Retrieves the Content property value for the cell at the intersection of this column and the specified row.

(Ereditato da DataGridColumn)
GetCellContent(Object)

Ottiene il valore della proprietà Content per la cella in corrispondenza dell'intersezione della colonna e della riga che rappresenta l'elemento dati specificato.Gets the Content property value for the cell at the intersection of this column and the row that represents the specified data item.

(Ereditato da DataGridColumn)
GetHashCode()

Ottiene un codice hash per l'oggetto DependencyObject.Gets a hash code for this DependencyObject.

(Ereditato da DependencyObject)
GetLocalValueEnumerator()

Crea un enumeratore specializzato per determinare le proprietà di dipendenza che presentano valori impostati localmente nell'oggetto DependencyObject.Creates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject.

(Ereditato da DependencyObject)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
GetValue(DependencyProperty)

Restituisce il valore effettivo corrente di una proprietà di dipendenza in questa istanza di DependencyObject.Returns the current effective value of a dependency property on this instance of a DependencyObject.

(Ereditato da DependencyObject)
InvalidateProperty(DependencyProperty)

Valuta di nuovo il valore effettivo della proprietà di dipendenza specificata.Re-evaluates the effective value for the specified dependency property.

(Ereditato da DependencyObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
NotifyPropertyChanged(String)

Notifica all'oggetto DataGrid che contiene questa colonna che una proprietà della colonna è stata modificata.Notifies the DataGrid that contains this column that a column property has changed.

(Ereditato da DataGridColumn)
OnCoerceIsReadOnly(Boolean)

Determina il valore della proprietà IsReadOnly in base alle regole della proprietà della DataGrid che contiene questa colonna.Determines the value of the IsReadOnly property based on the property rules of the DataGrid that contains this column.

(Ereditato da DataGridColumn)
OnCopyingCellClipboardContent(Object)

Genera l'evento CopyingCellClipboardContent.Raises the CopyingCellClipboardContent event.

(Ereditato da DataGridColumn)
OnPastingCellClipboardContent(Object, Object)

Genera l'evento PastingCellClipboardContent.Raises the PastingCellClipboardContent event.

(Ereditato da DataGridColumn)
OnPropertyChanged(DependencyPropertyChangedEventArgs)

Richiamato ogni volta che viene aggiornato il valore effettivo di qualsiasi proprietà di dipendenza in DependencyObject.Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. La proprietà di dipendenza specifica modificata viene indicata nei dati dell'evento.The specific dependency property that changed is reported in the event data.

(Ereditato da DependencyObject)
PrepareCellForEdit(FrameworkElement, RoutedEventArgs)

Quando è sottoposto a override in una classe derivata, imposta il contenuto della cella in base alle necessità per la modifica.When overridden in a derived class, sets cell content as needed for editing.

(Ereditato da DataGridColumn)
ReadLocalValue(DependencyProperty)

Restituisce il valore locale di una proprietà di dipendenza, se esistente.Returns the local value of a dependency property, if it exists.

(Ereditato da DependencyObject)
RefreshCellContent(FrameworkElement, String)

Aggiorna il contenuto di una cella della colonna in risposta alla modifica di un valore della proprietà del modello.Refreshes the contents of a cell in the column in response to a template property value change.

SetCurrentValue(DependencyProperty, Object)

Imposta il valore di una proprietà di dipendenza senza modificare l'origine del valore.Sets the value of a dependency property without changing its value source.

(Ereditato da DependencyObject)
SetValue(DependencyProperty, Object)

Imposta il valore locale di una proprietà di dipendenza, specificato dal relativo identificatore della proprietà di dipendenza.Sets the local value of a dependency property, specified by its dependency property identifier.

(Ereditato da DependencyObject)
SetValue(DependencyPropertyKey, Object)

Imposta il valore locale di una proprietà di dipendenza di sola lettura, specificato dall'identificatore DependencyPropertyKey della proprietà di dipendenza.Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property.

(Ereditato da DependencyObject)
ShouldSerializeProperty(DependencyProperty)

Restituisce un valore che indica se i processi di serializzazione devono serializzare il valore della proprietà di dipendenza specificata.Returns a value that indicates whether serialization processes should serialize the value for the provided dependency property.

(Ereditato da DependencyObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
VerifyAccess()

Impone che il thread chiamante abbia accesso a DispatcherObject.Enforces that the calling thread has access to this DispatcherObject.

(Ereditato da DispatcherObject)

Eventi

CopyingCellClipboardContent

Si verifica dopo la preparazione del contenuto degli Appunti della cella.Occurs after the cell clipboard content is prepared.

(Ereditato da DataGridColumn)
PastingCellClipboardContent

Si verifica prima dello spostamento del contenuto degli Appunti nella cella.Occurs before the clipboard content is moved to the cell.

(Ereditato da DataGridColumn)

Si applica a

Vedi anche