FormView.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 FormView 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 a seguir demonstra como usar a EmptyDataRowStyle propriedade para especificar um estilo personalizado para a linha de dados vazia exibida quando um FormView controle está associado a uma fonte de dados que não contém nenhum registro.
<%@ 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>FormView EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataText Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
emptydatatext="No records available."
runat="server">
<EmptyDataRowStyle BackColor="Red"
forecolor="White"
font-size="14"
font-italic="true"
height="100"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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. -->
<!-- The select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</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>FormView EmptyDataText Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView EmptyDataText Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
emptydatatext="No records available."
runat="server">
<EmptyDataRowStyle BackColor="Red"
forecolor="White"
font-size="14"
font-italic="true"
height="100"/>
<itemtemplate>
<table>
<tr>
<td>
<asp:image id="EmployeeImage"
imageurl='<%# Eval("PhotoPath") %>'
alternatetext='<%# Eval("LastName") %>'
runat="server"/>
</td>
<td>
<h3><%# Eval("FirstName") %> <%# Eval("LastName") %></h3>
<%# Eval("Title") %>
</td>
</tr>
</table>
</itemtemplate>
<pagersettings position="Bottom"
mode="NextPrevious"/>
</asp:formview>
<!-- 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. -->
<!-- The select query for the following SqlDataSource -->
<!-- control is intentionally set to return no results -->
<!-- to demonstrate the empty data row. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees] Where [EmployeeID]=1000"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Comentários
Use a EmptyDataRowStyle propriedade para controlar a aparência da linha de dados vazia em um FormView 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 usando um dos seguintes métodos:
Coloque um atributo na marca de abertura do FormView controle no formulário
Property-Subproperty
, ondeSubproperty
está uma propriedade do TableItemStyle objeto (por exemplo,EmptyDataRowStyle-ForeColor
).Aninhar um
<EmptyDataRowStyle>
elemento entre as marcas de abertura e fechamento do FormView controle.
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 do primeiro plano e propriedades de fonte.