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

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

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

BaseDataBoundControl.DataSourceID プロパティ

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

データバインドコントロールのデータ項目一覧の取得元となるコントロールの ID を取得または設定します。

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

Visual Basic (宣言)

<ThemeableAttribute(False)> _
Public Overridable Property
 DataSourceID As String

Visual Basic (使用法)

Dim instance As BaseDataBoundControl
Dim value As String

value = instance.DataSourceID

instance.DataSourceID = value

[ThemeableAttribute(false)] 
public virtual string DataSourceID { get;
 set; }

C++

[ThemeableAttribute(false)] 
public:
virtual property String^ DataSourceID {
    String^ get ();
    void set (String^ value);
}

/** @property */
public String get_DataSourceID ()

/** @property */
public void set_DataSourceID (String value)

JScript

public function get DataSourceID
 () : String

public function set DataSourceID
 (value : String)

プロパティ値
データバインドコントロールのデータの取得元となるデータソースを表すコントロールの ID。既定値は String.Empty です。

解説

データバインドコントロールが既に初期化されている場合 (ConfirmInitState メソッドが呼び出されているか OnPagePreLoad イベントが処理されている場合)、DataSourceID プロパティを設定すると、OnDataPropertyChanged メソッドが呼び出され RequiresDataBinding プロパティに true が設定されます。

このプロパティは、テーマまたはスタイルシートテーマによって設定することはできません。詳細については、ThemeableAttribute、ASP.NET のテーマとスキンの概要の各トピックを参照してください。

使用例

データバインドコントロールの DataSourceID プロパティの使用方法を、次のコード例に示します。DataSourceID プロパティに SqlDataSource コントロールの ID である "AuthorsSqlDataSource" を設定することで、GridView コントロールを SqlDataSource に関連付けます。(DataSource プロパティの代わりに) DataSourceID プロパティが設定されている場合、データバインドコントロールは実行時に自動的にデータソースコントロールにバインドします。

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>