FormView.Row Propriedade
Definição
Obtém o objeto FormViewRow que representa a linha de dados em um controle FormView.Gets the FormViewRow object that represents the data row in a FormView control.
public:
virtual property System::Web::UI::WebControls::FormViewRow ^ Row { System::Web::UI::WebControls::FormViewRow ^ get(); };
[System.ComponentModel.Browsable(false)]
public virtual System.Web.UI.WebControls.FormViewRow Row { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Row : System.Web.UI.WebControls.FormViewRow
Public Overridable ReadOnly Property Row As FormViewRow
Valor da propriedade
O FormViewRow que representa a linha de dados em um controle FormView.The FormViewRow that represents the data row in a FormView control.
- Atributos
Exemplos
O exemplo a seguir demonstra como usar a Row propriedade para acessar as propriedades da linha de dados durante o ItemCreated evento.The following example demonstrates how to use the Row property to access the properties of the data row during the ItemCreated event.
<%@ page language="C#" %>
<%@ import namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
void EmployeeFormView_ItemCreated(Object sender, EventArgs e)
{
// Use the Row property to retrieve the data row from
// the FormView control.
FormViewRow row = EmployeeFormView.Row;
// Get the data item bound to the FormView control.
DataRowView rowView = (DataRowView)EmployeeFormView.DataItem;
// Set the ToolTip property of the data row.
row.ToolTip = rowView["FirstName"].ToString() + " " +
rowView["LastName"].ToString();
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Row Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Row Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
onitemcreated="EmployeeFormView_ItemCreated"
runat="server">
<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>
</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. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
<%@ page language="VB" %>
<%@ import namespace="System.Data" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
Sub EmployeeFormView_ItemCreated(ByVal sender As Object, ByVal e As EventArgs)
' Use the Row property to retrieve the data row from
' the FormView control.
Dim row As FormViewRow = EmployeeFormView.Row
' Get the data item bound to the FormView control.
Dim rowView As DataRowView = CType(EmployeeFormView.DataItem, DataRowView)
' Set the ToolTip property of the data row.
row.ToolTip = rowView("FirstName").ToString() & " " & _
rowView("LastName").ToString()
End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>FormView Row Example</title>
</head>
<body>
<form id="form1" runat="server">
<h3>FormView Row Example</h3>
<asp:formview id="EmployeeFormView"
datasourceid="EmployeeSource"
allowpaging="true"
datakeynames="EmployeeID"
onitemcreated="EmployeeFormView_ItemCreated"
runat="server">
<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>
</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. -->
<asp:sqldatasource id="EmployeeSource"
selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>"
runat="server"/>
</form>
</body>
</html>
Comentários
Use a Row propriedade para acessar programaticamente o FormViewRow objeto que representa a linha de dados.Use the Row property to programmatically access the FormViewRow object that represents the data row. A linha de dados contém conteúdo diferente com base no modelo renderizado para o modo atual (especificado pela CurrentMode Propriedade).The data row contains different content based on the template rendered for the current mode (specified by the CurrentMode property). Você só pode acessar o conteúdo do modelo para o modo atual.You can only access the contents of the template for the current mode. A tabela a seguir mostra qual modelo é usado para cada modo.The following table shows which template is used for each mode.
| ModoMode | Modelo renderizadoTemplate rendered |
|---|---|
| EditarEdit | EditItemTemplate |
| InserirInsert | InsertItemTemplate |
| Somente leituraRead-only | ItemTemplate |
Observação
A Row propriedade só estará disponível depois que o FormView controle criar a linha de dados no ItemCreated evento.The Row property is available only after the FormView control creates the data row in the ItemCreated event.
Essa propriedade é comumente usada quando você precisa manipular programaticamente a linha de dados, por exemplo, ao adicionar conteúdo personalizado.This property is commonly used when you need to programmatically manipulate the data row, for example when adding custom content. Qualquer modificação na Row propriedade deve ser executada Depois que o FormView controle tiver sido vinculado a dados; caso contrário, o FormView controle substituirá as alterações.Any modification to the Row property must be performed after the FormView control has been data-bound; otherwise, the FormView control overwrites any changes.