FormView.Row Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das FormViewRow-Objekt ab, das die Datenzeile in einem FormView-Steuerelement darstellt.

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

Eigenschaftswert

FormViewRow

Eine FormViewRow, die die Datenzeile in einem FormView-Steuerelement darstellt.

Attribute: BrowsableAttribute

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Die Row -Eigenschaft verwendet wird, um während des Ereignisses ItemCreated auf die Eigenschaften der Datenzeile zuzugreifen.


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

Hinweise

Verwenden Sie die Row -Eigenschaft, um programmgesteuert auf das FormViewRow Objekt zuzugreifen, das die Datenzeile darstellt. Die Datenzeile enthält unterschiedliche Inhalte basierend auf der Vorlage, die für den aktuellen Modus gerendert wird (durch die CurrentMode -Eigenschaft angegeben). Sie können nur auf den Inhalt der Vorlage für den aktuellen Modus zugreifen. Die folgende Tabelle zeigt, welche Vorlage für jeden Modus verwendet wird.

Modus	Vorlage gerendert
Bearbeiten	EditItemTemplate
Einfügen	InsertItemTemplate
Schreibgeschützt	ItemTemplate

Hinweis

Die Row -Eigenschaft ist erst verfügbar, nachdem das FormView -Steuerelement die Datenzeile im ItemCreated -Ereignis erstellt hat.

Diese Eigenschaft wird häufig verwendet, wenn Sie die Datenzeile programmgesteuert bearbeiten müssen, z. B. beim Hinzufügen von benutzerdefiniertem Inhalt. Jede Änderung der Row Eigenschaft muss durchgeführt werden, nachdem das FormView Steuerelement datengebunden wurde. Andernfalls überschreibt das FormView Steuerelement alle Änderungen.

Gilt für:

Weitere Informationen

FormViewRow