DataGridViewColumnCollection Class
Represents a collection of DataGridViewColumn objects in a DataGridView control.
System.MarshalByRefObject
System.Windows.Forms.BaseCollection
System.Windows.Forms.DataGridViewColumnCollection
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
The DataGridViewColumnCollection type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | DataGridViewColumnCollection | Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView. |
| Name | Description | |
|---|---|---|
![]() | Count | Gets the total number of elements in the collection. (Inherited from BaseCollection.) |
![]() | DataGridView | Gets the DataGridView upon which the collection performs column-related operations. |
![]() | IsReadOnly | Gets a value indicating whether the collection is read-only. (Inherited from BaseCollection.) |
![]() | IsSynchronized | Gets a value indicating whether access to the ICollection is synchronized. (Inherited from BaseCollection.) |
![]() | Item[Int32] | Gets or sets the column at the given index in the collection. |
![]() | Item[String] | Gets or sets the column of the given name in the collection. |
![]() | List | Gets the list of elements contained in the BaseCollection instance. (Overrides BaseCollection.List.) |
![]() | SyncRoot | Gets an object that can be used to synchronize access to the BaseCollection. (Inherited from BaseCollection.) |
| Name | Description | |
|---|---|---|
![]() | Add(DataGridViewColumn) | Adds the given column to the collection. |
![]() | Add(String, String) | Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection. |
![]() | AddRange | Adds a range of columns to the collection. |
![]() | Clear | Clears the collection. |
![]() | Contains(DataGridViewColumn) | Determines whether the collection contains the given column. |
![]() | Contains(String) | Determines whether the collection contains the column referred to by the given name. |
![]() | CopyTo(Array, Int32) | Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index. (Inherited from BaseCollection.) |
![]() | CopyTo(DataGridViewColumn[], Int32) | Copies the items from the collection to the given array. |
![]() | CreateObjRef | Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from MarshalByRefObject.) |
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Inherited from Object.) |
![]() | Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.) |
![]() | GetColumnCount | Returns the number of columns that meet the given filter requirements. |
![]() | GetColumnsWidth | Returns the width, in pixels, required to display all of the columns that meet the given filter requirements. |
![]() | GetEnumerator | Gets the object that enables iterating through the members of the collection. (Inherited from BaseCollection.) |
![]() | GetFirstColumn(DataGridViewElementStates) | Returns the first column in display order that meets the given inclusion-filter requirements. |
![]() | GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates) | Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements. |
![]() | GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
![]() | GetLastColumn | Returns the last column in display order that meets the given filter requirements. |
![]() | GetLifetimeService | Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() | GetNextColumn | Gets the first column after the given column in display order that meets the given filter requirements. |
![]() | GetPreviousColumn | Gets the last column prior to the given column in display order that meets the given filter requirements. |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | IndexOf | Gets the index of the given DataGridViewColumn in the collection. |
![]() | InitializeLifetimeService | Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.) |
![]() | Insert | Inserts a column at the given index in the collection. |
![]() | MemberwiseClone() | Creates a shallow copy of the current Object. (Inherited from Object.) |
![]() | MemberwiseClone(Boolean) | Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.) |
![]() | OnCollectionChanged | Raises the CollectionChanged event. |
![]() | Remove(DataGridViewColumn) | Removes the specified column from the collection. |
![]() | Remove(String) | Removes the column with the specified name from the collection. |
![]() | RemoveAt | Removes the column at the given index in the collection. |
![]() | ToString | Returns a string that represents the current object. (Inherited from Object.) |
| Name | Description | |
|---|---|---|
![]() | AsParallel | Enables parallelization of a query. (Defined by ParallelEnumerable.) |
![]() | AsQueryable | Converts an IEnumerable to an IQueryable. (Defined by Queryable.) |
![]() | Cast<TResult> | Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.) |
![]() | OfType<TResult> | Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.) |
| Name | Description | |
|---|---|---|
![]() ![]() | ICollection.CopyTo | Infrastructure. Copies the entire contents of the collection to a compatible one-dimensional Array, starting at the specified index of the target array. |
![]() ![]() | ICollection.Count | Infrastructure. Gets the number of elements in the collection. |
![]() ![]() | ICollection.IsSynchronized | Infrastructure. Gets a value indicating whether access to the collection is synchronized. |
![]() ![]() | ICollection.SyncRoot | Infrastructure. Gets an object that can be used to synchronize access to the collection. |
![]() ![]() | IEnumerable.GetEnumerator | Infrastructure. Returns an enumerator that iterates through the collection. |
![]() ![]() | IList.Add | Infrastructure. Adds an object to the end of the collection. |
![]() ![]() | IList.Clear | Infrastructure. Removes all elements from the collection. |
![]() ![]() | IList.Contains | Infrastructure. Determines whether an object is in the collection. |
![]() ![]() | IList.IndexOf | Infrastructure. Determines the index of a specific item in the collection. |
![]() ![]() | IList.Insert | Infrastructure. Inserts an element into the collection at the specified index. |
![]() ![]() | IList.IsFixedSize | Infrastructure. Gets a value indicating whether the collection has a fixed size. |
![]() ![]() | IList.IsReadOnly | Infrastructure. Gets a value indicating whether the collection is read-only. |
![]() ![]() | IList.Item | Infrastructure. Gets or sets the element at the specified index. |
![]() ![]() | IList.Remove | Infrastructure. Removes the first occurrence of the specified object from the collection. |
![]() ![]() | IList.RemoveAt | Infrastructure. Removes the element with the specified index from the collection. |
You can retrieve an instance of this class through the Columns property of the DataGridView control. The collection maintains a reference to the control through the DataGridView property.
The following code example illustrates the use of this type.
private DataGridView dataGridView1 = new DataGridView(); private void AddColorColumn() { DataGridViewComboBoxColumn comboBoxColumn = new DataGridViewComboBoxColumn(); comboBoxColumn.Items.AddRange( Color.Red, Color.Yellow, Color.Green, Color.Blue); comboBoxColumn.ValueType = typeof(Color); dataGridView1.Columns.Add(comboBoxColumn); dataGridView1.EditingControlShowing += new DataGridViewEditingControlShowingEventHandler( dataGridView1_EditingControlShowing); } private void dataGridView1_EditingControlShowing(object sender, DataGridViewEditingControlShowingEventArgs e) { ComboBox combo = e.Control as ComboBox; if (combo != null) { // Remove an existing event-handler, if present, to avoid // adding multiple handlers when the editing control is reused. combo.SelectedIndexChanged -= new EventHandler(ComboBox_SelectedIndexChanged); // Add the event handler. combo.SelectedIndexChanged += new EventHandler(ComboBox_SelectedIndexChanged); } } private void ComboBox_SelectedIndexChanged(object sender, EventArgs e) { ((ComboBox)sender).BackColor = (Color)((ComboBox)sender).SelectedItem; }
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

