FormView Classe

Definição

Exibe os valores de um único registro de uma fonte de dados usando modelos definidos pelo usuário.Displays the values of a single record from a data source using user-defined templates. O controle FormView permite que você edite, exclua e insira registros.The FormView control allows you to edit, delete, and insert records.

public ref class FormView : System::Web::UI::WebControls::CompositeDataBoundControl, System::Web::UI::IDataItemContainer, System::Web::UI::IPostBackEventHandler, System::Web::UI::WebControls::IDataBoundItemControl, System::Web::UI::WebControls::IPostBackContainer
[System.Web.UI.ControlValueProperty("SelectedValue")]
public class FormView : System.Web.UI.WebControls.CompositeDataBoundControl, System.Web.UI.IDataItemContainer, System.Web.UI.IPostBackEventHandler, System.Web.UI.WebControls.IDataBoundItemControl, System.Web.UI.WebControls.IPostBackContainer
type FormView = class
    inherit CompositeDataBoundControl
    interface IDataItemContainer
    interface INamingContainer
    interface IPostBackEventHandler
    interface IPostBackContainer
    interface IDataBoundItemControl
    interface IDataBoundControl
Public Class FormView
Inherits CompositeDataBoundControl
Implements IDataBoundItemControl, IDataItemContainer, IPostBackContainer, IPostBackEventHandler
Herança
Atributos
Implementações

Exemplos

O exemplo a seguir demonstra como usar um controle de FormView para exibir os valores de um controle de SqlDataSource.The following example demonstrates how to use a FormView control to display the values from a SqlDataSource control.


<%@ 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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# 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.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        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 Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID" 
        runat="server">
        
        <itemtemplate>
        
          <table>
            <tr>
              <td>
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td>
                <h3><%# Eval("FirstName") %>&nbsp;<%# 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.                            -->
      <asp:sqldatasource id="EmployeeSource"
        selectcommand="Select [EmployeeID], [LastName], [FirstName], [Title], [PhotoPath] From [Employees]"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

O exemplo a seguir demonstra como usar um controle de FormView para editar registros existentes.The following example demonstrates how to use a FormView control to edit existing records.

Importante

O controle neste exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.The control in this example has a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.


<%@ Page language="C#" %>

<!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_ItemUpdating(Object sender, FormViewUpdateEventArgs e)
  {

    // Validate the field values entered by the user. This
    // example determines whether the user left any fields
    // empty. Use the NewValues property to access the new 
    // values entered by the user.
    ArrayList emptyFieldList = ValidateFields(e.NewValues);

    if (emptyFieldList.Count > 0)
    {

      // The user left some fields empty. Display an error message.
      
      // Use the Keys property to retrieve the key field value.
      String keyValue = e.Keys["EmployeeID"].ToString();

      MessageLabel.Text = "You must enter a value for each field of record " +
        keyValue + ".<br/>The following fields are missing:<br/><br/>";

      // Display the missing fields.
      foreach (String value in emptyFieldList)
      {
        // Use the OldValues property to access the original value
        // of a field.
        MessageLabel.Text += value + " - Original Value = " + 
          e.OldValues[value].ToString() + "<br />";
      }

      // Cancel the update operation.
      e.Cancel = true;

    }
    else
    {
      // The field values passed validation. Clear the
      // error message label.
      MessageLabel.Text = "";
    }

  }

  ArrayList ValidateFields(IOrderedDictionary list)
  {
    
    // Create an ArrayList object to store the
    // names of any empty fields.
    ArrayList emptyFieldList = new ArrayList();

    // Iterate though the field values entered by
    // the user and check for an empty field. Empty
    // fields contain a null value.
    foreach (DictionaryEntry entry in list)
    {
      if (entry.Value == String.Empty)
      {
        // Add the field name to the ArrayList object.
        emptyFieldList.Add(entry.Key.ToString());
      }
    }

    return emptyFieldList;
  }

  void EmployeeFormView_ModeChanging(Object sender, FormViewModeEventArgs e)
  {
    if (e.CancelingEdit)
    {
      // The user canceled the update operation.
      // Clear the error message label.
      MessageLabel.Text = "";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        headertext="Employee Record"
        emptydatatext="No employees found."
        onitemupdating="EmployeeFormView_ItemUpdating"
        onmodechanging="EmployeeFormView_ModeChanging"  
        runat="server">
        
        <headerstyle backcolor="CornFlowerBlue"
          forecolor="White"
          font-size="14"
          horizontalalign="Center"  
          wrap="false"/>
        <rowstyle backcolor="LightBlue"
          wrap="false"/>
        <pagerstyle backcolor="CornFlowerBlue"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <%# Eval("HireDate","{0:d}") %>
              </td>
            </tr>
            <tr style="height:150; vertical-align:top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <%# Eval("Address") %><br/>
                <%# Eval("City") %> <%# Eval("Region") %>
                <%# Eval("PostalCode") %><br/>
                <%# Eval("Country") %>   
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <asp:textbox id="HireDateUpdateTextBox"
                  text='<%# Bind("HireDate", "{0:d}") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr style="height:150; vertical-align:top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <asp:textbox id="AddressUpdateTextBox"
                  text='<%# Bind("Address") %>'
                  runat="server"/>
                <br/>
                <asp:textbox id="CityUpdateTextBox"
                  text='<%# Bind("City") %>'
                  runat="server"/> 
                <asp:textbox id="RegionUpdateTextBox"
                  text='<%# Bind("Region") %>'
                  width="40"
                  runat="server"/>
                <asp:textbox id="PostalCodeUpdateTextBox"
                  text='<%# Bind("PostalCode") %>'
                  width="60"
                  runat="server"/>
                <br/>
                <asp:textbox id="CountryUpdateTextBox"
                  text='<%# Bind("Country") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </edititemtemplate>
          
        <pagersettings position="Bottom"
          mode="Numeric"/> 
                  
      </asp:formview>
      
      <br/><br/>
      
      <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
          
      <!-- 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], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
        updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
        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">
<script runat="server">

  Sub EmployeeFormView_ItemUpdating(ByVal sender As Object, ByVal e As FormViewUpdateEventArgs) Handles EmployeeFormView.ItemUpdating
  
    ' Validate the field values entered by the user. This
    ' example determines whether the user left any fields
    ' empty. Use the NewValues property to access the new 
    ' values entered by the user.
        Dim emptyFieldList As ArrayList = ValidateFields(e.NewValues)

    If emptyFieldList.Count > 0 Then

      ' The user left some fields empty. Display an error message.
      
      ' Use the Keys property to retrieve the key field value.
      Dim keyValue As String = e.Keys("EmployeeID").ToString()

      MessageLabel.Text = "You must enter a value for each field of record " & _
        keyValue & ".<br/>The following fields are missing:<br/><br/>"

      ' Display the missing fields.
      Dim value As String
      For Each value In emptyFieldList
      
        ' Use the OldValues property to access the original value
        ' of a field.
        MessageLabel.Text &= value & " - Original Value = " & _
          e.OldValues(value).ToString() & "<br />"
        
      Next

      ' Cancel the update operation.
      e.Cancel = True

    Else
    
      ' The field values passed validation. Clear the
      ' error message label.
      MessageLabel.Text = ""
      
    End If

  End Sub

  Function ValidateFields(ByVal list As IOrderedDictionary) As ArrayList
    
    ' Create an ArrayList object to store the
    ' names of any empty fields.
    Dim emptyFieldList As New ArrayList()

    ' Iterate though the field values entered by
    ' the user and check for an empty field. Empty
    ' fields contain a null value.
    Dim entry As DictionaryEntry
    
    For Each entry In list
    
      If entry.Value Is String.Empty Then
      
        ' Add the field name to the ArrayList object.
        emptyFieldList.Add(entry.Key.ToString())
        
      End If
      
    Next

    Return emptyFieldList
  
  End Function
  
  Sub EmployeeFormView_ModeChanging(ByVal sender As Object, ByVal e As FormViewModeEventArgs) Handles EmployeeFormView.ModeChanging
  
    If e.CancelingEdit Then
      
      ' The user canceled the update operation.
      ' Clear the error message label.
      MessageLabel.Text = ""
    
    End If
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>FormView Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        headertext="Employee Record"
        emptydatatext="No employees found."
        runat="server">
        
        <headerstyle backcolor="CornFlowerBlue"
          forecolor="White"
          font-size="14"
          horizontalalign="Center"  
          wrap="false"/>
        <rowstyle backcolor="LightBlue"
          wrap="false"/>
        <pagerstyle backcolor="CornFlowerBlue"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <%# Eval("HireDate","{0:d}") %>
              </td>
            </tr>
            <tr style="height:150; vertical-align:top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <%# Eval("Address") %><br/>
                <%# Eval("City") %> <%# Eval("Region") %>
                <%# Eval("PostalCode") %><br/>
                <%# Eval("Country") %>   
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="6">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td>
                <b>Hire Date:</b>                 
              </td>
              <td>
                <asp:textbox id="HireDateUpdateTextBox"
                  text='<%# Bind("HireDate", "{0:d}") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr style="height:150; vertical-align:top">
              <td>
                <b>Address:</b>
              </td>
              <td>
                <asp:textbox id="AddressUpdateTextBox"
                  text='<%# Bind("Address") %>'
                  runat="server"/>
                <br/>
                <asp:textbox id="CityUpdateTextBox"
                  text='<%# Bind("City") %>'
                  runat="server"/> 
                <asp:textbox id="RegionUpdateTextBox"
                  text='<%# Bind("Region") %>'
                  width="40"
                  runat="server"/>
                <asp:textbox id="PostalCodeUpdateTextBox"
                  text='<%# Bind("PostalCode") %>'
                  width="60"
                  runat="server"/>
                <br/>
                <asp:textbox id="CountryUpdateTextBox"
                  text='<%# Bind("Country") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </edititemtemplate>
          
        <pagersettings position="Bottom"
          mode="Numeric"/> 
                  
      </asp:formview>
      
      <br/><br/>
      
      <asp:label id="MessageLabel"
          forecolor="Red"
          runat="server"/>
          
      <!-- 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], [Address], [City], [Region], [PostalCode], [Country], [HireDate], [PhotoPath] From [Employees]"
        updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title, [Address]=@Address, [City]=@City, [Region]=@Region, [PostalCode]=@PostalCode, [Country]=@Country Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

O exemplo a seguir demonstra como usar um controle de FormView para inserir novos registros.The following example demonstrates how to use a FormView control to insert new records.

Importante

O controle neste exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança.The control in this example has a text box that accepts user input, which is a potential security threat. Por padrão, as páginas da Web do ASP.NET validam que a entrada do usuário não inclui elementos de script ou HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para obter mais informações, consulte Visão geral de explorações de script.For more information, see Script Exploits Overview.


<%@ 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 InsertItemTemplate Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView InsertItemTemplate Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."  
        runat="server">
        
        <rowstyle backcolor="LightGreen"
          wrap="false"/>
        <insertrowstyle backcolor="LightBlue"
          wrap="false"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="5">
                <asp:image id="CompanyLogoImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="NewButton"
                  text="New"
                  commandname="New"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <insertitemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="CompanyLogoEditImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b><asp:Label runat="server" 
                  AssociatedControlID="FirstNameInsertTextBox" 
                  Text="Name" />:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameInsertTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameInsertTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b><asp:Label runat="server" 
                  AssociatedControlID="TitleInsertTextBox" 
                  Text="Title" />:</b>
              </td>
              <td>
                <asp:textbox id="TitleInsertTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="InsertButton"
                  text="Insert"
                  commandname="Insert"
                  runat="server" />
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server" /> 
              </td>
            </tr>
          </table>       
        </insertitemtemplate> 
                  
      </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]"
        insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)"
        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 InsertItemTemplate Example</title>
</head>
<body>
    <form id="form1" runat="server">
        
      <h3>FormView InsertItemTemplate Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        emptydatatext="No employees found."  
        runat="server">
        
        <rowstyle backcolor="LightGreen"
          wrap="false"/>
        <insertrowstyle backcolor="LightBlue"
          wrap="false"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="5">
                <asp:image id="CompanyLogoImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="NewButton"
                  text="New"
                  commandname="New"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <insertitemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="CompanyLogoEditImage"
                  imageurl="~/Images/Logo.jpg"
                  alternatetext="Company logo"
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b><asp:Label runat="server" 
                  AssociatedControlID="FirstNameInsertTextBox" 
                  Text="Name" />:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameInsertTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameInsertTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b><asp:Label runat="server" 
                  AssociatedControlID="TitleInsertTextBox" 
                  Text="Title" />:</b>
              </td>
              <td>
                <asp:textbox id="TitleInsertTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="InsertButton"
                  text="Insert"
                  commandname="Insert"
                  runat="server" />
                <asp:linkbutton id="CancelButton"
                  text="Cancel"
                  commandname="Cancel"
                  runat="server" /> 
              </td>
            </tr>
          </table>       
        </insertitemtemplate> 
                  
      </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]"
        insertcommand="Insert Into [Employees] ([LastName], [FirstName], [Title]) VALUES (@LastName, @FirstName, @Title)"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>

Comentários

Neste tópico:In this topic:

IntroduçãoIntroduction

O controle de FormView é usado para exibir um único registro de uma fonte de dados.The FormView control is used to display a single record from a data source. Ele é semelhante ao controle de DetailsView, exceto pelo fato de que ele exibe modelos definidos pelo usuário em vez de campos de linha.It is similar to the DetailsView control, except it displays user-defined templates instead of row fields. Criar seus próprios modelos proporciona maior flexibilidade no controle de como os dados são exibidos.Creating your own templates gives you greater flexibility in controlling how the data is displayed. O controle FormView dá suporte aos seguintes recursos:The FormView control supports the following features:

  • Associação a controles de fonte de dados, como SqlDataSource e ObjectDataSource.Binding to data source controls, such as SqlDataSource and ObjectDataSource.

  • Recursos internos de inserção.Built-in inserting capabilities.

  • Recursos internos de atualização e exclusão.Built-in updating and deleting capabilities.

  • Recursos de paginação internos.Built-in paging capabilities.

  • Acesso programático ao modelo de objeto FormView para definir propriedades dinamicamente, manipular eventos e assim por diante.Programmatic access to the FormView object model to dynamically set properties, handle events, and so on.

  • Aparência personalizável por meio de modelos, temas e estilos definidos pelo usuário.Customizable appearance through user-defined templates, themes, and styles.

ModelosTemplates

Para que o controle de FormView exiba conteúdo, você precisa criar modelos para as diferentes partes do controle.For the FormView control to display content, you need to create templates for the different parts of the control. A maioria dos modelos são opcionais; no entanto, você deve criar um modelo para o modo no qual o controle está configurado.Most templates are optional; however, you must create a template for the mode in which the control is configured. Por exemplo, um controle de FormView que dá suporte à inserção de registros deve ter um modelo de inserção de item definido.For example, a FormView control that supports inserting records must have an insert item template defined. A tabela a seguir lista os diferentes modelos que você pode criar.The following table lists the different templates that you can create.

Tipo do modeloTemplate type DescriçãoDescription
EditItemTemplate Define o conteúdo da linha de dados quando o controle de FormView está no modo de edição.Defines the content for the data row when the FormView control is in edit mode. Esse modelo geralmente contém controles de entrada e botões de comando com os quais o usuário pode editar um registro existente.This template usually contains input controls and command buttons with which the user can edit an existing record.
EmptyDataTemplate Define o conteúdo da linha de dados vazia exibida quando o controle de FormView está associado a uma fonte de dados que não contém nenhum registro.Defines the content for the empty data row displayed when the FormView control is bound to a data source that does not contain any records. Esse modelo geralmente contém conteúdo para alertar o usuário que a fonte de dados não contém nenhum registro.This template usually contains content to alert the user that the data source does not contain any records.
FooterTemplate Define o conteúdo da linha de rodapé.Defines the content for the footer row. Esse modelo geralmente contém qualquer conteúdo adicional que você deseja exibir na linha de rodapé.This template usually contains any additional content you would like to display in the footer row. Observação: Como alternativa, você pode simplesmente especificar o texto a ser exibido na linha de rodapé, definindo a propriedade FooterText.Note: As an alternative, you can simply specify text to display in the footer row by setting the FooterText property.
HeaderTemplate Define o conteúdo da linha de cabeçalho.Defines the content for the header row. Esse modelo geralmente contém qualquer conteúdo adicional que você deseja exibir na linha de cabeçalho.This template usually contains any additional content you would like to display in the header row. Observação: Como alternativa, você pode simplesmente especificar o texto a ser exibido na linha de cabeçalho definindo a propriedade HeaderText.Note: As an alternative, you can simply specify text to display in the header row by setting the HeaderText property.
ItemTemplate Define o conteúdo da linha de dados quando o controle de FormView está no modo somente leitura.Defines the content for the data row when the FormView control is in read-only mode. Esse modelo geralmente contém conteúdo para exibir os valores de um registro existente.This template usually contains content to display the values of an existing record.
InsertItemTemplate Define o conteúdo da linha de dados quando o controle de FormView está no modo de inserção.Defines the content for the data row when the FormView control is in insert mode. Esse modelo geralmente contém controles de entrada e botões de comando com os quais o usuário pode adicionar um novo registro.This template usually contains input controls and command buttons with which the user can add a new record.
PagerTemplate Define o conteúdo para a linha do pager exibida quando o recurso de paginação é habilitado (quando a propriedade AllowPaging é definida como true).Defines the content for the pager row displayed when the paging feature is enabled (when the AllowPaging property is set to true). Esse modelo geralmente contém controles com os quais o usuário pode navegar para outro registro.This template usually contains controls with which the user can navigate to another record. Observação: O controle de FormView tem uma interface do usuário de linha de pager interna (IU).Note: The FormView control has a built-in pager row user interface (UI). Você precisará criar um modelo de pager somente se quiser criar sua própria linha de pager Personalizada.You need to create a pager template only if you want to create your own custom pager row.

Para exibir o valor de um campo em um modelo de item, use uma expressão de associação de dados.To display the value of a field in an item template, use a data binding expression. Para obter mais informações sobre expressões de ligação de dados, consulte sintaxe de expressão de vinculação de dados.For more information on data binding expressions, see Data-Binding Expression Syntax.

Os controles de entrada no modelo de edição de item e no modelo de inserção de item podem ser associados aos campos de uma fonte de dados usando uma expressão de associação bidirecional.Input controls in the edit item template and insert item template can be bound to the fields of a data source by using a two-way binding expression. Isso permite que o controle de FormView Extraia automaticamente os valores do controle de entrada para uma operação de atualização ou inserção.This allows the FormView control to automatically extract the values of the input control for an update or insert operation. As expressões de ligação bidirecionais também permitem que os controles de entrada em um modelo de edição de item exibam automaticamente os valores de campo originais.Two-way binding expressions also allow input controls in an edit item template to automatically display the original field values. Para obter mais informações sobre expressões de ligação bidirecionais, consulte associando a bancos de dados.For more information on two-way binding expressions, see Binding to Databases.

Associação a dadosBinding to Data

O controle de FormView pode ser associado a um controle de fonte de dados (como SqlDataSource, ObjectDataSourceou AccessDataSource) ou a qualquer coleção de fontes de dados que implemente a interface System.Collections.IEnumerable, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção.The FormView control can be bound to a data source control (such as SqlDataSource, ObjectDataSource, or AccessDataSource) or to any data source collection that implements the System.Collections.IEnumerable interface, such as System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>, or other collection types. Use um dos métodos a seguir para associar o controle de FormView ao tipo de fonte de dados apropriado:Use one of the following methods to bind the FormView control to the appropriate data source type:

  • Para associar a um controle da fonte de dados, defina a propriedade DataSourceID do controle FormView como o valor ID do controle da fonte de dados.To bind to a data source control, set the DataSourceID property of the FormView control to the ID value of the data source control. O controle de FormView é automaticamente associado ao controle da fonte de dados especificado e pode tirar proveito dos recursos do controle da fonte de dados para executar a inserção, atualização, exclusão e funcionalidade de paginação.The FormView control automatically binds to the specified data source control and can take advantage of the data source control's capabilities to perform inserting, updating, deleting, and paging functionality. Esse é o método preferencial para associar dados.This is the preferred method to bind to data.

  • Para associar a uma fonte de dados que implementa a interface System.Collections.IEnumerable, defina programaticamente a propriedade DataSource do controle de FormView com a fonte de dados e, em seguida, chame o método DataBind.To bind to a data source that implements the System.Collections.IEnumerable interface, programmatically set the DataSource property of the FormView control to the data source and then call the DataBind method. Ao usar esse método, o controle de FormView não fornece funcionalidade interna de inserção, atualização, exclusão e paginação.When using this method, the FormView control does not provide built-in inserting, updating, deleting, and paging functionality. Você precisa fornecer essa funcionalidade usando o evento apropriado.You need to provide this functionality by using the appropriate event.

Para obter mais informações sobre a vinculação de dados, consulte ASP.NET Data Access content map.For more information on data binding, see ASP.NET Data Access Content Map.

Observação

Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado.This control can be used to display user input, which might include malicious client script. Verifique todas as informações enviadas de um cliente para script executável, instruções SQL ou outro código antes de exibi-lo em seu aplicativo.Check any information that is sent from a client for executable script, SQL statements, or other code before displaying it in your application. Sempre que possível, é altamente recomendável que os valores sejam codificados em HTML antes de serem exibidos neste controle.Whenever possible, it is strongly recommended that values are HTML-encoded before they are displayed in this control. O ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear o script e o HTML na entrada do usuário.ASP.NET provides an input request validation feature to block script and HTML in user input. Os controles de servidor de validação também são fornecidos para avaliar a entrada do usuário.Validation server controls are also provided to assess user input. Para obter mais informações, consulte introdução aos controles de validação.For more information, see Introduction to the Validation Controls.

Operações de dadosData Operations

O controle de FormView fornece muitos recursos internos que permitem ao usuário atualizar, excluir, inserir e paginar os itens no controle.The FormView control provides many built-in capabilities that allow the user to update, delete, insert, and page through items in the control. Quando o controle de FormView está associado a um controle da fonte de dados, o controle de FormView pode tirar proveito dos recursos do controle da fonte de dados e fornecer a funcionalidade de atualização, exclusão, inserção e paginação automática.When the FormView control is bound to a data source control, the FormView control can take advantage of the data source control's capabilities and provide automatic updating, deleting, inserting, and paging functionality.

Observação

O controle de FormView pode fornecer suporte para operações de atualização, exclusão, inserção e paginação com outros tipos de fontes de dados; no entanto, você deve fornecer um manipulador de eventos apropriado com a implementação para essas operações.The FormView control can provide support for update, delete, insert, and paging operations with other types of data sources; however, you must provide an appropriate event handler with the implementation for these operations.

Como o controle de FormView usa modelos, ele não fornece uma maneira de gerar automaticamente botões de comando para executar as operações de atualização, exclusão ou inserção.Because the FormView control uses templates, it does not provide a way to automatically generate command buttons to perform updating, deleting, or inserting operations. Você deve incluir manualmente esses botões de comando no modelo apropriado.You must manually include these command buttons in the appropriate template. O controle de FormView reconhece determinados botões que têm suas propriedades CommandName definidas como valores específicos.The FormView control recognizes certain buttons that have their CommandName properties set to specific values. A tabela a seguir lista os botões de comando que o controle de FormView reconhece.The following table lists the command buttons that the FormView control recognizes.

BotãoButton Valor de CommandNameCommandName value DescriçãoDescription
CancelarCancel Cancela"Cancel" Usado na atualização ou inserção de operações para cancelar a operação e para descartar os valores inseridos pelo usuário.Used in updating or inserting operations to cancel the operation and to discard the values entered by the user. O controle de FormView retorna para o modo especificado pela propriedade DefaultMode.The FormView control then returns to the mode specified by the DefaultMode property.
ExcluirDelete Apagar"Delete" Usado na exclusão de operações para excluir o registro exibido da fonte de dados.Used in deleting operations to delete the displayed record from the data source. Gera os eventos ItemDeleting e ItemDeleted.Raises the ItemDeleting and ItemDeleted events.
EditarEdit Editar"Edit" Usado na atualização de operações para colocar o controle de FormView no modo de edição.Used in updating operations to put the FormView control in edit mode. O conteúdo especificado na propriedade EditItemTemplate é exibido para a linha de dados.The content specified in the EditItemTemplate property is displayed for the data row.
InserirInsert Inserido"Insert" Usado em operações de inserção para tentar inserir um novo registro na fonte de dados usando os valores fornecidos pelo usuário.Used in inserting operations to attempt to insert a new record in the data source using the values provided by the user. Gera os eventos ItemInserting e ItemInserted.Raises the ItemInserting and ItemInserted events.
NovoNew Outra"New" Usado em operações de inserção para colocar o controle de FormView no modo de inserção.Used in inserting operations to put the FormView control in insert mode. O conteúdo especificado na propriedade InsertItemTemplate é exibido para a linha de dados.The content specified in the InsertItemTemplate property is displayed for the data row.
{1>Página<1}Page Web"Page" Usado em operações de paginação para representar um botão na linha do pager que executa a paginação.Used in paging operations to represent a button in the pager row that performs paging. Para especificar a operação de paginação, defina a propriedade CommandArgument do botão como "Avançar", "anterior", "primeiro", "último" ou o índice da página na qual navegar.To specify the paging operation, set the CommandArgument property of the button to "Next", "Prev", "First", "Last", or the index of the page to which to navigate. Gera os eventos PageIndexChanging e PageIndexChanged.Raises the PageIndexChanging and PageIndexChanged events. Observação: Esse tipo de botão geralmente é usado apenas no modelo de pager.Note: This type of button is typically used only in the pager template.
AtualizarUpdate Cumulativo"Update" Usado na atualização de operações para tentar atualizar o registro exibido na fonte de dados com os valores fornecidos pelo usuário.Used in updating operations to attempt to update the displayed record in the data source with the values provided by the user. Gera os eventos ItemUpdating e ItemUpdated.Raises the ItemUpdating and ItemUpdated events.

Ao contrário do botão de exclusão (que exclui imediatamente o registro exibido), quando o botão Editar ou novo é clicado, o controle de FormView entra no modo de edição ou inserção, respectivamente.Unlike the Delete button (which deletes the displayed record immediately), when the Edit or New button is clicked, the FormView control goes into edit or insert mode, respectively. No modo de edição, o conteúdo contido na propriedade EditItemTemplate é exibido para o item de dados atual.In edit mode, the content contained in the EditItemTemplate property is displayed for the current data item. Normalmente, o modelo editar item é definido de modo que o botão Editar seja substituído por uma atualização e um botão Cancelar.Typically, the edit item template is defined such that the Edit button is replaced with an Update and a Cancel button. Os controles de entrada que são apropriados para o tipo de dados do campo (como um TextBox ou um controle de CheckBox) geralmente são exibidos com o valor de um campo para que o usuário modifique.Input controls that are appropriate for the field's data type (such as a TextBox or a CheckBox control) are also usually displayed with a field's value for the user to modify. Clicar no botão atualizar atualiza o registro na fonte de dados, enquanto clicar no botão Cancelar abandona as alterações.Clicking the Update button updates the record in the data source, while clicking the Cancel button abandons any changes.

Da mesma forma, o conteúdo contido na propriedade InsertItemTemplate é exibido para o item de dados quando o controle está no modo de inserção.Likewise, the content contained in the InsertItemTemplate property is displayed for the data item when the control is in insert mode. O modelo de inserção de item geralmente é definido de modo que o novo botão seja substituído por um botão de inserção e cancelamento, e controles de entrada vazios são exibidos para que o usuário insira os valores para o novo registro.The insert item template is typically defined such that the New button is replaced with an Insert and a Cancel button, and empty input controls are displayed for the user to enter the values for the new record. Clicar no botão Inserir insere o registro na fonte de dados, enquanto clicar no botão Cancelar abandona as alterações.Clicking the Insert button inserts the record in the data source, while clicking the Cancel button abandons any changes.

O controle FormView fornece um recurso de paginação, que permite ao usuário navegar para outros registros na fonte de dados.The FormView control provides a paging feature, which allows the user to navigate to other records in the data source. Quando habilitada, uma linha de pager é exibida no controle de FormView que contém os controles de navegação de página.When enabled, a pager row is displayed in the FormView control that contains the page navigation controls. Para habilitar a paginação, defina a propriedade AllowPaging como true.To enable paging, set the AllowPaging property to true. Você pode personalizar a linha do pager definindo as propriedades dos objetos contidos no PagerStyle e a propriedade PagerSettings.You can customize the pager row by setting the properties of objects contained in the PagerStyle and the PagerSettings property. Em vez de usar a interface do usuário de linha do pager interna, você pode criar sua própria interface do usuário usando a propriedade PagerTemplate.Instead of using the built-in pager row UI, you can create your own UI by using the PagerTemplate property.

Personalizando a interface do usuárioCustomizing the User Interface

Você pode personalizar a aparência do controle de FormView definindo as propriedades de estilo para as diferentes partes do controle.You can customize the appearance of the FormView control by setting the style properties for the different parts of the control. A tabela a seguir lista as propriedades de estilo diferentes.The following table lists the different style properties.

Propriedade de estiloStyle property DescriçãoDescription
EditRowStyle As configurações de estilo da linha de dados quando o controle de FormView está no modo de edição.The style settings for the data row when the FormView control is in edit mode.
EmptyDataRowStyle As configurações de estilo para a linha de dados vazia exibida no controle de FormView quando a fonte de dados não contém nenhum registro.The style settings for the empty data row displayed in the FormView control when the data source does not contain any records.
FooterStyle As configurações de estilo da linha de rodapé do controle de FormView.The style settings for the footer row of the FormView control.
HeaderStyle As configurações de estilo da linha de cabeçalho do controle de FormView.The style settings for the header row of the FormView control.
InsertRowStyle As configurações de estilo para a linha de dados quando o controle de FormView está no modo de inserção.The style settings for the data row when the FormView control is in insert mode.
PagerStyle As configurações de estilo para a linha do pager exibida no controle de FormView quando o recurso de paginação está habilitado.The style settings for the pager row displayed in the FormView control when the paging feature is enabled.
RowStyle As configurações de estilo para a linha de dados quando o controle de FormView está no modo somente leitura.The style settings for the data row when the FormView control is in read-only mode.

EventosEvents

O controle de FormView fornece vários eventos com os quais você pode programar.The FormView control provides several events that you can program against. Isso permite que você execute uma rotina personalizada sempre que um evento ocorrer.This allows you to run a custom routine whenever an event occurs. A tabela a seguir lista os eventos com suporte pelo controle de FormView.The following table lists the events supported by the FormView control.

{1>Evento<1}Event DescriçãoDescription
ItemCommand Ocorre quando um botão é clicado dentro de um controle FormView.Occurs when a button within a FormView control is clicked. Esse evento é geralmente usado para executar uma tarefa quando um botão é clicado no controle.This event is often used to perform a task when a button is clicked in the control.
ItemCreated Ocorre depois que todos os objetos de FormViewRow são criados no controle de FormView.Occurs after all FormViewRow objects are created in the FormView control. Esse evento é geralmente usado para modificar os valores de um registro antes que ele seja exibido.This event is often used to modify the values of a record before it is displayed.
ItemDeleted Ocorre quando um botão de exclusão (um botão com sua propriedade CommandName definido como "excluir") é clicado, mas depois que o controle de FormView exclui o registro da fonte de dados.Occurs when a Delete button (a button with its CommandName property set to "Delete") is clicked, but after the FormView control deletes the record from the data source. Esse evento é geralmente usado para verificar os resultados da operação de exclusão.This event is often used to check the results of the delete operation.
ItemDeleting Ocorre quando um botão de exclusão é clicado, mas antes de o controle de FormView excluir o registro da fonte de dados.Occurs when a Delete button is clicked, but before the FormView control deletes the record from the data source. Esse evento é geralmente usado para cancelar a operação de exclusão.This event is often used to cancel the delete operation.
ItemInserted Ocorre quando um botão de inserção (um botão com sua propriedade CommandName definido como "Insert") é clicado, mas depois que o controle de FormView insere o registro.Occurs when an Insert button (a button with its CommandName property set to "Insert") is clicked, but after the FormView control inserts the record. Esse evento é geralmente usado para verificar os resultados da operação de inserção.This event is often used to check the results of the insert operation.
ItemInserting Ocorre quando um botão de inserção é clicado, mas antes de o controle de FormView inserir o registro.Occurs when an Insert button is clicked, but before the FormView control inserts the record. Esse evento é geralmente usado para cancelar a operação de inserção.This event is often used to cancel the insert operation.
ItemUpdated Ocorre quando um botão de atualização (um botão com sua propriedade CommandName definido como "Update") é clicado, mas depois que o controle de FormView atualiza a linha.Occurs when an Update button (a button with its CommandName property set to "Update") is clicked, but after the FormView control updates the row. Esse evento é geralmente usado para verificar os resultados da operação de atualização.This event is often used to check the results of the update operation.
ItemUpdating Ocorre quando um botão de atualização é clicado, mas antes de o controle de FormView atualizar o registro.Occurs when an Update button is clicked, but before the FormView control updates the record. Esse evento é geralmente usado para cancelar a operação de atualização.This event is often used to cancel the update operation.
ModeChanged Ocorre depois que o controle de FormView altera os modos (para edição, inserção ou modo somente leitura).Occurs after the FormView control changes modes (to edit, insert, or read-only mode). Esse evento é geralmente usado para executar uma tarefa quando o controle de FormView altera os modos.This event is often used to perform a task when the FormView control changes modes.
ModeChanging Ocorre antes que o controle de FormView altere os modos (para edição, inserção ou modo somente leitura).Occurs before the FormView control changes modes (to edit, insert, or read-only mode). Esse evento é geralmente usado para cancelar uma alteração no modo.This event is often used to cancel a mode change.
PageIndexChanged Ocorre quando um dos botões de paginação é acionado, mas após o controle FormView manipular a operação de paginação.Occurs when one of the pager buttons is clicked, but after the FormView control handles the paging operation. Esse evento é normalmente usado quando você precisa executar uma tarefa depois que o usuário navega para um registro diferente no controle.This event is commonly used when you need to perform a task after the user navigates to a different record in the control.
PageIndexChanging Ocorre quando um dos botões de paginação é acionado, mas antes de o controle FormView manipular a operação de paginação.Occurs when one of the pager buttons is clicked, but before the FormView control handles the paging operation. Esse evento é geralmente usado para cancelar a operação de paginação.This event is often used to cancel the paging operation.

AcessibilidadeAccessibility

Para obter informações sobre como configurar esse controle para que ele gere marcação que esteja de acordo com os padrões de acessibilidade, consulte acessibilidade no Visual Studio e controles e acessibilidadeASP.net e ASP.net.For information about how to configure this control so that it generates markup that conforms to accessibility standards, see Accessibility in Visual Studio and ASP.NET and ASP.NET Controls and Accessibility.

Aplicando estilos CSSApplying CSS Styles

O controle FormView permite que você especifique as regras de estilo CSS na marcação.The FormView control lets you specify CSS style rules in markup. Se você usar modelos para personalizar a aparência do controle de FormView, poderá especificar estilos de CSS na marcação nos modelos.If you use templates to customize the appearance of the FormView control, you can specify CSS styles in the markup in the templates. Nesse caso, nenhuma tabela externa extra é necessária.In that case, no extra outer table is required. Você pode impedir que a tabela seja processada definindo a propriedade RenderOuterTable como false.You can prevent the table from being rendered by setting the RenderOuterTable property to false.

Sintaxe declarativaDeclarative Syntax

<asp:FormView
    AccessKey="string"
    AllowPaging="True|False"
    BackColor="color name|#dddddd"
    BackImageUrl="uri"
    BorderColor="color name|#dddddd"
    BorderStyle="NotSet|None|Dotted|Dashed|Solid|Double|Groove|Ridge|
        Inset|Outset"
    BorderWidth="size"
    Caption="string"
    CaptionAlign="NotSet|Top|Bottom|Left|Right"
    CellPadding="integer"
    CellSpacing="integer"
    CssClass="string"
    DataKeyNames="string"
    DataMember="string"
    DataSource="string"
    DataSourceID="string"
    DefaultMode="ReadOnly|Edit|Insert"
    EmptyDataText="string"
    Enabled="True|False"
    EnableTheming="True|False"
    EnableViewState="True|False"
    Font-Bold="True|False"
    Font-Italic="True|False"
    Font-Names="string"
    Font-Overline="True|False"
    Font-Size="string|Smaller|Larger|XX-Small|X-Small|Small|Medium|
        Large|X-Large|XX-Large"
    Font-Strikeout="True|False"
    Font-Underline="True|False"
    FooterText="string"
    ForeColor="color name|#dddddd"
    GridLines="None|Horizontal|Vertical|Both"
    HeaderText="string"
    Height="size"
    HorizontalAlign="NotSet|Left|Center|Right|Justify"
    ID="string"
    OnDataBinding="DataBinding event handler"
    OnDataBound="DataBound event handler"
    OnDisposed="Disposed event handler"
    OnInit="Init event handler"
    OnItemCommand="ItemCommand event handler"
    OnItemCreated="ItemCreated event handler"
    OnItemDeleted="ItemDeleted event handler"
    OnItemDeleting="ItemDeleting event handler"
    OnItemInserted="ItemInserted event handler"
    OnItemInserting="ItemInserting event handler"
    OnItemUpdated="ItemUpdated event handler"
    OnItemUpdating="ItemUpdating event handler"
    OnLoad="Load event handler"
    OnModeChanged="ModeChanged event handler"
    OnModeChanging="ModeChanging event handler"
    OnPageIndexChanged="PageIndexChanged event handler"
    OnPageIndexChanging="PageIndexChanging event handler"
    OnPreRender="PreRender event handler"
    OnUnload="Unload event handler"
    PageIndex="integer"
    PagerSettings-FirstPageImageUrl="uri"
    PagerSettings-FirstPageText="string"
    PagerSettings-LastPageImageUrl="uri"
    PagerSettings-LastPageText="string"
    PagerSettings-Mode="NextPrevious|Numeric|NextPreviousFirstLast|
        NumericFirstLast"
    PagerSettings-NextPageImageUrl="uri"
    PagerSettings-NextPageText="string"
    PagerSettings-PageButtonCount="integer"
    PagerSettings-Position="Bottom|Top|TopAndBottom"
    PagerSettings-PreviousPageImageUrl="uri"
    PagerSettings-PreviousPageText="string"
    PagerSettings-Visible="True|False"
    RenderTable="True|False"
    runat="server"
    SkinID="string"
    Style="string"
    TabIndex="integer"
    ToolTip="string"
    Visible="True|False"
    Width="size"
>
        <EditItemTemplate>
            <!-- child controls -->
        </EditItemTemplate>
        <EditRowStyle />
        <EmptyDataRowStyle />
        <EmptyDataTemplate>
            <!-- child controls -->
        </EmptyDataTemplate>
        <FooterStyle />
        <FooterTemplate>
            <!-- child controls -->
        </FooterTemplate>
        <HeaderStyle />
        <HeaderTemplate>
            <!-- child controls -->
        </HeaderTemplate>
        <InsertItemTemplate>
            <!-- child controls -->
        </InsertItemTemplate>
        <InsertRowStyle />
        <ItemTemplate>
            <!-- child controls -->
        </ItemTemplate>
        <PagerSettings
            FirstPageImageUrl="uri"
            FirstPageText="string"
            LastPageImageUrl="uri"
            LastPageText="string"
            Mode="NextPrevious|Numeric|NextPreviousFirstLast|
                NumericFirstLast"
            NextPageImageUrl="uri"
            NextPageText="string"
            OnPropertyChanged="PropertyChanged event handler"
            PageButtonCount="integer"
            Position="Bottom|Top|TopAndBottom"
            PreviousPageImageUrl="uri"
            PreviousPageText="string"
            Visible="True|False"
        />
        <PagerStyle />
        <PagerTemplate>
            <!-- child controls -->
        </PagerTemplate>
        <RowStyle />
</asp:FormView>

Construtores

FormView()

Inicializa uma nova instância da classe FormView.Initializes a new instance of the FormView class.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.Gets or sets the access key that allows you to quickly navigate to the Web server control.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.Gets the browser-specific adapter for the control.

(Herdado de Control)
AllowPaging

Obtém ou define um valor que indica se o recurso de paginação está habilitado.Gets or sets a value indicating whether the paging feature is enabled.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.Gets or sets the application-relative virtual directory of the Page or UserControl object that contains this control.

(Herdado de Control)
Attributes

Obtém a coleção de atributos arbitrários (somente para renderização) que não correspondem às propriedades do controle.Gets the collection of arbitrary attributes (for rendering only) that do not correspond to properties on the control.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.Gets or sets the background color of the Web server control.

(Herdado de WebControl)
BackImageUrl

Obtém ou define a URL para uma imagem a ser exibida na tela de fundo de um controle FormView.Gets or sets the URL to an image to display in the background of a FormView control.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.Gets the control that contains this control's data binding.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.Gets or sets the border color of the Web control.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.Gets or sets the border style of the Web server control.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.Gets or sets the border width of the Web server control.

(Herdado de WebControl)
BottomPagerRow

Obtém o objeto FormViewRow que representa a linha de paginação exibida na parte inferior do controle FormView.Gets the FormViewRow object that represents the pager row displayed at the bottom of the FormView control.

Caption

Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle FormView.Gets or sets the text to render in an HTML caption element in a FormView control. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.This property is provided to make the control more accessible to users of assistive technology devices.

CaptionAlign

Obtém ou define a posição horizontal ou vertical de um elemento de legenda HTML em um controle FormView.Gets or sets the horizontal or vertical position of the HTML caption element in a FormView control. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.This property is provided to make the control more accessible to users of assistive technology devices.

CellPadding

Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula.Gets or sets the amount of space between the contents of a cell and the cell's border.

CellSpacing

Obtém ou define a quantidade de espaço entre células.Gets or sets the amount of space between cells.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.Gets a value that indicates whether the server control's child controls have been created.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.Gets the control ID for HTML markup that is generated by ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.Gets or sets the algorithm that is used to generate the value of the ClientID property.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.Gets a character value representing the separator character used in the ClientID property.

(Herdado de Control)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.Gets the HttpContext object associated with the server control for the current Web request.

(Herdado de Control)
Controls

Obtém uma coleção dos controles filho no controle com limite de dados de composição.Gets a collection of the child controls within the composite data-bound control.

(Herdado de CompositeDataBoundControl)
ControlStyle

Obtém o estilo de um controle de servidor Web.Gets the style of the Web server control. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle.Gets a value indicating whether a Style object has been created for the ControlStyle property. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is primarily used by control developers.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.Gets or sets the Cascading Style Sheet (CSS) class rendered by the Web server control on the client.

(Herdado de WebControl)
CurrentMode

Obtém o modo de entrada de dados atual do controle FormView.Gets the current data-entry mode of the FormView control.

DataItem

Obtém o item de dados associado ao controle FormView.Gets the data item bound to the FormView control.

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.Gets a reference to the naming container if the naming container implements IDataItemContainer.

(Herdado de Control)
DataItemCount

Obtém o número de itens de dados na fonte de dados.Gets the number of data items in the data source.

DataItemIndex

Obtém o índice do item de dados associado ao controle FormView da fonte de dados.Gets the index of the data item bound to the FormView control from the data source.

DataKey

Obtém um objeto DataKey que representa a chave primária do registro exibido.Gets a DataKey object that represents the primary key of the displayed record.

DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave da fonte de dados.Gets or sets an array that contains the names of the key fields for the data source.

DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataKeysControl.Gets a reference to the naming container if the naming container implements IDataKeysControl.

(Herdado de Control)
DataMember

Obtém ou define o nome da lista de dados ao qual o controle com limite de dados está associado, nos casos em que a fonte de dados contém mais de uma lista distinta de itens de dados.Gets or sets the name of the list of data that the data-bound control binds to, in cases where the data source contains more than one distinct list of data items.

(Herdado de DataBoundControl)
DataSource

Obtém ou define o objeto do qual o controle com limite de dados recupera sua lista de itens de dados.Gets or sets the object from which the data-bound control retrieves its list of data items.

(Herdado de BaseDataBoundControl)
DataSourceID

Obtém ou define a ID do controle do qual o controle associado a dados recupera sua lista de itens de dados.Gets or sets the ID of the control from which the data-bound control retrieves its list of data items.

(Herdado de DataBoundControl)
DataSourceObject

Obtém um objeto que implementa a interface IDataSource , que fornece acesso ao conteúdo de dados do objeto.Gets an object that implements the IDataSource interface, which provides access to the object's data content.

(Herdado de DataBoundControl)
DefaultMode

Obtém ou define o modo de entrada de dados ao qual o controle FormView retorna após uma operação de atualização, inserção ou cancelamento.Gets or sets the data-entry mode to which the FormView control returns after an update, insert, or cancel operation.

DeleteMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de exclusão.Gets or sets the name of the method on the page that is called when the control performs a delete operation.

DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.Gets a value indicating whether a control is being used on a design surface.

(Herdado de Control)
EditItemTemplate

Obtém ou define o conteúdo personalizado para um item no modo de edição.Gets or sets the custom content for an item in edit mode.

EditRowStyle

Obtém uma referência ao objeto TableItemStyle que permite que você defina a aparência da linha de dados quando um controle FormView está em modo de edição.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row when a FormView control is in edit mode.

EmptyDataRowStyle

Obtém uma referência ao 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.Gets a reference to the TableItemStyle object that allows you to set the appearance of the empty data row displayed when the data source bound to a FormView control does not contain any records.

EmptyDataTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de dados vazia renderizada quando um controle FormView é associado a uma fonte de dados que não contém registros.Gets or sets the user-defined content for the empty data row rendered when a FormView control is bound to a data source that does not contain any records.

EmptyDataText

Obtém ou define o texto a ser exibido na linha de dados vazia renderizada quando um controle FormView é associado a uma fonte de dados que não contém registros.Gets or sets the text to display in the empty data row rendered when a FormView control is bound to a data source that does not contain any records.

Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.Gets or sets a value indicating whether the Web server control is enabled.

(Herdado de WebControl)
EnableModelValidation

Obtém ou define um valor que indica se um controle de validador vai manipular exceções que ocorrem durante as operações de inserção ou atualização.Gets or sets a value that indicates whether a validator control will handle exceptions that occur during insert or update operations.

EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.Gets or sets a value indicating whether themes apply to this control.

(Herdado de WebControl)
EnableViewState

Obtém ou define um valor que indica se o controle de servidor persiste seu estado de exibição e o estado de exibição de quaisquer controles filho que ele contém, para o cliente solicitante.Gets or sets a value indicating whether the server control persists its view state, and the view state of any child controls it contains, to the requesting client.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle.Gets a list of event handler delegates for the control. Esta propriedade é somente para leitura.This property is read-only.

(Herdado de Control)
Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.Gets the font properties associated with the Web server control.

(Herdado de WebControl)
FooterRow

Obtém o objeto FormViewRow que representa a linha de rodapé em um controle FormView.Gets the FormViewRow object that represents the footer row in a FormView control.

FooterStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de rodapé em um controle FormView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the footer row in a FormView control.

FooterTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de rodapé em um controle FormView.Gets or sets the user-defined content for the footer row in a FormView control.

FooterText

Obtém ou define o texto a ser exibido na linha de rodapé de um controle FormView.Gets or sets the text to display in the footer row of a FormView control.

ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.Gets or sets the foreground color (typically the color of the text) of the Web server control.

(Herdado de WebControl)
GridLines

Obtém ou define o estilo das linhas de grade para um controle FormView.Gets or sets the gridline style for a FormView control.

HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.Gets a value indicating whether the control has attributes set.

(Herdado de WebControl)
HasChildViewState

Obtém um valor que indica se os controles filho do controle de servidor atual têm alguma configuração de estado de exibição salva.Gets a value indicating whether the current server control's child controls have any saved view-state settings.

(Herdado de Control)
HeaderRow

Obtém o objeto FormViewRow que representa a linha de cabeçalho em um controle FormView.Gets the FormViewRow object that represents the header row in a FormView control.

HeaderStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de cabeçalho em um controle FormView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the header row in a FormView control.

HeaderTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de cabeçalho em um controle FormView.Gets or sets the user-defined content for the header row in a FormView control.

HeaderText

Obtém ou define o texto a ser exibido na linha de cabeçalho de um controle FormView.Gets or sets the text to display in the header row of a FormView control.

Height

Obtém ou define a altura do controle do servidor Web.Gets or sets the height of the Web server control.

(Herdado de WebControl)
HorizontalAlign

Obtém ou define o alinhamento horizontal de um controle FormView na página.Gets or sets the horizontal alignment of a FormView control on the page.

ID

Obtém ou define o identificador programático atribuído ao controle de servidor.Gets or sets the programmatic identifier assigned to the server control.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.Gets the character used to separate control identifiers.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controle associado a dados foi inicializado.Gets a value indicating whether the data-bound control has been initialized.

(Herdado de BaseDataBoundControl)
InsertItemTemplate

Obtém ou define o conteúdo personalizado para um item no modo de inserção.Gets or sets the custom content for an item in insert mode.

InsertMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de inserção.Gets or sets the name of the method on the page that is called when the control performs an insert operation.

InsertRowStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de dados em um controle FormView quando o controle está em modo de inserção.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row in a FormView control when the control is in insert mode.

IsBoundUsingDataSourceID

Obtém um valor que indica se a propriedade DataSourceID foi definida.Gets a value indicating whether the DataSourceID property is set.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.Gets a value indicating whether controls contained within this control have control state.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a associação de dados é automática.Gets a value that indicates whether data binding is automatic.

(Herdado de BaseDataBoundControl)
IsEnabled

Obtém um valor que indica se o controle está habilitado.Gets a value indicating whether the control is enabled.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.Gets a value that indicates whether the server control is saving changes to its view state.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se o model binding está em uso.Gets a value that indicates whether model binding is in use.

(Herdado de CompositeDataBoundControl)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.Gets a value indicating whether view state is enabled for this control.

(Herdado de Control)
ItemTemplate

Obtém ou define o conteúdo personalizado para a linha de dados em um controle FormView quando o controle está no modo somente leitura.Gets or sets the custom content for the data row in a FormView control when the control is in read-only mode.

ItemType

Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos.Gets or sets the name of the data item type for strongly typed data binding.

(Herdado de DataBoundControl)
LoadViewStateByID

Obtém um valor que indica se o controle participa do carregamento do estado de exibição por ID em vez do índice.Gets a value indicating whether the control participates in loading its view state by ID instead of index.

(Herdado de Control)
NamingContainer

Obtém uma referência ao contêiner de nomenclatura do controle do servidor, que cria um namespace exclusivo para diferenciar entre os controles de servidor com o mesmo valor da propriedade ID.Gets a reference to the server control's naming container, which creates a unique namespace for differentiating between server controls with the same ID property value.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.Gets a reference to the Page instance that contains the server control.

(Herdado de Control)
PageCount

Obtém o número total de páginas necessárias para exibir cada registro na fonte de dados.Gets the total number of pages required to display every record in the data source.

PageIndex

Obtém ou define o índice da página exibida.Gets or sets the index of the displayed page.

PagerSettings

Obtém uma referência ao objeto PagerSettings que permite definir as propriedades dos botões de paginação em um controle FormView.Gets a reference to the PagerSettings object that allows you to set the properties of the pager buttons in a FormView control.

PagerStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de paginação em um controle FormView.Gets a reference to the TableItemStyle object that allows you to set the appearance of the pager row in a FormView control.

PagerTemplate

Obtém ou define o conteúdo personalizado para a linha do pager em um controle FormView.Gets or sets the custom content for the pager row in a FormView control.

Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.Gets a reference to the server control's parent control in the page control hierarchy.

(Herdado de Control)
RenderingCompatibility

Obtém um valor que especifica a versão do ASP.NET com a qual o HTML renderizado será compatível.Gets a value that specifies the ASP.NET version that rendered HTML will be compatible with.

(Herdado de Control)
RenderOuterTable

Obtém ou define um valor que indica se o controle circunscreve HTML renderizado em um elemento table para aplicar estilos embutidos.Gets or sets a value that indicates whether the control encloses rendered HTML in a table element in order to apply inline styles.

RequiresDataBinding

Obtém ou define um valor que indica se o método DataBind() deve ser cancelado.Gets or sets a value indicating whether the DataBind() method should be called.

(Herdado de BaseDataBoundControl)
Row

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.

RowStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de dados em um controle FormView quando o controle está em modo somente leitura.Gets a reference to the TableItemStyle object that allows you to set the appearance of the data row in a FormView control when the control is in read-only mode.

SelectArguments

Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados.Gets a DataSourceSelectArguments object that the data-bound control uses when retrieving data from a data source control.

(Herdado de DataBoundControl)
SelectedValue

Obtém o valor da chave de dados do registro atual em um controle FormView.Gets the data key value of the current record in a FormView control.

SelectMethod

O nome do método a ser chamado para ler os dados.The name of the method to call in order to read data.

(Herdado de DataBoundControl)
Site

Obtém informações sobre o contêiner que hospeda o controle atual quando renderizados em uma superfície de design.Gets information about the container that hosts the current control when rendered on a design surface.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.Gets or sets the skin to apply to the control.

(Herdado de WebControl)
Style

Obtém uma coleção de atributos de texto que serão renderizados como um atributo de estilo na marca externa do controle de servidor Web.Gets a collection of text attributes that will be rendered as a style attribute on the outer tag of the Web server control.

(Herdado de WebControl)
SupportsDisabledAttribute

Obtém um valor que indica se o controle deve definir o atributo disabled do elemento HTML renderizado para "desabilitado" quando a propriedade do controle IsEnabled é false.Gets a value that indicates whether the control should set the disabled attribute of the rendered HTML element to "disabled" when the control's IsEnabled property is false.

(Herdado de BaseDataBoundControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.Gets or sets the tab index of the Web server control.

(Herdado de WebControl)
TagKey

Obtém o valor HtmlTextWriterTag do controle FormView.Gets the HtmlTextWriterTag value for the FormView control.

TagName

Obtém o nome da marca de controle.Gets the name of the control tag. Essa propriedade é usada principalmente por desenvolvedores de controle.This property is used primarily by control developers.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.Gets or sets a reference to the template that contains this control.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.Gets the virtual directory of the Page or UserControl that contains the current server control.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.Gets or sets the text displayed when the mouse pointer hovers over the Web server control.

(Herdado de WebControl)
TopPagerRow

Obtém o objeto FormViewRow que representa a linha de paginação exibida na parte superior de um controle FormView.Gets the FormViewRow object that represents the pager row displayed at the top of a FormView control.

UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.Gets the unique, hierarchically qualified identifier for the server control.

(Herdado de Control)
UpdateMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de atualização.Gets or sets the name of the method on the page that is called when the control performs an update operation.

ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.Gets or sets a value that indicates whether the control checks client input from the browser for potentially dangerous values.

(Herdado de Control)
ViewState

Obtém um dicionário de informações de estado que permite salvar e restaurar o estado de exibição de um controle de servidor em várias solicitações para a mesma página.Gets a dictionary of state information that allows you to save and restore the view state of a server control across multiple requests for the same page.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.Gets a value that indicates whether the StateBag object is case-insensitive.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.Gets or sets the view-state mode of this control.

(Herdado de Control)
Visible

Obtém ou define um valor que indica se um controle de servidor é renderizado como uma interface do usuário na página.Gets or sets a value that indicates whether a server control is rendered as UI on the page.

(Herdado de Control)
Width

Obtém ou define a largura do controle de servidor Web.Gets or sets the width of the Web server control.

(Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado.Adds HTML attributes and styles that need to be rendered to the specified HtmlTextWriterTag. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.Called after a child control is added to the Controls collection of the Control object.

(Herdado de Control)
AddParsedSubObject(Object)

Notifica o controle de servidor de que um elemento, XML ou HTML, foi analisado e adiciona o elemento ao objeto ControlCollection do controle de servidor.Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.

(Herdado de Control)
ApplyStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, substituindo os elementos de estilo existentes no controle.Copies any nonblank elements of the specified style to the Web control, overwriting any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controles.This method is primarily used by control developers.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.Applies the style properties defined in the page style sheet to the control.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.Begins design-time tracing of rendering data.

(Herdado de Control)
BuildProfileTree(String, Boolean)

Reúne informações sobre o controle de servidor e as envia para a propriedade Trace para serem exibidas quando o rastreamento está habilitado para a página.Gathers information about the server control and delivers it to the Trace property to be displayed when tracing is enabled for the page.

(Herdado de Control)
ChangeMode(FormViewMode)

Muda o controle FormView para o modo de entrada de dados especificado.Switches the FormView control to the specified data-entry mode.

ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.Sets the cached ClientID value to null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.Deletes the control-state information for the server control's child controls.

(Herdado de Control)
ClearChildState()

Exclui as informações de estado de exibição e de estado de controle para todos os controles filho do controle de servidor.Deletes the view-state and control-state information for all the server control's child controls.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.Deletes the view-state information for all the server control's child controls.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.Sets the ClientIDMode property of the current control instance and of any child controls to Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controle associado a dados.Sets the initialized state of the data-bound control.

(Herdado de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copia as propriedades que não são encapsuladas pelo objeto Style de controle do servidor Web especificado ao controle de servidor Web do qual este método é chamado.Copies the properties not encapsulated by the Style object from the specified Web server control to the Web server control that this method is called from. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
CreateChildControls()

Cria uma hierarquia de controle usada para renderizar um controle de composição associado a dados com base nos valores armazenados no estado de exibição.Creates the control hierarchy that is used to render a composite data-bound control based on the values that are stored in view state.

(Herdado de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Cria a hierarquia de controle usada para renderizar o controle FormView com a fonte de dados especificada.Creates the control hierarchy used to render the FormView control with the specified data source.

CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.

(Herdado de Control)
CreateControlStyle()

Cria um objeto de estilo de tabela padrão para o controle FormView.Creates a default table style object for the FormView control.

CreateDataSourceSelectArguments()

Cria o objeto DataSourceSelectArguments que contém os argumentos passados para a fonte de dados para processamento.Creates the DataSourceSelectArguments object that contains the arguments that are passed to the data source for processing.

CreateRow(Int32, DataControlRowType, DataControlRowState)

Cria um objeto FormViewRow usando o índice do item, o tipo de linha e o estado de linha especificados.Creates a FormViewRow object using the specified item index, row type, and row state.

CreateTable()

Cria a tabela recipiente para o controle FormView.Creates the containing table for the FormView control.

DataBind()

Associa a fonte de dados ao controle FormView.Binds the data source to the FormView control.

DataBind(Boolean)

Associa uma fonte de dados ao controle de servidor invocado e todos os seus controles filho com uma opção para gerar o evento DataBinding.Binds a data source to the invoked server control and all its child controls with an option to raise the DataBinding event.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.Binds a data source to the server control's child controls.

(Herdado de Control)
DeleteItem()

Exclui o registro atual no controle FormView da fonte de dados.Deletes the current record in the FormView control from the data source.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.Enables a server control to perform final clean up before it is released from memory.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.Ends design-time tracing of rendering data.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho.Determines whether the server control contains child controls. Se ele não contiver, ele criará controles filho.If it does not, it creates child controls.

(Herdado de Control)
EnsureDataBound()

Garante que o controle FormView está associado aos dados quando apropriado.Makes certain that the FormView control is bound to data when appropriate.

EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.Creates an identifier for controls that do not have an identifier assigned.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
ExtractRowValues(IOrderedDictionary, Boolean)

Recupera os valores de cada campo declarados dentro da linha de dados e armazena-os no objeto IOrderedDictionary especificado.Retrieves the values of each field declared within the data row and stores them in the specified IOrderedDictionary object.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.Searches the current naming container for a server control with the specified id parameter.

(Herdado de Control)
FindControl(String, Int32)

Procura o contêiner de nomenclatura atual para um controle de servidor com o id especificado e um inteiro especificado no parâmetro pathOffset, que auxilia na pesquisa.Searches the current naming container for a server control with the specified id and an integer, specified in the pathOffset parameter, which aids in the search. Você não deve substituir esta versão do método FindControl.You should not override this version of the FindControl method.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.Sets input focus to a control.

(Herdado de Control)
GetData()

Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados.Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver.Retrieves the IDataSource interface that the data-bound control is associated with, if any.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.Gets design-time data for a control.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.Gets the URL that corresponds to a set of route parameters.

(Herdado de Control)
GetRouteUrl(String, Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota e um nome de rota.Gets the URL that corresponds to a set of route parameters and a route name.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.Returns the prefixed portion of the UniqueID property of the specified control.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.Determines if the server control contains any child controls.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.Returns a value indicating whether events are registered for the control or any child controls.

(Herdado de Control)
InitializePager(FormViewRow, PagedDataSource)

Cria a linha de paginação para o controle FormView.Creates the pager row for the FormView control.

InitializeRow(FormViewRow)

Inicializa o objeto FormViewRow especificado.Initializes the specified FormViewRow object.

InsertItem(Boolean)

Insere o registro atual na fonte de dados.Inserts the current record in the data source.

IsBindableType(Type)

Determina se o tipo de dados especificado pode estar associado a um campo no controle FormView.Determines whether the specified data type can be bound to a field in the FormView control.

IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.Determines if the server control holds only literal content.

(Herdado de Control)
LoadControlState(Object)

Carrega o estado das propriedades de controle FormView que precisam ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.Loads the state of the FormView control properties that need to be persisted, even when the EnableViewState property is set to false.

LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do controle FormView.Loads the previously saved view state of the FormView control.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.Retrieves the physical path that a virtual path, either absolute or relative, maps to.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controle em estado de exibição como associado com êxito aos dados.Sets the state of the control in view state as successfully bound to data.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
MergeStyle(Style)

Copia os elementos não vazios do estilo especificado para o controle da Web, mas não substituirá os elementos de estilo existentes do controle.Copies any nonblank elements of the specified style to the Web control, but will not overwrite any existing style elements of the control. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
ModifiedOuterTableStylePropertyName()

Determina se as regras de estilo CSS específicas de tabela associadas ao controle FormView estão definidas como seus valores padrão.Determines whether the table-specific CSS style rules that are associated with the FormView control are set to their default values.

OnBubbleEvent(Object, EventArgs)

Manipula um evento passado para cima por meio da hierarquia de controle.Handles an event passed up through the control hierarchy.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Aciona o evento CreatingModelDataSource.Raises the CreatingModelDataSource event.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Gera o DataBinding evento.Raises the DataBinding event.

(Herdado de Control)
OnDataBound(EventArgs)

Aciona o evento DataBound.Raises the DataBound event.

(Herdado de BaseDataBoundControl)
OnDataPropertyChanged()

Associa novamente o controle associado a dados a seus dados após a alteração de uma das propriedades de identificação da fonte de dados base.Rebinds the data-bound control to its data after one of the base data source identification properties changes.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Aciona o evento DataSourceViewChanged.Raises the DataSourceViewChanged event.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Gera o Init evento.Raises the Init event.

OnItemCommand(FormViewCommandEventArgs)

Gera o ItemCommand evento.Raises the ItemCommand event.

OnItemCreated(EventArgs)

Gera o ItemCreated evento.Raises the ItemCreated event.

OnItemDeleted(FormViewDeletedEventArgs)

Gera o ItemDeleted evento.Raises the ItemDeleted event.

OnItemDeleting(FormViewDeleteEventArgs)

Gera o ItemDeleting evento.Raises the ItemDeleting event.

OnItemInserted(FormViewInsertedEventArgs)

Gera o ItemInserted evento.Raises the ItemInserted event.

OnItemInserting(FormViewInsertEventArgs)

Gera o ItemInserting evento.Raises the ItemInserting event.

OnItemUpdated(FormViewUpdatedEventArgs)

Gera o ItemUpdated evento.Raises the ItemUpdated event.

OnItemUpdating(FormViewUpdateEventArgs)

Gera o ItemUpdating evento.Raises the ItemUpdating event.

OnLoad(EventArgs)

Manipula o evento Load.Handles the Load event.

(Herdado de DataBoundControl)
OnModeChanged(EventArgs)

Gera o ModeChanged evento.Raises the ModeChanged event.

OnModeChanging(FormViewModeEventArgs)

Gera o ModeChanging evento.Raises the ModeChanging event.

OnPageIndexChanged(EventArgs)

Gera o PageIndexChanged evento.Raises the PageIndexChanged event.

OnPageIndexChanging(FormViewPageEventArgs)

Gera o PageIndexChanging evento.Raises the PageIndexChanging event.

OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controle associado a dados antes do carregamento do controle.Sets the initialized state of the data-bound control before the control is loaded.

(Herdado de DataBoundControl)
OnPreRender(EventArgs)

Manipula o evento PreRender.Handles the PreRender event.

(Herdado de BaseDataBoundControl)
OnUnload(EventArgs)

Gera o Unload evento.Raises the Unload event.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.Gets a Stream used to read a file.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Associa a fonte de dados especificada ao controle FormView.Binds the specified data source to the FormView control.

PerformSelect()

Recupera dados da fonte de dados associada.Retrieves data from the associated data source.

(Herdado de DataBoundControl)
PrepareControlHierarchy()

Configura a hierarquia de controle do controle FormView.Sets up the control hierarchy of the FormView control.

RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.Assigns any sources of the event and its information to the control's parent.

(Herdado de Control)
RaisePostBackEvent(String)

Gera os eventos apropriados para o controle FormView quando ele executa um postback para o servidor.Raises the appropriate events for the FormView control when it posts back to the server.

RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.Called after a child control is removed from the Controls collection of the Control object.

(Herdado de Control)
Render(HtmlTextWriter)

Exibe o controle FormView no cliente.Displays the FormView control on the client.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado.Renders the HTML opening tag of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo de filhos de um controle de servidor a um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle no gravador especificado.Renders the contents of the control to the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
RenderControl(HtmlTextWriter)

Gera o conteúdo do controle de servidor para um objeto HtmlTextWriter fornecido e armazena informações de rastreamento sobre o controle caso o rastreamento esteja habilitado.Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.Outputs server control content to a provided HtmlTextWriter object using a provided ControlAdapter object.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado.Renders the HTML closing tag of the control into the specified writer. Esse método é usado principalmente por desenvolvedores de controle.This method is used primarily by control developers.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.Gets the control adapter responsible for rendering the specified control.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.Gets a URL that can be used by the browser.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.Converts a URL into one that is usable on the requesting client.

(Herdado de Control)
SaveControlState()

Salva o estado das propriedades de controle FormView que precisam ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.Saves the state of the FormView control properties that need to be persisted, even when the EnableViewState property is set to false.

SaveViewState()

Salva o estado de exibição atual do controle FormView.Saves the current view state of the FormView control.

SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.Sets design-time data for a control.

(Herdado de Control)
SetPageIndex(Int32)

Define o índice da página exibida atualmente no controle FormView.Sets the index of the currently displayed page in the FormView control.

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.Assigns an event handler delegate to render the server control and its content into its parent control.

(Herdado de Control)
SetTraceData(Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the trace data key and the trace data value.

(Herdado de Control)
SetTraceData(Object, Object, Object)

Define os dados de rastreamento para o rastreamento de tempo de design dos dados de renderização, usando o objeto rastreado, a chave e o valor de dados de rastreamento.Sets trace data for design-time tracing of rendering data, using the traced object, the trace data key, and the trace data value.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)
TrackViewState()

Marca o ponto inicial no qual começar a acompanhar e salvar as alterações de estado de exibição no controle FormView.Marks the starting point at which to begin tracking and saving view-state changes to the FormView control.

UpdateItem(Boolean)

Atualiza o registro atual na fonte de dados.Updates the current record in the data source.

ValidateDataSource(Object)

Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar.Verifies that the object a data-bound control binds to is one it can work with.

(Herdado de DataBoundControl)

Eventos

CallingDataMethods

Ocorre quando os métodos de dados estão sendo chamados.Occurs when data methods are being called.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o objeto ModelDataSource está sendo criado.Occurs when the ModelDataSource object is being created.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.Occurs when the server control binds to a data source.

(Herdado de Control)
DataBound

Ocorre após o controle de servidor ser associado a uma fonte de dados.Occurs after the server control binds to a data source.

(Herdado de BaseDataBoundControl)
Disposed

Ocorre quando um controle de servidor é liberado da memória, que é o último estágio do ciclo de vida de controle de servidor quando uma página ASP.NET é solicitada.Occurs when a server control is released from memory, which is the last stage of the server control lifecycle when an ASP.NET page is requested.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.Occurs when the server control is initialized, which is the first step in its lifecycle.

(Herdado de Control)
ItemCommand

Ocorre quando um botão é clicado dentro de um controle FormView.Occurs when a button within a FormView control is clicked.

ItemCreated

Ocorre depois que todas as linhas forem criadas em um controle FormView.Occurs after all the rows are created in a FormView control.

ItemDeleted

Ocorre quando se clica em um botão Excluir em um controle FormView, mas após a operação de exclusão.Occurs when a Delete button within a FormView control is clicked, but after the delete operation.

ItemDeleting

Ocorre quando se clica em um botão Excluir em um controle FormView, mas antes da operação de exclusão.Occurs when a Delete button within a FormView control is clicked, but before the delete operation.

ItemInserted

Ocorre ao clicar em um botão Inserir dentro de um controle FormView, porém depois da operação de inserção.Occurs when an Insert button within a FormView control is clicked, but after the insert operation.

ItemInserting

Ocorre ao clicar em um botão Inserir em um controle FormView, porém antes da operação de inserção.Occurs when an Insert button within a FormView control is clicked, but before the insert operation.

ItemUpdated

Ocorre quando um botão Atualizar dentro de um controle FormView é clicado após a operação de atualização.Occurs when an Update button within a FormView control is clicked, but after the update operation.

ItemUpdating

Ocorre quando um botão Atualizar dentro de um controle FormView é clicado, mas antes da operação de atualização.Occurs when an Update button within a FormView control is clicked, but before the update operation.

Load

Ocorre quando o controle de servidor é carregado no objeto Page.Occurs when the server control is loaded into the Page object.

(Herdado de Control)
ModeChanged

Ocorre quando o controle FormView muda entre o modo de edição, inserção e somente leitura, mas após a alteração do modo.Occurs when the FormView control switches between edit, insert, and read-only mode, but after the mode has changed.

ModeChanging

Ocorre quando o controle FormView alterna entre o modo de edição, inserção e somente leitura, mas antes da alteração do modo.Occurs when the FormView control switches between edit, insert, and read-only mode, but before the mode changes.

PageIndexChanged

Ocorre quando o valor da propriedade PageIndex é alterado depois de uma operação de paginação.Occurs when the value of the PageIndex property changes after a paging operation.

PageIndexChanging

Ocorre quando o valor da propriedade PageIndex é alterado antes de uma operação de paginação.Occurs when the value of the PageIndex property changes before a paging operation.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.Occurs after the Control object is loaded but prior to rendering.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.Occurs when the server control is unloaded from memory.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.Gets an attribute of the Web control with the specified name.

(Herdado de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Define um atributo do controle da Web para o nome e o valor especificados.Sets an attribute of the Web control to the specified name and value.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.For a description of this member, see ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().For a description of this member, see GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).For a description of this member, see SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).For a description of this member, see SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.For a description of this member, see UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.For a description of this member, see DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira HasDataBindings.For a description of this member, see HasDataBindings.

(Herdado de Control)
IDataBoundControl.DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave primária dos itens exibidos no controle FormView.Gets or sets an array that contains the names of the primary-key fields of the items that are displayed in the FormView control.

IDataBoundControl.DataMember

Obtém ou define o nome da lista de itens de dados aos quais o controle FormView é associado quando a fonte de dados contém mais de uma lista de itens de dados.Gets or sets the name of the list of data items that the FormView control binds to when the data source contains more than one list of data items.

IDataBoundControl.DataSource

Obtém ou define o objeto que contém a lista de dados que o controle FormView recupera.Gets or sets the object that contains the list of data that the FormView control retrieves.

IDataBoundControl.DataSourceID

Obtém ou define a ID do controle de fonte de dados que contém a lista de itens de dados que o controle FormView recupera.Gets or sets the ID of the data source control that contains the list of data items that the FormView control retrieves.

IDataBoundControl.DataSourceObject

Obtém o objeto de fonte de dados que contém a lista de itens de dados que o controle FormView recupera.Gets the data source object that contains the list of data items that the FormView control retrieves.

IDataBoundItemControl.DataKey

Obtém o objeto que representa o valor de chave de dados da linha no controle FormView.Gets the object that represents the data-key value of the row in the FormView control.

IDataBoundItemControl.Mode

Obtém o modo atual do controle FormView.Gets the current mode of the FormView control.

IDataItemContainer.DataItemIndex

Para obter uma descrição desse membro, confira DataItemIndex.For a description of this member, see DataItemIndex.

IDataItemContainer.DisplayIndex

Para obter uma descrição desse membro, confira DisplayIndex.For a description of this member, see DisplayIndex.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.For a description of this member, see Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.For a description of this member, see HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).For a description of this member, see AddParsedSubObject(Object).

(Herdado de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)

Determina as opções de evento de postback para o controle FormView.Determines the postback event options for the FormView control.

IPostBackEventHandler.RaisePostBackEvent(String)

Aciona eventos para o controle FormView quando ele executa um postback para o servidor.Raises events for the FormView control when it posts back to the server.

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)

Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação.Enables selection to be persisted in data controls that support selection and paging.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.Returns the data source that is associated with the data control for the specified control.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.Returns the field template for the specified column in the specified control's naming container.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.Returns the metatable object for the containing data control.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.Gets the collection of the default values for the specified data control.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.Gets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.Sets the table metadata for the specified data control.

SetMetaTable(INamingContainer, MetaTable, IDictionary<String,Object>)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.Sets the table metadata and default value mapping for the specified data control.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.Sets the table metadata and default value mapping for the specified data control.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.Determines whether table metadata is available.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, IDictionary<String,Object>)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.Enables Dynamic Data behavior for the specified data control.

Aplica-se a

Veja também