DataGridView.AutoGenerateColumns プロパティ

.NET Framework クラス ライブラリ リファレンス

DataGridView.AutoGenerateColumns プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

DataSource プロパティまたは DataMember プロパティが設定されている場合、列が自動的に作成されるかどうかを示す値を取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property AutoGenerateColumns As
 Boolean

Visual Basic (使用法)

Dim instance As DataGridView
Dim value As Boolean

value = instance.AutoGenerateColumns

instance.AutoGenerateColumns = value

C#

public bool AutoGenerateColumns { get;
 set; }

C++

public:
property bool AutoGenerateColumns {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_AutoGenerateColumns ()

/** @property */
public void set_AutoGenerateColumns (boolean
 value)

JScript

public function get AutoGenerateColumns
 () : boolean

public function set AutoGenerateColumns
 (value : boolean)

プロパティ値
列を自動的に作成する場合は true。それ以外の場合は false。既定値は true です。

解説

このプロパティが true に設定され、DataSource プロパティまたは DataMember プロパティが設定または変更されている場合、列が自動的に生成されます。AutoGenerateColumns プロパティが false から true に変更された場合も、列が自動的に生成されます。このプロパティが true で、DataSource の変更により前の DataSource 値の列と一致しない列がある場合、一致しない列のデータは破棄されます。DataSource プロパティまたは DataMember プロパティが設定されていない場合、このプロパティは無視されます。

各列ヘッダーには、その列が表すプロパティ名の値が含まれます。

使用例

単純なデータ バインド DataGridView を初期化する方法を次のコード例に示します。この例では、AutoGenerateColumns プロパティの設定方法も示します。この例を実行するには、dataGridView1 という名前の DataGridView を含むフォームに次のコードを貼り付け、コードで指定された connectionString 変数の値を、例が実行されるシステムに対して有効な文字列に置換して、フォームのコンストラクタまたは Load イベント ハンドラから InitializeDataGridView メソッドを呼び出します。

Visual Basic

Private Sub InitializeDataGridView()
    Try
        ' Set up the DataGridView.
        With Me.dataGridView1
            ' Automatically generate the DataGridView columns.
            .AutoGenerateColumns = True

            ' Set up the data source.
            bindingSource1.DataSource = GetData("Select * From
 Products")
            .DataSource = bindingSource1

            ' Automatically resize the visible rows.
            .AutoSizeRowsMode = _
                DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders

            ' Set the DataGridView control's border.
            .BorderStyle = BorderStyle.Fixed3D

            ' Put the cells in edit mode when user enters them.
            .EditMode = DataGridViewEditMode.EditOnEnter
        End With
    Catch ex As SqlException
        MessageBox.Show("To run this sample replace "
 _
            & "connection.ConnectionString with a valid connection
 string" _
            & "  to a Northwind database accessible to your
 system.", _
            "ERROR", MessageBoxButtons.OK, MessageBoxIcon.Exclamation)
        System.Threading.Thread.CurrentThread.Abort()
    End Try
End Sub

Private Shared Function
 GetData(ByVal sqlCommand As String)
 _
    As DataTable

    Dim connectionString As String
 = _
        "Integrated Security=SSPI;Persist Security Info=False;"
 _
        & "Initial Catalog=Northwind;Data Source=localhost"

    Dim northwindConnection As SqlConnection
 = _
        New SqlConnection(connectionString)

    Dim command As New SqlCommand(sqlCommand,
 northwindConnection)
    Dim adapter As SqlDataAdapter = New
 SqlDataAdapter()
    adapter.SelectCommand = command

    Dim table As New DataTable
    table.Locale = System.Globalization.CultureInfo.InvariantCulture
    adapter.Fill(table)

    Return table

End Function

C#

private void InitializeDataGridView()
{
    try
    {
        // Set up the DataGridView.
        dataGridView1.Dock = DockStyle.Fill;

        // Automatically generate the DataGridView columns.
        dataGridView1.AutoGenerateColumns = true;

        // Set up the data source.
        bindingSource1.DataSource = GetData("Select * From Products");
        dataGridView1.DataSource = bindingSource1;

        // Automatically resize the visible rows.
        dataGridView1.AutoSizeRowsMode =
            DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;

        // Set the DataGridView control's border.
        dataGridView1.BorderStyle = BorderStyle.Fixed3D;

        // Put the cells in edit mode when user enters them.
        dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter;
    }
    catch (SqlException)
    {
        MessageBox.Show("To run this sample replace connection.ConnectionString"
 +
            " with a valid connection string to a Northwind"
 +
            " database accessible to your system.", "ERROR",
            MessageBoxButtons.OK, MessageBoxIcon.Exclamation);
        System.Threading.Thread.CurrentThread.Abort();
    }
}

private static DataTable GetData(string
 sqlCommand)
{
    string connectionString = "Integrated Security=SSPI;"
 +
        "Persist Security Info=False;" +
        "Initial Catalog=Northwind;Data Source=localhost";

    SqlConnection northwindConnection = new SqlConnection(connectionString);

    SqlCommand command = new SqlCommand(sqlCommand, northwindConnection);
    SqlDataAdapter adapter = new SqlDataAdapter();
    adapter.SelectCommand = command;

    DataTable table = new DataTable();
    table.Locale = System.Globalization.CultureInfo.InvariantCulture;
    adapter.Fill(table);

    return table;
}

C++

void InitializeDataGridView()
{
   try
   {
      // Set up the DataGridView.
      dataGridView1->Dock = DockStyle::Fill;

      // Automatically generate the DataGridView columns.
      dataGridView1->AutoGenerateColumns = true;

      // Set up the data source.
      bindingSource1->DataSource = GetData( "Select * From Products"
 );
      dataGridView1->DataSource = bindingSource1;

      // Automatically resize the visible rows.
      dataGridView1->AutoSizeRowsMode = DataGridViewAutoSizeRowsMode::DisplayedCellsExceptHeaders;

      // Set the DataGridView control's border.
      dataGridView1->BorderStyle = BorderStyle::Fixed3D;

      // Put the cells in edit mode when user enters them.
      dataGridView1->EditMode = DataGridViewEditMode::EditOnEnter;
   }
   catch ( SqlException^ ) 
   {
      MessageBox::Show( "To run this sample replace connection.ConnectionString"
      " with a valid connection string to a Northwind"
      " database accessible to your system.", "ERROR", MessageBoxButtons::OK,
 MessageBoxIcon::Exclamation );
      System::Threading::Thread::CurrentThread->Abort();
   }
   catch ( System::Exception^ ex ) 
   {
      MessageBox::Show( ex->ToString() );
   }
}


DataTable^ GetData( String^ sqlCommand )
{
   String^ connectionString = "Integrated Security=SSPI;Persist Security Info=False;"
   "Initial Catalog=Northwind;Data Source= localhost";
   SqlConnection^ northwindConnection = gcnew SqlConnection( connectionString );
   SqlCommand^ command = gcnew SqlCommand( sqlCommand,northwindConnection );
   SqlDataAdapter^ adapter = gcnew SqlDataAdapter;
   adapter->SelectCommand = command;
   DataTable^ table = gcnew DataTable;
   adapter->Fill( table );
   return table;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)