DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs
Källa:
DataGridViewColumnCollection.cs

Lägger till ett intervall med kolumner i samlingen.

public:
 virtual void AddRange(... cli::array <System::Windows::Forms::DataGridViewColumn ^> ^ dataGridViewColumns);
public virtual void AddRange(params System.Windows.Forms.DataGridViewColumn[] dataGridViewColumns);
abstract member AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
override this.AddRange : System.Windows.Forms.DataGridViewColumn[] -> unit
Public Overridable Sub AddRange (ParamArray dataGridViewColumns As DataGridViewColumn())

Parametrar

dataGridViewColumns
DataGridViewColumn[]

En matris med DataGridViewColumn objekt att lägga till.

Undantag

ArgumentNullException

dataGridViewColumns är null.

InvalidOperationException

Den associerade DataGridView kontrollen utför någon av följande åtgärder som tillfälligt förhindrar att nya kolumner läggs till:

  • Markera alla celler i kontrollen.

  • Rensa markeringen.

  • Uppdaterar kolumnegenskapsvärden DisplayIndex .

-eller-

Den här metoden anropas från en hanterare för någon av följande DataGridView händelser:

-eller-

Minst ett av värdena i dataGridViewColumns är null.

-eller-

Minst en av kolumnerna i dataGridViewColumns tillhör redan en DataGridView kontroll.

-eller-

Minst en av kolumnerna i dataGridViewColumns har ett CellType egenskapsvärde null och DataGridView kontrollen innehåller minst en rad.

-eller-

Minst en av kolumnerna i dataGridViewColumns har ett SortMode egenskapsvärde Automatic och egenskapsvärdet SelectionMode är FullColumnSelect eller ColumnHeaderSelect. Använd kontrollen ISupportInitialize.BeginInit() och ISupportInitialize.EndInit() metoderna för att tillfälligt ange motstridiga egenskapsvärden.

-eller-

Minst en av kolumnerna i dataGridViewColumns har ett InheritedAutoSizeMode egenskapsvärde och ColumnHeader egenskapsvärdet ColumnHeadersVisible är false.

-eller-

Minst en av kolumnerna i har ett dataGridViewColumns egenskapsvärde InheritedAutoSizeMode och ett Fill egenskapsvärde på Frozen.true

-eller-

Kolumnerna i dataGridViewColumns har FillWeight egenskapsvärden som gör att de kombinerade FillWeight värdena för alla kolumner i kontrollen överskrider 65535.

-eller-

Minst två av värdena i dataGridViewColumns är referenser till samma DataGridViewColumn.

-eller-

Minst en av kolumnerna i dataGridViewColumns har DisplayIndex och Frozen egenskapsvärden som visar den bland en uppsättning intilliggande kolumner med motsatt Frozen egenskapsvärde.

Exempel

Följande kodexempel illustrerar användningen av den här metoden. Det här exemplet är en del av ett större exempel i Så här: Ange storlekslägen för Windows Forms DataGridView Control.

dataGridView1.Columns.AddRange(new DataGridViewTextBoxColumn[] { 
    idColumn, titleColumn, subTitleColumn, 
    summaryColumn, contentColumn });
dataGridView1.Rows.Add(new String[] { "1", 
    "A Short Title", "A Longer SubTitle", 
    "A short description of the main point.", 
    "The full contents of the topic, with detailed examples." });

dataGridView1.Columns.AddRange(New DataGridViewTextBoxColumn() { _
    idColumn, titleColumn, subTitleColumn, _
    summaryColumn, contentColumn})
dataGridView1.Rows.Add(New String() {"1", _
    "A Short Title", "A Longer SubTitle", _
    "A short description of the main point.", _
    "The full contents of the topic, with detailed examples."})

Gäller för

Se även