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) 。
注意
如果同时 EmptyDataText 设置了 和 EmptyDataTemplate 属性，则 EmptyDataTemplate 属性优先。
的值 EmptyDataText 存储在视图状态中。
设置此属性的值时，可以使用设计器工具自动保存到资源文件。 有关详细信息，请参阅 LocalizableAttribute 和 全球化和本地化。
