GridView.AutoGenerateColumns プロパティとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

GridView.AutoGenerateColumns プロパティ

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

データソース内の各フィールドについてバインドされたフィールドが自動作成されるかどうかを示す値を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Property
 AutoGenerateColumns As Boolean

Visual Basic (使用法)

Dim instance As GridView
Dim value As Boolean

value = instance.AutoGenerateColumns

instance.AutoGenerateColumns = value

public virtual bool AutoGenerateColumns { get;
 set; }

C++

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

/** @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 です。

解説

AutoGenerateColumns プロパティが true に設定されている場合、データソース内の各フィールドについて、AutoGeneratedField オブジェクトが自動作成されます。次に、各フィールドはデータソースに表示される順番で GridView コントロールの列として表示されます。このオプションを使用すると、データソース内の各フィールドを簡単に表示できますが、自動生成された列フィールドの表示方法や動作方法の制御に制限があります。

メモ
自動生成されたバインド済み列フィールドは、Columns コレクションに追加されません。

GridView コントロールで列フィールドを自動生成する代わりに、AutoGenerateColumns プロパティを false に設定し、カスタムの Columns コレクションを作成して、列フィールドを手動で定義できます。バインドされた列フィールドに加え、ボタン列フィールド、チェックボックス列フィールド、コマンドフィールド、ハイパーリンク列フィールド、イメージフィールド、または独自のカスタム定義テンプレートに基づいた列フィールドを表示することもできます。詳細については、「Columns」を参照してください。

メモ
明示的に宣言された列フィールドは、自動生成された列フィールドと組み合わせて使用できます。これらの両方を使用した場合、明示的に宣言された列フィールドが先に表示され、自動生成された列フィールドが次に表示されます。

使用例

AutoGenerateColumns プロパティを使用して、データソースの各フィールドについて、バインドされたフィールド列を GridView コントロールに自動作成する方法を次のコード例に示します。

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects
  -->
      <!-- to the Northwind sample database. Use an ASP.NET
     -->
      <!-- expression to retrieve the connection string
 value   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address],
 [City], [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
        
    </form>
  </body>
</html>

<%@ Page language="C#" %>

<html>
  <body>
    <form runat="server">
        
      <h3>GridView Example</h3>

      <asp:gridview id="CustomersGridView" 
        datasourceid="CustomersSource" 
        autogeneratecolumns="true"
        emptydatatext="No data available." 
        allowpaging="true" 
        runat="server">                
      </asp:gridview>
            
      <!-- This example uses Microsoft SQL Server and connects  -->
      <!-- to the Northwind sample database. Use an ASP.NET     -->
      <!-- expression to retrieve the connection string value
   -->
      <!-- from the Web.config file.                            -->
      <asp:sqldatasource id="CustomersSource"
        selectcommand="Select [CustomerID], [CompanyName], [Address], [City],
 [PostalCode], [Country] From [Customers]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
 
        runat="server"/>
        
    </form>
  </body>
</html>