다음을 통해 공유


DataGridViewColumnCollection.AddRange(DataGridViewColumn[]) 메서드

정의

열 범위를 컬렉션에 추가합니다.

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())

매개 변수

dataGridViewColumns
DataGridViewColumn[]

추가할 DataGridViewColumn 개체로 이루어진 배열입니다.

예외

dataGridViewColumns이(가) null인 경우

연결된 DataGridView 컨트롤에서 임시로 새 열을 추가하지 못하게 하는 다음 작업 중 하나를 수행하고 있는 경우

  • 컨트롤의 셀을 모두 선택합니다.

  • 선택을 취소합니다.

  • 열의 DisplayIndex 속성 값을 업데이트합니다.

또는 이 메서드는 다음 DataGridView 이벤트 중 하나의 처리기에서 호출됩니다.

또는 dataGridViewColumns의 값 중 하나 이상이 null인 경우

또는 dataGridViewColumns의 열 중 하나 이상이 이미 DataGridView 컨트롤에 속해 있는 경우

또는 dataGridViewColumnsCellType 속성 값이 null인 열이 하나 이상 있고 DataGridView 컨트롤에 행이 하나 이상 있는 경우

또는 dataGridViewColumnsSortMode 속성 값이 Automatic인 열이 하나 이상 있고 SelectionMode 속성 값이 FullColumnSelect 또는 ColumnHeaderSelect인 경우. 컨트롤의 ISupportInitialize.BeginInit()ISupportInitialize.EndInit() 메서드를 사용하여 충돌하는 속성 값을 임시로 설정합니다.

또는 dataGridViewColumnsInheritedAutoSizeMode 속성 값이 ColumnHeader인 열이 하나 이상 있고 ColumnHeadersVisible 속성 값이 false인 경우

또는 dataGridViewColumnsInheritedAutoSizeMode 속성 값이 Fill이고 Frozen 속성 값이 true인 열이 하나 이상 있는 경우

또는 컨트롤에 있는 모든 열의 FillWeight 값을 결합할 때 65535가 초과되는 값으로 dataGridViewColumnsFillWeight 속성이 설정된 경우

또는 dataGridViewColumns의 값 중 두 개 이상이 같은 DataGridViewColumn에 대한 참조인 경우

또는 dataGridViewColumns의 열 중 하나 이상에, 이 속성 값이 인접한 열 집합과 DisplayIndex 속성 값이 반대인 열을 표시하는 FrozenFrozen 속성 값이 있는 경우

예제

다음 코드 예제에서는이 메서드의 사용을 보여 줍니다. 이 예제는에서 사용할 수 있는 보다 큰 예제의 일부 방법: Windows Forms DataGridView 컨트롤의 크기 조정 모드 설정합니다.

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."})

적용 대상

추가 정보