This documentation is archived and is not being maintained.

GridViewColumn Class

Represents a column that displays data.

Namespace:  System.Windows.Controls
Assembly:  PresentationFramework (in PresentationFramework.dll)

[LocalizabilityAttribute(LocalizationCategory.None, Readability = Readability.Unreadable)]
[StyleTypedPropertyAttribute(Property = "HeaderContainerStyle", StyleTargetType = typeof(GridViewColumnHeader))]
public class GridViewColumn : DependencyObject, 

The GridViewColumn type exposes the following members.

Public methodGridViewColumnInitializes a new instance of the GridViewColumn class.

Public propertyActualWidthGets the actual width of a GridViewColumn.
Public propertyCellTemplateGets or sets the template to use to display the contents of a column cell.
Public propertyCellTemplateSelectorGets or sets a DataTemplateSelector that determines the template to use to display cells in a column.
Public propertyDependencyObjectTypeGets the DependencyObjectType that wraps the CLR type of this instance.  (Inherited from DependencyObject.)
Public propertyDispatcherGets the Dispatcher this DispatcherObject is associated with. (Inherited from DispatcherObject.)
Public propertyDisplayMemberBindingGets or sets the data item to bind to for this column.
Public propertyHeaderGets or sets the content of the header of a GridViewColumn.
Public propertyHeaderContainerStyleGets or sets the style to use for the header of the GridViewColumn.
Public propertyHeaderStringFormatGets or sets a composite string that specifies how to format the Header property if it is displayed as a string.
Public propertyHeaderTemplateGets or sets the template to use to display the content of the column header.
Public propertyHeaderTemplateSelectorGets or sets the DataTemplateSelector that provides logic to select the template to use to display the column header.
Public propertyIsSealedGets a value that indicates whether this instance is currently sealed (read-only). (Inherited from DependencyObject.)
Public propertyWidthGets or sets the width of the column.

Public methodCheckAccessDetermines whether the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject.)
Public methodClearValue(DependencyProperty)Clears the local value of a property. The property to be cleared is specified by a DependencyProperty identifier. (Inherited from DependencyObject.)
Public methodClearValue(DependencyPropertyKey)Clears the local value of a read-only property. The property to be cleared is specified by a DependencyPropertyKey. (Inherited from DependencyObject.)
Public methodCoerceValueCoerces the value of the specified dependency property. This is accomplished by invoking any CoerceValueCallback function specified in property metadata for the dependency property as it exists on the calling DependencyObject. (Inherited from DependencyObject.)
Public methodEqualsDetermines whether a provided DependencyObject is equivalent to the current DependencyObject. (Inherited from DependencyObject.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeGets a hash code for this DependencyObject. (Inherited from DependencyObject.)
Public methodGetLocalValueEnumeratorCreates a specialized enumerator for determining which dependency properties have locally set values on this DependencyObject. (Inherited from DependencyObject.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodGetValueReturns the current effective value of a dependency property on this instance of a DependencyObject. (Inherited from DependencyObject.)
Public methodInvalidatePropertyRe-evaluates the effective value for the specified dependency property (Inherited from DependencyObject.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Protected methodOnHeaderStringFormatChangedOccurs when the HeaderStringFormat property changes.
Protected methodOnPropertyChanged(DependencyPropertyChangedEventArgs)Invoked whenever the effective value of any dependency property on this DependencyObject has been updated. The specific dependency property that changed is reported in the event data. (Inherited from DependencyObject.)
Protected methodOnPropertyChanged(PropertyChangedEventArgs)Raises the INotifyPropertyChanged.PropertyChanged event.
Public methodReadLocalValueReturns the local value of a dependency property, if it exists. (Inherited from DependencyObject.)
Public methodSetCurrentValueSets the value of a dependency property without changing its value source. (Inherited from DependencyObject.)
Public methodSetValue(DependencyProperty, Object)Sets the local value of a dependency property, specified by its dependency property identifier. (Inherited from DependencyObject.)
Public methodSetValue(DependencyPropertyKey, Object)Sets the local value of a read-only dependency property, specified by the DependencyPropertyKey identifier of the dependency property. (Inherited from DependencyObject.)
Protected methodShouldSerializePropertyReturns a value that indicates whether serialization processes should serialize the value for the provided dependency property. (Inherited from DependencyObject.)
Public methodToStringCreates a string representation of the GridViewColumn. (Overrides Object.ToString().)
Public methodVerifyAccessEnforces that the calling thread has access to this DispatcherObject. (Inherited from DispatcherObject.)

Public fieldStatic memberCellTemplatePropertyIdentifies the CellTemplate dependency property.
Public fieldStatic memberCellTemplateSelectorPropertyIdentifies the CellTemplateSelector dependency property.
Public fieldStatic memberHeaderContainerStylePropertyIdentifies the HeaderContainerStyle dependency property.
Public fieldStatic memberHeaderPropertyIdentifies the Header dependency property.
Public fieldStatic memberHeaderStringFormatPropertyIdentifies the HeaderStringFormat dependency property.
Public fieldStatic memberHeaderTemplatePropertyIdentifies the HeaderTemplate dependency property.
Public fieldStatic memberHeaderTemplateSelectorPropertyIdentifies the HeaderTemplateSelector dependency property.
Public fieldStatic memberWidthPropertyIdentifies the Width dependency property.

Explicit interface implemetationPrivate eventINotifyPropertyChanged.PropertyChangedOccurs when the value of any GridViewColumn property changes.

A GridViewColumn is used by the GridView view mode to display a column of data. The ListView that implements the GridView view mode provides the data for the column. You use data binding to specify the data for the GridViewColumn.

You can use the DisplayMemberBinding property to define the data to display in a column. You can also define the data as part of a DataTemplate that is specified by the CellTemplate property. If different cells have different DataTemplate objects, the CellTemplateSelector property can specify a DataTemplateSelector. The following list shows the properties mentioned here, in their order of precedence from highest to lowest:

The GridViewColumn class also contains properties that you can use to define and customize the column header for the column. The Header property can define the content of the column header. Other properties such as HeaderTemplate and HeaderContainerStyle can also specify content and style for the column header. Some of these properties are also found on other classes such as the GridViewColumnHeader class. For more information about the properties that are used to define styles and templates for column headers, and for information about the order of precedence for these properties, see GridView Column Header Styles and Templates Overview.

The GridViewColumn class implements the INotifyPropertyChanged interface. This interface provides the ability to subscribe to the events that occur when a change occurs to a property value, such as the ActualWidth property value.

The following example shows how to define GridViewColumn objects for a GridView.

<ListView ItemsSource="{Binding Source={StaticResource EmployeeData}, 
      <GridViewColumn Header="First Name"
               DisplayMemberBinding="{Binding XPath=FirstName}" />
      <GridViewColumn Header="Last Name"  
               CellTemplate="{StaticResource LastNameCellTemplate}"/>
      <GridViewColumn Header="Favorite City" 

More Code

How to: Display ListView Contents by Using a GridViewThis example shows how to define a GridView view mode for a ListView control.
How to: Use Templates to Style a ListView That Uses GridViewThis example shows how to use the DataTemplate and Style objects to specify the appearance of a ListView control that uses a GridView view mode.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.