DetailsView.EmptyDataRowStyle Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém uma referência para o objeto TableItemStyle que permite que você defina a aparência da linha de dados vazia exibida quando a fonte de dados associada a um controle DetailsView não contém nenhum registro.
public:
property System::Web::UI::WebControls::TableItemStyle ^ EmptyDataRowStyle { System::Web::UI::WebControls::TableItemStyle ^ get(); };
[System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)]
public System.Web.UI.WebControls.TableItemStyle EmptyDataRowStyle { get; }
[<System.Web.UI.PersistenceMode(System.Web.UI.PersistenceMode.InnerProperty)>]
member this.EmptyDataRowStyle : System.Web.UI.WebControls.TableItemStyle
Public ReadOnly Property EmptyDataRowStyle As TableItemStyle
Valor da propriedade
Uma referência ao TableItemStyle que permite definir a aparência da linha de dados vazia.
- Atributos
Exemplos
O exemplo de código a seguir demonstra como usar a EmptyDataRowStyle propriedade para especificar as configurações de fonte e estilo para a linha de dados vazia.
<%@ 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>
Comentários
Use a EmptyDataRowStyle propriedade para controlar a aparência da linha de dados vazia em um DetailsView controle. A linha de dados vazia é exibida quando a fonte de dados associada ao controle não contém nenhum registro. Essa propriedade é somente leitura; no entanto, você pode definir as propriedades do TableItemStyle objeto que ele retorna. As propriedades podem ser definidas declarativamente no formulário Property-Subproperty
, onde Subproperty
é uma propriedade do TableItemStyle objeto (por exemplo, EmptyDataRowStyle-ForeColor
). As propriedades também podem ser definidas programaticamente no formulário Property.Subproperty
(por exemplo, EmptyDataRowStyle.ForeColor
). As configurações comuns geralmente incluem uma cor da tela de fundo personalizada, cor de primeiro plano e propriedades de fonte.