Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

DataGridViewSelectedColumnCollection Class

.NET Framework 4

Represents a collection of DataGridViewColumn objects that are selected in a DataGridView.

System.Object
  System.MarshalByRefObject
    System.Windows.Forms.BaseCollection
      System.Windows.Forms.DataGridViewSelectedColumnCollection

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)
C#
C++
F#
VB
Copy 
[ListBindableAttribute(false)]
public class DataGridViewSelectedColumnCollection : BaseCollection, 
	IList, ICollection, IEnumerable

The DataGridViewSelectedColumnCollection type exposes the following members.

  Name Description
Public property Count Gets the total number of elements in the collection. (Inherited from BaseCollection.)
Public property IsReadOnly Gets a value indicating whether the collection is read-only. (Inherited from BaseCollection.)
Public property IsSynchronized Gets a value indicating whether access to the ICollection is synchronized. (Inherited from BaseCollection.)
Public property Item Gets the column at the specified index.
Protected property List Gets the list of elements contained in the BaseCollection instance. (Overrides BaseCollection.List.)
Public property SyncRoot Gets an object that can be used to synchronize access to the BaseCollection. (Inherited from BaseCollection.)
Top
  Name Description
Public method Clear Infrastructure. Clears the collection.
Public method Contains Determines whether the specified column is contained in the collection.
Public method 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.)
Public method CopyTo(DataGridViewColumn[], Int32) Copies the elements of the collection to the specified array, starting at the specified index.
Public method 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.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetEnumerator Gets the object that enables iterating through the members of the collection. (Inherited from BaseCollection.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetLifetimeService Retrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Public method InitializeLifetimeService Obtains a lifetime service object to control the lifetime policy for this instance. (Inherited from MarshalByRefObject.)
Public method Insert Infrastructure. Inserts a column into the collection at the specified position.
Protected method MemberwiseClone() Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method MemberwiseClone(Boolean) Creates a shallow copy of the current MarshalByRefObject object. (Inherited from MarshalByRefObject.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top
  Name Description
Public Extension Method AsParallel Enables parallelization of a query. (Defined by ParallelEnumerable.)
Public Extension Method AsQueryable Converts an IEnumerable to an IQueryable. (Defined by Queryable.)
Public Extension Method Cast<TResult> Casts the elements of an IEnumerable to the specified type. (Defined by Enumerable.)
Public Extension Method OfType<TResult> Filters the elements of an IEnumerable based on a specified type. (Defined by Enumerable.)
Top
  Name Description
Explicit interface implemetation Private method ICollection.CopyTo Copies the elements of the collection to the specified array, starting at the specified index.
Explicit interface implemetation Private property ICollection.Count Gets the number of elements in the collection.
Explicit interface implemetation Private property ICollection.IsSynchronized Infrastructure. Gets a value indicating whether access to the collection is synchronized (thread safe).
Explicit interface implemetation Private property ICollection.SyncRoot Gets an object that can be used to synchronize access to the collection.
Explicit interface implemetation Private method IEnumerable.GetEnumerator Returns an enumerator that iterates through a collection.
Explicit interface implemetation Private method IList.Add Infrastructure. Implements the IList.Add method. Always throws NotSupportedException.
Explicit interface implemetation Private method IList.Clear Infrastructure. Implements the IList.Clear method. Always throws NotSupportedException.
Explicit interface implemetation Private method IList.Contains Determines whether the specified value is contained in the collection.
Explicit interface implemetation Private method IList.IndexOf Returns the index of the specified element.
Explicit interface implemetation Private method IList.Insert Infrastructure. Implements the IList.Insert method. Always throws NotSupportedException.
Explicit interface implemetation Private property IList.IsFixedSize Infrastructure. Gets a value indicating whether the collection has a fixed size.
Explicit interface implemetation Private property IList.IsReadOnly Infrastructure. Gets a value indicating whether the collection is read-only.
Explicit interface implemetation Private property IList.Item Infrastructure. Gets the element at the specified index.
Explicit interface implemetation Private method IList.Remove Implements the Remove method. Always throws NotSupportedException.
Explicit interface implemetation Private method IList.RemoveAt Infrastructure. Implements the RemoveAt method. Always throws NotSupportedException.
Top

The order of columns in the collection is not guaranteed to match the order in which they were selected.

The DataGridViewSelectedColumnCollection does not perform efficiently when working with large numbers of columns. Typically, DataGridView controls will not contain enough columns for this to be an issue, but if you are working with large numbers of columns, you can use the DataGridView.AreAllCellsSelected to determine if the entire grid is selected, or you can use the DataGridViewColumnCollection.GetColumnCount to determine the number of selected columns (or the number of columns in a specified state). For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, 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.
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ