DataGridViewColumnCollection Klasa

Definicja

Reprezentuje kolekcję DataGridViewColumn obiektów w DataGridView kontrolce.Represents a collection of DataGridViewColumn objects in a DataGridView control.

public ref class DataGridViewColumnCollection : System::Windows::Forms::BaseCollection, System::Collections::IList
[System.ComponentModel.ListBindable(false)]
public class DataGridViewColumnCollection : System.Windows.Forms.BaseCollection, System.Collections.IList
[<System.ComponentModel.ListBindable(false)>]
type DataGridViewColumnCollection = class
    inherit BaseCollection
    interface IList
    interface ICollection
    interface IEnumerable
Public Class DataGridViewColumnCollection
Inherits BaseCollection
Implements IList
Dziedziczenie
DataGridViewColumnCollection
Atrybuty
Implementuje

Przykłady

Poniższy przykład kodu ilustruje użycie tego typu.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;
}
Private WithEvents dataGridView1 As New DataGridView()

Private Sub AddColorColumn()

    Dim comboBoxColumn As New DataGridViewComboBoxColumn()
    comboBoxColumn.Items.AddRange( _
        Color.Red, Color.Yellow, Color.Green, Color.Blue)
    comboBoxColumn.ValueType = GetType(Color)
    dataGridView1.Columns.Add(comboBoxColumn)

End Sub

Private Sub dataGridView1_EditingControlShowing(ByVal sender As Object, _
    ByVal e As DataGridViewEditingControlShowingEventArgs) _
    Handles dataGridView1.EditingControlShowing

    Dim combo As ComboBox = CType(e.Control, ComboBox)
    If (combo IsNot Nothing) Then

        ' Remove an existing event-handler, if present, to avoid 
        ' adding multiple handlers when the editing control is reused.
        RemoveHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

        ' Add the event handler. 
        AddHandler combo.SelectedIndexChanged, _
            New EventHandler(AddressOf ComboBox_SelectedIndexChanged)

    End If

End Sub

Private Sub ComboBox_SelectedIndexChanged( _
    ByVal sender As Object, ByVal e As EventArgs)

    Dim comboBox1 As ComboBox = CType(sender, ComboBox)
    comboBox1.BackColor = _
        CType(CType(sender, ComboBox).SelectedItem, Color)

End Sub

Uwagi

Wystąpienie tej klasy można pobrać za pomocą Columns właściwości DataGridView kontrolki.You can retrieve an instance of this class through the Columns property of the DataGridView control. Kolekcja zachowuje odwołanie do kontrolki za pomocą DataGridView właściwości.The collection maintains a reference to the control through the DataGridView property.

Konstruktory

DataGridViewColumnCollection(DataGridView)

Inicjuje nowe wystąpienie DataGridViewColumnCollection klasy dla danego elementu DataGridView .Initializes a new instance of the DataGridViewColumnCollection class for the given DataGridView.

Właściwości

Count

Pobiera łączną liczbę elementów w kolekcji.Gets the total number of elements in the collection.

(Odziedziczone po BaseCollection)
DataGridView

Pobiera, na DataGridView którym kolekcja wykonuje operacje związane z kolumnami.Gets the DataGridView upon which the collection performs column-related operations.

IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.Gets a value indicating whether the collection is read-only.

(Odziedziczone po BaseCollection)
IsSynchronized

Pobiera wartość wskazującą, czy dostęp do programu ICollection jest synchronizowany.Gets a value indicating whether access to the ICollection is synchronized.

(Odziedziczone po BaseCollection)
Item[Int32]

Pobiera lub ustawia kolumnę pod podanym indeksem w kolekcji.Gets or sets the column at the given index in the collection.

Item[String]

Pobiera lub ustawia kolumnę danej nazwy w kolekcji.Gets or sets the column of the given name in the collection.

List

Pobiera listę elementów zawartych w BaseCollection wystąpieniu.Gets the list of elements contained in the BaseCollection instance.

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do BaseCollection .Gets an object that can be used to synchronize access to the BaseCollection.

(Odziedziczone po BaseCollection)

Metody

Add(DataGridViewColumn)

Dodaje daną kolumnę do kolekcji.Adds the given column to the collection.

Add(String, String)

Dodaje DataGridViewTextBoxColumn do kolekcji nazwę kolumny i tekst nagłówka kolumny.Adds a DataGridViewTextBoxColumn with the given column name and column header text to the collection.

AddRange(DataGridViewColumn[])

Dodaje zakres kolumn do kolekcji.Adds a range of columns to the collection.

Clear()

Czyści kolekcję.Clears the collection.

Contains(DataGridViewColumn)

Określa, czy kolekcja zawiera daną kolumnę.Determines whether the collection contains the given column.

Contains(String)

Określa, czy kolekcja zawiera kolumnę, do której odwołuje się podaną nazwę.Determines whether the collection contains the column referred to by the given name.

CopyTo(Array, Int32)

Kopiuje wszystkie elementy z prądu jednowymiarowego Array do określonego, Array rozpoczynając od określonego Array indeksu docelowego.Copies all the elements of the current one-dimensional Array to the specified one-dimensional Array starting at the specified destination Array index.

(Odziedziczone po BaseCollection)
CopyTo(DataGridViewColumn[], Int32)

Kopiuje elementy z kolekcji do danej tablicy.Copies the items from the collection to the given array.

CreateObjRef(Type)

Tworzy obiekt, który zawiera wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikacji z obiektem zdalnym.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Odziedziczone po MarshalByRefObject)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetColumnCount(DataGridViewElementStates)

Zwraca liczbę kolumn, które spełniają określone wymagania dotyczące filtru.Returns the number of columns that meet the given filter requirements.

GetColumnsWidth(DataGridViewElementStates)

Zwraca szerokość (w pikselach), która jest wymagana do wyświetlenia wszystkich kolumn spełniających określone wymagania dotyczące filtru.Returns the width, in pixels, required to display all of the columns that meet the given filter requirements.

GetEnumerator()

Pobiera obiekt, który umożliwia wykonywanie iteracji przez elementy członkowskie kolekcji.Gets the object that enables iterating through the members of the collection.

(Odziedziczone po BaseCollection)
GetFirstColumn(DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia określone wymagania dotyczące filtru dołączania.Returns the first column in display order that meets the given inclusion-filter requirements.

GetFirstColumn(DataGridViewElementStates, DataGridViewElementStates)

Zwraca pierwszą kolumnę w kolejności wyświetlania, która spełnia określone wymagania dotyczące filtru dołączania i wykluczania.Returns the first column in display order that meets the given inclusion-filter and exclusion-filter requirements.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetLastColumn(DataGridViewElementStates, DataGridViewElementStates)

Zwraca ostatnią kolumnę w kolejności wyświetlania, która spełnia określone wymagania dotyczące filtru.Returns the last column in display order that meets the given filter requirements.

GetLifetimeService()
Nieaktualne.

Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
GetNextColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Pobiera pierwszą kolumnę po danej kolumnie w kolejności wyświetlania, która spełnia określone wymagania dotyczące filtru.Gets the first column after the given column in display order that meets the given filter requirements.

GetPreviousColumn(DataGridViewColumn, DataGridViewElementStates, DataGridViewElementStates)

Pobiera ostatnią kolumnę przed daną kolumną w kolejności wyświetlania, która spełnia określone wymagania dotyczące filtru.Gets the last column prior to the given column in display order that meets the given filter requirements.

GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(DataGridViewColumn)

Pobiera indeks danego elementu DataGridViewColumn w kolekcji.Gets the index of the given DataGridViewColumn in the collection.

InitializeLifetimeService()
Nieaktualne.

Uzyskuje obiekt usługi istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia.Obtains a lifetime service object to control the lifetime policy for this instance.

(Odziedziczone po MarshalByRefObject)
Insert(Int32, DataGridViewColumn)

Wstawia w kolekcji kolumnę o podanym indeksie.Inserts a column at the given index in the collection.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
MemberwiseClone(Boolean)

Tworzy skróconą kopię bieżącego MarshalByRefObject obiektu.Creates a shallow copy of the current MarshalByRefObject object.

(Odziedziczone po MarshalByRefObject)
OnCollectionChanged(CollectionChangeEventArgs)

Podnosi CollectionChanged zdarzenie.Raises the CollectionChanged event.

Remove(DataGridViewColumn)

Usuwa określoną kolumnę z kolekcji.Removes the specified column from the collection.

Remove(String)

Usuwa z kolekcji kolumnę o określonej nazwie.Removes the column with the specified name from the collection.

RemoveAt(Int32)

Usuwa kolumnę z danego indeksu w kolekcji.Removes the column at the given index in the collection.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Zdarzenia

CollectionChanged

Występuje po zmianie kolekcji.Occurs when the collection changes.

Jawne implementacje interfejsu

ICollection.CopyTo(Array, Int32)

Kopiuje całą zawartość kolekcji do zgodnego jednowymiarowego Array , rozpoczynając od określonego indeksu tablicy docelowej.Copies the entire contents of the collection to a compatible one-dimensional Array, starting at the specified index of the target array.

ICollection.Count

Pobiera liczbę elementów w kolekcji.Gets the number of elements in the collection.

ICollection.IsSynchronized

Pobiera wartość wskazującą, czy dostęp do kolekcji jest synchronizowany.Gets a value indicating whether access to the collection is synchronized.

ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji.Gets an object that can be used to synchronize access to the collection.

IEnumerable.GetEnumerator()

Zwraca moduł wyliczający, który iteruje po kolekcji.Returns an enumerator that iterates through the collection.

IList.Add(Object)

Dodaje obiekt na końcu kolekcji.Adds an object to the end of the collection.

IList.Clear()

Usuwa wszystkie elementy z kolekcji.Removes all elements from the collection.

IList.Contains(Object)

Określa, czy obiekt znajduje się w kolekcji.Determines whether an object is in the collection.

IList.IndexOf(Object)

Określa indeks określonego elementu w kolekcji.Determines the index of a specific item in the collection.

IList.Insert(Int32, Object)

Wstawia element do kolekcji w określonym indeksie.Inserts an element into the collection at the specified index.

IList.IsFixedSize

Pobiera wartość wskazującą, czy kolekcja ma stały rozmiar.Gets a value indicating whether the collection has a fixed size.

IList.IsReadOnly

Pobiera wartość wskazującą, czy kolekcja jest przeznaczona tylko do odczytu.Gets a value indicating whether the collection is read-only.

IList.Item[Int32]

Pobiera lub ustawia element pod określonym indeksem.Gets or sets the element at the specified index.

IList.Remove(Object)

Usuwa pierwsze wystąpienie określonego obiektu z kolekcji.Removes the first occurrence of the specified object from the collection.

IList.RemoveAt(Int32)

Usuwa element z określonym indeksem z kolekcji.Removes the element with the specified index from the collection.

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też