DetailsView.EmptyDataRowStyle プロパティ

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

DetailsView.EmptyDataRowStyle プロパティ

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

DetailsView コントロールにバインドされたデータ ソースにレコードが格納されていない場合に表示される空のデータ行の外観を設定できる TableItemStyle オブジェクトへの参照を取得します。

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

Visual Basic (宣言)

Public ReadOnly Property
 EmptyDataRowStyle As TableItemStyle

Visual Basic (使用法)

Dim instance As DetailsView
Dim value As TableItemStyle

value = instance.EmptyDataRowStyle

C#

public TableItemStyle EmptyDataRowStyle { get;
 }

C++

public:
property TableItemStyle^ EmptyDataRowStyle {
    TableItemStyle^ get ();
}

J#

/** @property */
public TableItemStyle get_EmptyDataRowStyle ()

JScript

public function get EmptyDataRowStyle
 () : TableItemStyle

プロパティ値
空のデータ行の外観を設定できる TableItemStyle への参照。

解説

EmptyDataRowStyle プロパティを使用して、DetailsView コントロールの空のデータ行の外観を制御します。空のデータ行は、コントロールにバインドされているデータ ソースにレコードが格納されていない場合に表示されます。このプロパティは読み取り専用です。ただし、このプロパティが返す TableItemStyle オブジェクトのプロパティを設定することはできます。このプロパティは、Property-Subproperty の形式で、宣言によって設定できます。Subproperty には、TableItemStyle オブジェクトのプロパティを指定します (例 : EmptyDataRowStyle-ForeColor)。Property.Subproperty の形式で、プロパティをプログラムによって設定することもできます (例 : EmptyDataRowStyle.ForeColor)。通常、共通設定には、カスタムの背景色、前景色、およびフォントのプロパティが含まれます。

使用例

EmptyDataRowStyle プロパティを使用して、空のデータ行のフォントおよびスタイルの設定を指定する方法のコード例を次に示します。

Visual Basic

<%@ Page language="VB" %>

<html>
  <body>
    <form runat="server">
        
      <h3>DetailsView EmptyDataText Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="StoresDetailsSqlDataSource"
          autogeneraterows="true" 
          EmptyDataText="No records." 
          runat="server">
               
          <emptydatarowstyle backcolor="Navy"
            forecolor="Red"/> 
                    
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects
 -->
        <!-- to the Pubs sample database.                 
       -->
        
        <!-- The select query of the following
 SqlDataSource     -->
        <!-- control has been intentionally set to
 return no     --> 
        <!-- results to demonstrate the empty data row.   
       -->      
        <asp:sqldatasource id="StoresDetailsSqlDataSource"
  
          selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city],
 [state], [zip] FROM [stores] WHERE [state]='FL'"
          connectionstring="server=localhost;database=pubs;integrated
 security=SSPI"
          runat="server">
        </asp:sqldatasource>
            
      </form>
  </body>
</html>

C#

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

<html>
  <body>
    <form runat="server">
        
      <h3>DetailsView EmptyDataText Example</h3>
                
        <asp:detailsview id="StoresDetailView"
          datasourceid="StoresDetailsSqlDataSource"
          autogeneraterows="true" 
          EmptyDataText="No records." 
          runat="server">
               
          <emptydatarowstyle backcolor="Navy"
            forecolor="Red"/> 
                    
        </asp:detailsview>
            
        <!-- This example uses Microsoft SQL Server and connects -->
        <!-- to the Pubs sample database.                        -->
        
        <!-- The select query of the following SqlDataSource     -->
        <!-- control has been intentionally set to return
 no     --> 
        <!-- results to demonstrate the empty data row.          -->      
        <asp:sqldatasource id="StoresDetailsSqlDataSource"  
          selectcommand="SELECT [stor_id], [stor_name], [stor_address], [city],
 [state], [zip] FROM [stores] WHERE [state]='FL'"
          connectionstring="server=localhost;database=pubs;integrated security=SSPI"
          runat="server">
        </asp:sqldatasource>
            
      </form>
  </body>
</html>

プラットフォーム

Windows 98, Windows 2000 SP4, 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

参照

関連項目
DetailsView クラス
DetailsView メンバ
System.Web.UI.WebControls 名前空間
TableItemStyle
DetailsView.AlternatingRowStyle プロパティ
DetailsView.CommandRowStyle プロパティ
DetailsView.EditRowStyle プロパティ
EmptyDataTemplate
EmptyDataText
FooterStyle
FieldHeaderStyle
HeaderStyle
InsertRowStyle
RowStyle