DetailsView.EmptyDataText プロパティ
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
レコードが格納されていないデータ ソースに DetailsView コントロールがバインドされている場合に表示される、空のデータ行に表示されるテキストを取得または設定します。
public:
virtual property System::String ^ EmptyDataText { System::String ^ get(); void set(System::String ^ value); };public virtual string EmptyDataText { get; set; }member this.EmptyDataText : string with get, setPublic Overridable Property EmptyDataText As Stringプロパティ値
空のデータ行に表示されるテキスト。 既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。
例
次のコード例では、プロパティを使用して、空の EmptyDataText データ行に表示するテキストを指定する方法を示します。
<%@ Page language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView EmptyDataText Example</title>
</head>
<body>
<form id="form1" 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="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
<%@ Page language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>DetailsView EmptyDataText Example</title>
</head>
<body>
<form id="form1" 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="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server">
</asp:sqldatasource>
</form>
</body>
</html>
注釈
コントロールにバインドされているデータ ソースに DetailsView レコードが含まれていない場合、空のデータ行がコントロールに表示されます。 このプロパティを EmptyDataText 使用して、空のデータ行に表示するテキストを指定します。 空のデータ行のスタイルを制御するには、プロパティを EmptyDataRowStyle 使用します。 または、このプロパティではなくプロパティを設定 EmptyDataTemplate することで、空のデータ行に独自のカスタム ユーザー インターフェイス (UI) を定義することもできます。
注意
プロパティとEmptyDataTemplateプロパティの両方がEmptyDataText設定されている場合は、プロパティがEmptyDataTemplate優先されます。
の EmptyDataText 値はビューステートに格納されます。
このプロパティの値を設定すると、デザイナー ツールを使用してリソース ファイルに自動的に保存できます。 詳細については、「グローバリゼーションとローカリゼーション」を参照してくださいLocalizableAttribute。