FormView.Row Propriété

  • Référence

Définition

Espace de noms:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Obtient l'objet FormViewRow qui représente la ligne de données dans un contrôle FormView.

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

Valeur de propriété

FormViewRow

FormViewRow qui représente la ligne de données dans un contrôle FormView.

Attributs
BrowsableAttribute

Exemples

L’exemple suivant montre comment utiliser la Row propriété pour accéder aux propriétés de la ligne de données pendant l’événement ItemCreated .


<%@ 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>

Remarques

Utilisez la Row propriété pour accéder par programmation à l’objet FormViewRow qui représente la ligne de données. La ligne de données contient un contenu différent en fonction du modèle rendu pour le mode actif (spécifié par la CurrentMode propriété). Vous pouvez uniquement accéder au contenu du modèle pour le mode actuel. Le tableau suivant indique le modèle utilisé pour chaque mode.

Mode Modèle rendu
Modifier EditItemTemplate
Insérer InsertItemTemplate
Lecture seule ItemTemplate

Notes

La Row propriété n’est disponible qu’une fois que le FormView contrôle a créé la ligne de données dans l’événement ItemCreated .

Cette propriété est couramment utilisée lorsque vous devez manipuler la ligne de données par programmation, par exemple lors de l’ajout de contenu personnalisé. Toute modification de la Row propriété doit être effectuée une fois que le FormView contrôle a été lié aux données ; sinon, le FormView contrôle remplace toutes les modifications.

S’applique à

Voir aussi