FormView.Row Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el FormViewRow objeto que representa la fila de datos de un 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.FormViewRowPublic Overridable ReadOnly Property Row As FormViewRowValor de propiedad
FormViewRow que representa la fila de datos de un FormView control .
- Atributos
Ejemplos
En el ejemplo siguiente se muestra cómo usar la Row propiedad para tener acceso a las propiedades de la fila de datos durante el ItemCreated evento.
<%@ 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>
Comentarios
Utilice la Row propiedad para acceder mediante programación al FormViewRow objeto que representa la fila de datos. La fila de datos contiene contenido diferente en función de la plantilla representada para el modo actual (especificado por la CurrentMode propiedad ). Solo puede acceder al contenido de la plantilla para el modo actual. En la tabla siguiente se muestra qué plantilla se usa para cada modo.
| Modo | Plantilla representada |
|---|---|
| Editar | EditItemTemplate |
| Insertar | InsertItemTemplate |
| Solo lectura | ItemTemplate |
Nota:
La Row propiedad solo está disponible después de que el FormView control cree la fila de datos en el ItemCreated evento .
Esta propiedad se usa normalmente cuando se necesita manipular mediante programación la fila de datos, por ejemplo, al agregar contenido personalizado. Cualquier modificación de la Row propiedad debe realizarse después de que el FormView control se haya enlazado a datos; de lo contrario, el FormView control sobrescribe los cambios.
