FormView Classe

Definição

Exibe os valores de um único registro de uma fonte de dados usando modelos definidos pelo usuário. O controle FormView permite que você edite, exclua e insira registros.

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

Exemplos

O exemplo a seguir demonstra como usar um FormView controle para exibir os valores de um SqlDataSource controle .


<%@ 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") %> <%# 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") %> <%# 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 FormView controle para editar registros existentes.

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. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.


<%@ 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">
                    
              </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">
                    
              </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">
                    
              </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">
                    
              </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 FormView controle para inserir novos registros.

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. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.


<%@ 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">
                    
              </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">
                    
              </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">
                    
              </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">
                    
              </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:

Introdução

O FormView controle é usado para exibir um único registro de uma fonte de dados. Ele é semelhante ao DetailsView controle , exceto que exibe modelos definidos pelo usuário em vez de campos de linha. Criar seus próprios modelos oferece maior flexibilidade para controlar como os dados são exibidos. O FormView controle dá suporte aos seguintes recursos:

  • Associação a controles de fonte de dados, como SqlDataSource e ObjectDataSource.

  • Recursos internos de inserção.

  • Funcionalidades internas de atualização e exclusão.

  • Recursos de paginação internos.

  • Acesso programático ao FormView modelo de objeto para definir dinamicamente propriedades, manipular eventos e assim por diante.

  • Aparência personalizável por meio de modelos, temas e estilos definidos pelo usuário.

Modelos

Para que o FormView controle exiba conteúdo, você precisa criar modelos para as diferentes partes do controle. A maioria dos modelos são opcionais; no entanto, você deve criar um modelo para o modo no qual o controle está configurado. Por exemplo, um FormView controle que dá suporte à inserção de registros deve ter um modelo de item de inserção definido. A tabela a seguir lista os diferentes modelos que você pode criar.

Tipo do modelo Descrição
EditItemTemplate Define o conteúdo da linha de dados quando o FormView controle está no modo de edição. Esse modelo geralmente contém controles de entrada e botões de comando com os quais o usuário pode editar um registro existente.
EmptyDataTemplate Define o conteúdo da linha de dados vazia exibida quando o FormView controle está associado a uma fonte de dados que não contém nenhum registro. Esse modelo geralmente contém conteúdo para alertar o usuário de que a fonte de dados não contém nenhum registro.
FooterTemplate Define o conteúdo da linha de rodapé. Esse modelo geralmente contém qualquer conteúdo adicional que você gostaria de exibir na linha de rodapé. Nota: Como alternativa, você pode simplesmente especificar o texto a ser exibido na linha do rodapé definindo a FooterText propriedade .
HeaderTemplate Define o conteúdo da linha de cabeçalho. Esse modelo geralmente contém qualquer conteúdo adicional que você gostaria de exibir na linha de cabeçalho. Nota: Como alternativa, você pode simplesmente especificar o texto a ser exibido na linha do cabeçalho definindo a HeaderText propriedade .
ItemTemplate Define o conteúdo da linha de dados quando o FormView controle está no modo somente leitura. Esse modelo geralmente contém conteúdo para exibir os valores de um registro existente.
InsertItemTemplate Define o conteúdo da linha de dados quando o FormView controle está no modo de inserção. Esse modelo geralmente contém controles de entrada e botões de comando com os quais o usuário pode adicionar um novo registro.
PagerTemplate Define o conteúdo da linha de paginação exibida quando o recurso de paginação está habilitado (quando a AllowPaging propriedade é definida truecomo ). Esse modelo geralmente contém controles com os quais o usuário pode navegar para outro registro. Nota: O FormView controle tem uma interface do usuário interna de linha de paginação. Você só precisará criar um modelo de pager se quiser criar sua própria linha de paginação personalizada.

Para exibir o valor de um campo em um modelo de item, use uma expressão de associação de dados. Para obter mais informações sobre expressões de associação de dados, consulte Sintaxe de expressão de associação de dados.

Os controles de entrada no modelo de edição de item e no modelo de item de inserção podem ser associados aos campos de uma fonte de dados usando uma expressão de associação bidirecional. Isso permite que o FormView controle extraia automaticamente os valores do controle de entrada para uma operação de atualização ou inserção. Expressões de associação bidirecional também permitem que os controles de entrada em um modelo de edição de item exibam automaticamente os valores de campo originais. Para obter mais informações sobre expressões de associação bidirecional, consulte Associação a bancos de dados.

Associação a dados

O FormView controle pode ser associado a um controle de fonte de dados (como SqlDataSource, ObjectDataSourceou AccessDataSource) ou a qualquer coleção de fonte de dados que implemente a System.Collections.IEnumerable interface, como System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou outros tipos de coleção. Use um dos seguintes métodos para associar o FormView controle ao tipo de fonte de dados apropriado:

  • Para associar a um controle de fonte de dados, defina a DataSourceID propriedade do FormView controle como o ID valor do controle da fonte de dados. O FormView controle é associado automaticamente ao controle da fonte de dados especificado e pode aproveitar os recursos do controle da fonte de dados para executar a funcionalidade de inserção, atualização, exclusão e paginação. Esse é o método preferencial para associar a dados.

  • Para associar a uma fonte de dados que implementa a System.Collections.IEnumerable interface , defina programaticamente a DataSource propriedade do FormView controle como a fonte de dados e, em seguida, chame o DataBind método . Ao usar esse método, o FormView controle não fornece a funcionalidade interna de inserção, atualização, exclusão e paginação. Você precisa fornecer essa funcionalidade usando o evento apropriado.

Para obter mais informações sobre a associação de dados, consulte ASP.NET Mapa de Conteúdo de Acesso a Dados.

Observação

Esse controle pode ser usado para exibir a entrada do usuário, que pode incluir script de cliente mal-intencionado. Verifique 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. Sempre que possível, é altamente recomendável que os valores sejam codificados em HTML antes de serem exibidos nesse controle. ASP.NET fornece um recurso de validação de solicitação de entrada para bloquear script e HTML na entrada do usuário. Controles de servidor de validação também são fornecidos para avaliar a entrada do usuário. Para obter mais informações, consulte Introdução aos controles de validação.

Operações de dados

O FormView controle fornece muitos recursos internos que permitem ao usuário atualizar, excluir, inserir e paginar itens no controle. Quando o FormView controle está associado a um controle de fonte de dados, o FormView controle pode aproveitar os recursos do controle da fonte de dados e fornecer funcionalidades automáticas de atualização, exclusão, inserção e paginação.

Observação

O FormView controle 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 dessas operações.

Como o FormView controle usa modelos, ele não fornece uma maneira de gerar automaticamente botões de comando para executar operações de atualização, exclusão ou inserção. Você deve incluir manualmente esses botões de comando no modelo apropriado. O FormView controle reconhece determinados botões que têm suas CommandName propriedades definidas como valores específicos. A tabela a seguir lista os botões de comando que o FormView controle reconhece.

Botão Valor de CommandName Descrição
Cancelar "Cancelar" Usado na atualização ou inserção de operações para cancelar a operação e descartar os valores inseridos pelo usuário. Em FormView seguida, o controle retorna ao modo especificado pela DefaultMode propriedade .
Excluir "Excluir" Usado na exclusão de operações para excluir o registro exibido da fonte de dados. Gera os ItemDeleting eventos e ItemDeleted .
Editar "Editar" Usado na atualização de operações para colocar o FormView controle no modo de edição. O conteúdo especificado na EditItemTemplate propriedade é exibido para a linha de dados.
Inserir "Inserir" Usado na inserção de operações para tentar inserir um novo registro na fonte de dados usando os valores fornecidos pelo usuário. Gera os ItemInserting eventos e ItemInserted .
Novo "Novo" Usado na inserção de operações para colocar o FormView controle no modo de inserção. O conteúdo especificado na InsertItemTemplate propriedade é exibido para a linha de dados.
Página "Página" Usado em operações de paginação para representar um botão na linha de paginação que executa paginação. Para especificar a operação de paginação, defina a CommandArgument propriedade do botão como "Next", "Prev", "First", "Last" ou o índice da página para a qual navegar. Gera os PageIndexChanging eventos e PageIndexChanged . Nota: Esse tipo de botão normalmente é usado apenas no modelo de paginação.
Atualizar "Atualizar" Usado na atualização de operações para tentar atualizar o registro exibido na fonte de dados com os valores fornecidos pelo usuário. Gera os ItemUpdating eventos e ItemUpdated .

Ao contrário do botão Excluir (que exclui o registro exibido imediatamente), quando o botão Editar ou Novo é clicado, o FormView controle entra no modo de edição ou inserção, respectivamente. No modo de edição, o conteúdo contido na EditItemTemplate propriedade é exibido para o item de dados atual. Normalmente, o modelo de edição de item é definido de modo que o botão Editar seja substituído por um botão Atualizar e Cancelar. Os controles de entrada apropriados para o tipo de dados do campo (como um TextBox ou um CheckBox controle) também geralmente são exibidos com o valor de um campo para o usuário modificar. Clicar no botão Atualizar atualiza o registro na fonte de dados, enquanto clicar no botão Cancelar abandona todas as alterações.

Da mesma forma, o conteúdo contido na InsertItemTemplate propriedade é exibido para o item de dados quando o controle está no modo de inserção. O modelo inserir item normalmente é definido de modo que o botão Novo seja substituído por um botão Inserir e Cancelar, e controles de entrada vazios são exibidos para o usuário inserir os valores para o novo registro. Clicar no botão Inserir insere o registro na fonte de dados, enquanto clicar no botão Cancelar abandona todas as alterações.

O FormView controle fornece um recurso de paginação, que permite que o usuário navegue até outros registros na fonte de dados. Quando habilitada, uma linha de paginação é exibida no FormView controle que contém os controles de navegação de página. Para habilitar a paginação, defina a AllowPaging propriedade como true. Você pode personalizar a linha do pager definindo as propriedades dos objetos contidos na PagerStyle propriedade e PagerSettings . Em vez de usar a interface do usuário de linha de paginação interna, você pode criar sua própria interface do usuário usando a PagerTemplate propriedade .

Personalizando a interface do usuário

Você pode personalizar a aparência do FormView controle definindo as propriedades de estilo para as diferentes partes do controle. A tabela a seguir lista as diferentes propriedades de estilo.

Propriedade Style Descrição
EditRowStyle As configurações de estilo para a linha de dados quando o FormView controle está no modo de edição.
EmptyDataRowStyle As configurações de estilo da linha de dados vazia exibidas FormView no controle quando a fonte de dados não contém nenhum registro.
FooterStyle As configurações de estilo para a linha de rodapé do FormView controle.
HeaderStyle As configurações de estilo para a linha de cabeçalho do FormView controle.
InsertRowStyle As configurações de estilo para a linha de dados quando o FormView controle está no modo de inserção.
PagerStyle As configurações de estilo da linha pager exibidas no FormView controle quando o recurso de paginação está habilitado.
RowStyle As configurações de estilo para a linha de dados quando o FormView controle está no modo somente leitura.

Eventos

O FormView controle fornece vários eventos nos quais você pode programar. Isso permite que você execute uma rotina personalizada sempre que ocorrer um evento. A tabela a seguir lista os eventos compatíveis com o FormView controle .

Evento Descrição
ItemCommand Ocorre quando um botão é clicado dentro de um controle FormView. Esse evento geralmente é usado para executar uma tarefa quando um botão é clicado no controle .
ItemCreated Ocorre depois que todos os FormViewRow objetos são criados no FormView controle . Esse evento geralmente é usado para modificar os valores de um registro antes de ser exibido.
ItemDeleted Ocorre quando um botão Excluir (um botão com sua CommandName propriedade definida como "Excluir") é clicado, mas depois que o FormView controle exclui o registro da fonte de dados. Esse evento geralmente é usado para marcar os resultados da operação de exclusão.
ItemDeleting Ocorre quando um botão Excluir é clicado, mas antes que o FormView controle exclua o registro da fonte de dados. Esse evento geralmente é usado para cancelar a operação de exclusão.
ItemInserted Ocorre quando um botão Inserir (um botão com sua CommandName propriedade definida como "Inserir") é clicado, mas depois que o FormView controle insere o registro. Esse evento geralmente é usado para marcar os resultados da operação de inserção.
ItemInserting Ocorre quando um botão Inserir é clicado, mas antes que o FormView controle insira o registro. Esse evento geralmente é usado para cancelar a operação de inserção.
ItemUpdated Ocorre quando um botão Atualizar (um botão com sua CommandName propriedade definida como "Atualização") é clicado, mas depois que o FormView controle atualiza a linha. Esse evento geralmente é usado para marcar os resultados da operação de atualização.
ItemUpdating Ocorre quando um botão Atualizar é clicado, mas antes que o FormView controle atualize o registro. Esse evento geralmente é usado para cancelar a operação de atualização.
ModeChanged Ocorre depois que o controle altera os FormView modos (para editar, inserir ou somente leitura). Esse evento geralmente é usado para executar uma tarefa quando o controle altera os FormView modos.
ModeChanging Ocorre antes que o controle altere os FormView modos (para editar, inserir ou somente leitura). Esse evento geralmente é usado para cancelar uma alteração de modo.
PageIndexChanged Ocorre quando um dos botões de paginação é acionado, mas após o controle FormView manipular a operação de paginação. Esse evento geralmente é usado quando você precisa executar uma tarefa depois que o usuário navega para um registro diferente no controle.
PageIndexChanging Ocorre quando um dos botões de paginação é acionado, mas antes de o controle FormView manipular a operação de paginação. Esse evento geralmente é usado para cancelar a operação de paginação.

Acessibilidade

Para obter informações sobre como configurar esse controle para que ele gere marcação em conformidade com os padrões de acessibilidade, consulte Acessibilidade no Visual Studio e ASP.NET e controles de ASP.NET e acessibilidade.

Aplicando estilos CSS

O FormView controle permite especificar regras de estilo CSS na marcação. Se você usar modelos para personalizar a aparência do FormView controle, poderá especificar estilos CSS na marcação nos modelos. Nesse caso, nenhuma tabela externa extra é necessária. Você pode impedir que a tabela seja renderizada definindo a RenderOuterTable propriedade como false.

Sintaxe declarativa

<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"
    RenderOuterTable="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.

Propriedades

AccessKey

Obtém ou define a tecla de acesso que permite navegar rapidamente para o controle do servidor Web.

(Herdado de WebControl)
Adapter

Obtém o adaptador específico de navegador para o controle.

(Herdado de Control)
AllowPaging

Obtém ou define um valor que indica se o recurso de paginação está habilitado.

AppRelativeTemplateSourceDirectory

Obtém ou define o diretório virtual relativo de aplicativo do objeto Page ou UserControl que contém este controle.

(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.

(Herdado de WebControl)
BackColor

Obtém ou define a cor da tela de fundo do controle do servidor Web.

(Herdado de WebControl)
BackImageUrl

Obtém ou define a URL para uma imagem a ser exibida na tela de fundo de um controle FormView.

BindingContainer

Obtém o controle que contém a vinculação de dados desse controle.

(Herdado de Control)
BorderColor

Obtém ou define a cor da borda do controle Web.

(Herdado de WebControl)
BorderStyle

Obtém ou define o estilo de borda do controle de servidor Web.

(Herdado de WebControl)
BorderWidth

Obtém ou define a largura da borda do controle de servidor Web.

(Herdado de WebControl)
BottomPagerRow

Obtém o objeto FormViewRow que representa a linha de paginação exibida na parte inferior do controle FormView.

Caption

Obtém ou define o texto a ser renderizado em um elemento de legenda HTML em um controle FormView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.

CaptionAlign

Obtém ou define a posição horizontal ou vertical de um elemento de legenda HTML em um controle FormView. Esta propriedade é fornecida para tornar o controle mais acessível para usuários de dispositivos de tecnologia adaptativa.

CellPadding

Obtém ou define a quantidade de espaço entre o conteúdo e a borda de uma célula.

CellSpacing

Obtém ou define a quantidade de espaço entre células.

ChildControlsCreated

Obtém um valor que indica se os controles filho do controle de servidor foram criados.

(Herdado de Control)
ClientID

Obtém a ID de controle de marcação HTML gerada pelo ASP.NET.

(Herdado de Control)
ClientIDMode

Obtém ou define o algoritmo usado para gerar o valor da propriedade ClientID.

(Herdado de Control)
ClientIDSeparator

Obtém um valor de caractere que representa o caractere separador usado na propriedade ClientID.

(Herdado de Control)
Context

Obtém o objeto HttpContext associado ao controle de servidor para a solicitação da Web atual.

(Herdado de Control)
Controls

Obtém uma coleção dos controles filho no controle com limite de dados de composição.

(Herdado de CompositeDataBoundControl)
ControlStyle

Obtém o estilo de um controle de servidor Web. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ControlStyleCreated

Obtém um valor que indica se um objeto Style foi criado para a propriedade ControlStyle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
CssClass

Obtém ou define a classe CSS (Folha de Estilos em Cascata) renderizada pelo controle do servidor Web no cliente.

(Herdado de WebControl)
CurrentMode

Obtém o modo de entrada de dados atual do controle FormView.

DataItem

Obtém o item de dados associado ao controle FormView.

DataItemContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o IDataItemContainer.

(Herdado de Control)
DataItemCount

Obtém o número de itens de dados na fonte de dados.

DataItemIndex

Obtém o índice do item de dados associado ao controle FormView da fonte de dados.

DataKey

Obtém um objeto DataKey que representa a chave primária do registro exibido.

DataKeyNames

Obtém ou define uma matriz que contém os nomes dos campos de chave da fonte de dados.

DataKeysContainer

Obtém uma referência ao contêiner de nomenclatura se o contêiner de nomenclatura implementa o 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.

(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.

(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.

(Herdado de DataBoundControl)
DataSourceObject

Obtém um objeto que implementa a interface IDataSource, que fornece acesso ao conteúdo de dados do objeto.

(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.

DeleteMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de exclusão.

DeleteMethod

Obtém ou define o nome do método a ser chamado para excluir dados.

(Herdado de CompositeDataBoundControl)
DesignMode

Obtém um valor que indica se um controle está sendo usado em uma superfície de design.

(Herdado de Control)
EditItemTemplate

Obtém ou define o conteúdo personalizado para um item no modo de edição.

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.

EmptyDataRowStyle

Obtém uma referência para o 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.

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.

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.

Enabled

Obtém ou define um valor que indica se o controle do servidor Web está habilitado.

(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.

EnableTheming

Obtém ou define um valor que indica se os temas se aplicam a esse controle.

(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.

(Herdado de Control)
Events

Obtém uma lista de delegados de manipulador de eventos para o controle. Esta propriedade é somente para leitura.

(Herdado de Control)
Font

Obtém as propriedades de fonte associadas ao controle do servidor Web.

(Herdado de WebControl)
FooterRow

Obtém o objeto FormViewRow que representa a linha de rodapé em um controle FormView.

FooterStyle

Obtém uma referência ao objeto TableItemStyle que permite a você definir a aparência da linha de rodapé em um controle FormView.

FooterTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de rodapé em um controle FormView.

FooterText

Obtém ou define o texto a ser exibido na linha de rodapé de um controle FormView.

ForeColor

Obtém ou define a cor de primeiro plano (normalmente a cor do texto) do controle de servidor Web.

(Herdado de WebControl)
GridLines

Obtém ou define o estilo das linhas de grade para um controle FormView.

HasAttributes

Obtém um valor que indica se o controle tem atributos definidos.

(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.

(Herdado de Control)
HeaderRow

Obtém o objeto FormViewRow que representa a linha de cabeçalho em um controle FormView.

HeaderStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de cabeçalho em um controle FormView.

HeaderTemplate

Obtém ou define o conteúdo definido pelo usuário para a linha de cabeçalho em um controle FormView.

HeaderText

Obtém ou define o texto a ser exibido na linha de cabeçalho de um controle FormView.

Height

Obtém ou define a altura do controle do servidor Web.

(Herdado de WebControl)
HorizontalAlign

Obtém ou define o alinhamento horizontal de um controle FormView na página.

ID

Obtém ou define o identificador programático atribuído ao controle de servidor.

(Herdado de Control)
IdSeparator

Obtém o caractere usado para separar identificadores de controle.

(Herdado de Control)
Initialized

Obtém um valor que indica se o controle associado a dados foi inicializado.

(Herdado de BaseDataBoundControl)
InsertItemTemplate

Obtém ou define o conteúdo personalizado para um item no modo de inserção.

InsertMethod

Obtém ou define o nome do método na página chamada quando o controle executa uma operação de inserção.

InsertMethod

Obtém ou define o nome do método a ser chamado para inserir dados.

(Herdado de CompositeDataBoundControl)
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.

IsBoundUsingDataSourceID

Obtém um valor que indica se a propriedade DataSourceID foi definida.

(Herdado de BaseDataBoundControl)
IsChildControlStateCleared

Obtém um valor que indica se os controles contidos dentro deste controle têm estado de controle.

(Herdado de Control)
IsDataBindingAutomatic

Obtém um valor que indica se a associação de dados é automática.

(Herdado de BaseDataBoundControl)
IsEnabled

Obtém um valor que indica se o controle está habilitado.

(Herdado de WebControl)
IsTrackingViewState

Obtém um valor que indica se o controle de servidor está salvando alterações no estado de exibição.

(Herdado de Control)
IsUsingModelBinders

Obtém um valor que indica se o model binding está em uso.

(Herdado de CompositeDataBoundControl)
IsViewStateEnabled

Obtém um valor que indica se o estado de exibição está habilitado para esse controle.

(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.

ItemType

Obtém ou define o nome do tipo de item de dados para vinculação de dados com rigidez de tipos.

(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.

(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.

(Herdado de Control)
Page

Obtém uma referência para a instância Page que contém o controle de servidor.

(Herdado de Control)
PageCount

Obtém o número total de páginas necessárias para exibir cada registro na fonte de dados.

PageIndex

Obtém ou define o índice da página exibida.

PagerSettings

Obtém uma referência ao objeto PagerSettings que permite definir as propriedades dos botões de paginação em um controle FormView.

PagerStyle

Obtém uma referência ao objeto TableItemStyle que permite definir a aparência da linha de paginação em um controle FormView.

PagerTemplate

Obtém ou define o conteúdo personalizado para a linha do pager em um controle FormView.

Parent

Obtém uma referência ao controle pai do controle de servidor na hierarquia de controle da página.

(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.

(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.

RequiresDataBinding

Obtém ou define um valor que indica se o método DataBind() deve ser cancelado.

(Herdado de BaseDataBoundControl)
Row

Obtém o objeto FormViewRow que representa a linha de dados em um controle FormView.

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.

SelectArguments

Obtém um objeto DataSourceSelectArguments que o controle associado a dados usa ao recuperar dados de um controle de fonte de dados.

(Herdado de DataBoundControl)
SelectedValue

Obtém o valor da chave de dados do registro atual em um controle FormView.

SelectMethod

O nome do método a ser chamado para ler os dados.

(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.

(Herdado de Control)
SkinID

Obtém ou define a capa a ser aplicada ao controle.

(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.

(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.

(Herdado de BaseDataBoundControl)
TabIndex

Obtém ou define o índice de tabulação do controle do servidor Web.

(Herdado de WebControl)
TagKey

Obtém o valor HtmlTextWriterTag para o controle FormView.

TagName

Obtém o nome da marca de controle. Essa propriedade é usada principalmente por desenvolvedores de controle.

(Herdado de WebControl)
TemplateControl

Obtém ou define uma referência ao modelo que contém este controle.

(Herdado de Control)
TemplateSourceDirectory

Obtém o diretório virtual do Page ou UserControl que contém o controle do servidor atual.

(Herdado de Control)
ToolTip

Obtém ou define o texto exibido quando o ponteiro do mouse passa sobre o controle de servidor Web.

(Herdado de WebControl)
TopPagerRow

Obtém o objeto FormViewRow que representa a linha de paginação exibida na parte superior de um controle FormView.

UniqueID

Obtém o identificador exclusivo, qualificado segundo a hierarquia, para o controle de servidor.

(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.

UpdateMethod

Obtém ou define o nome do método a ser chamado para atualizar dados.

(Herdado de CompositeDataBoundControl)
ValidateRequestMode

Obtém ou define um valor que indica se o controle verifica a entrada do cliente do navegador para valores potencialmente perigosos.

(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.

(Herdado de Control)
ViewStateIgnoresCase

Obtém um valor que indica se o objeto StateBag não diferencia maiúsculas de minúsculas.

(Herdado de Control)
ViewStateMode

Obtém ou define o modo de estado de exibição deste controle.

(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.

(Herdado de Control)
Width

Obtém ou define a largura do controle de servidor Web.

(Herdado de WebControl)

Métodos

AddAttributesToRender(HtmlTextWriter)

Adiciona atributos HTML e estilos que precisam ser renderizadas ao HtmlTextWriterTag especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
AddedControl(Control, Int32)

Chamado após um controle filho ser adicionado à coleção Controls do objeto Control.

(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.

(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. Esse método é usado principalmente por desenvolvedores de controles.

(Herdado de WebControl)
ApplyStyleSheetSkin(Page)

Aplica as propriedades de estilo definidas na folha de estilos da página ao controle.

(Herdado de Control)
BeginRenderTracing(TextWriter, Object)

Inicia o rastreamento de tempo de design de dados de renderização.

(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.

(Herdado de Control)
ChangeMode(FormViewMode)

Muda o controle FormView para o modo de entrada de dados especificado.

ClearCachedClientID()

Define o valor ClientID armazenado em cache como null.

(Herdado de Control)
ClearChildControlState()

Exclui as informações de estado de controle para os controles filho do controle de servidor.

(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.

(Herdado de Control)
ClearChildViewState()

Exclui as informações de estado de exibição para todos os controles filho do controle de servidor.

(Herdado de Control)
ClearEffectiveClientIDMode()

Define a propriedade ClientIDMode da instância de controle atual e de quaisquer controles filho para Inherit.

(Herdado de Control)
ConfirmInitState()

Define o estado inicializado do controle associado a dados.

(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. Esse método é usado principalmente por desenvolvedores de controle.

(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.

(Herdado de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Cria a hierarquia de controle usada para renderizar o controle FormView com a fonte de dados especificada.

CreateControlCollection()

Cria um novo objeto ControlCollection para manter os controles filho (literal e servidor) do controle do servidor.

(Herdado de Control)
CreateControlStyle()

Cria um objeto de estilo de tabela padrão para o controle FormView.

CreateDataSourceSelectArguments()

Cria o objeto DataSourceSelectArguments que contém os argumentos passados para a fonte de dados para processamento.

CreateRow(Int32, DataControlRowType, DataControlRowState)

Cria um objeto FormViewRow usando o índice do item, o tipo de linha e o estado de linha especificados.

CreateTable()

Cria a tabela recipiente para o controle FormView.

DataBind()

Associa a fonte de dados ao controle FormView.

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.

(Herdado de Control)
DataBindChildren()

Associa uma fonte de dados aos controles filho do controle do servidor.

(Herdado de Control)
DeleteItem()

Exclui o registro atual no controle FormView da fonte de dados.

Dispose()

Permite que um controle de servidor execute a limpeza final antes do lançamento da memória.

(Herdado de Control)
EndRenderTracing(TextWriter, Object)

Encerra o rastreamento de tempo de design de dados de renderização.

(Herdado de Control)
EnsureChildControls()

Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.

(Herdado de Control)
EnsureDataBound()

Garante que o controle FormView está associado aos dados quando apropriado.

EnsureID()

Cria um identificador para controles que não têm um identificador atribuído.

(Herdado de Control)
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(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.

FindControl(String)

Procura o atual contêiner de nomenclatura de um controle de servidor com o parâmetro id especificado.

(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. Você não deve substituir esta versão do método FindControl.

(Herdado de Control)
Focus()

Define o foco de entrada para um controle.

(Herdado de Control)
GetData()

Recupera um objeto DataSourceView que o controle com associação de dados usa para executar operações de dados.

(Herdado de DataBoundControl)
GetDataSource()

Recupera a interface IDataSource à qual o controle associado a dados está associado, se houver.

(Herdado de DataBoundControl)
GetDesignModeState()

Obtém os dados de tempo de design para um controle.

(Herdado de Control)
GetHashCode()

Serve como a função de hash padrão.

(Herdado de Object)
GetRouteUrl(Object)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(Herdado de Control)
GetRouteUrl(RouteValueDictionary)

Obtém a URL que corresponde a um conjunto de parâmetros de rota.

(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.

(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.

(Herdado de Control)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
GetUniqueIDRelativeTo(Control)

Retorna a parte prefixada da propriedade UniqueID do controle especificado.

(Herdado de Control)
HasControls()

Determina se o controle de servidor contém algum controle filho.

(Herdado de Control)
HasEvents()

Retorna um valor que indica se os eventos são registrados para o controle ou qualquer controle filho.

(Herdado de Control)
InitializePager(FormViewRow, PagedDataSource)

Cria a linha de paginação para o controle FormView.

InitializeRow(FormViewRow)

Inicializa o objeto FormViewRow especificado.

InsertItem(Boolean)

Insere o registro atual na fonte de dados.

IsBindableType(Type)

Determina se o tipo de dados especificado pode estar associado a um campo no controle FormView.

IsLiteralContent()

Determina se o controle de servidor contém apenas o conteúdo literal.

(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.

LoadViewState(Object)

Carrega o estado de exibição salvo anteriormente do controle FormView.

MapPathSecure(String)

Recupera o caminho físico para o qual um caminho virtual é mapeado, relativo ou virtual.

(Herdado de Control)
MarkAsDataBound()

Define o estado do controle em estado de exibição como associado com êxito aos dados.

(Herdado de DataBoundControl)
MemberwiseClone()

Cria uma cópia superficial do Object atual.

(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. Esse método é usado principalmente por desenvolvedores de controle.

(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.

OnBubbleEvent(Object, EventArgs)

Manipula um evento passado para cima por meio da hierarquia de controle.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Aciona o evento CreatingModelDataSource.

(Herdado de DataBoundControl)
OnDataBinding(EventArgs)

Aciona o evento DataBinding.

(Herdado de Control)
OnDataBound(EventArgs)

Aciona o evento DataBound.

(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.

(Herdado de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Aciona o evento DataSourceViewChanged.

(Herdado de DataBoundControl)
OnInit(EventArgs)

Aciona o evento Init.

OnItemCommand(FormViewCommandEventArgs)

Aciona o evento ItemCommand.

OnItemCreated(EventArgs)

Aciona o evento ItemCreated.

OnItemDeleted(FormViewDeletedEventArgs)

Aciona o evento ItemDeleted.

OnItemDeleting(FormViewDeleteEventArgs)

Aciona o evento ItemDeleting.

OnItemInserted(FormViewInsertedEventArgs)

Aciona o evento ItemInserted.

OnItemInserting(FormViewInsertEventArgs)

Aciona o evento ItemInserting.

OnItemUpdated(FormViewUpdatedEventArgs)

Aciona o evento ItemUpdated.

OnItemUpdating(FormViewUpdateEventArgs)

Aciona o evento ItemUpdating.

OnLoad(EventArgs)

Manipula o evento Load.

(Herdado de DataBoundControl)
OnModeChanged(EventArgs)

Aciona o evento ModeChanged.

OnModeChanging(FormViewModeEventArgs)

Aciona o evento ModeChanging.

OnPageIndexChanged(EventArgs)

Aciona o evento PageIndexChanged.

OnPageIndexChanging(FormViewPageEventArgs)

Aciona o evento PageIndexChanging.

OnPagePreLoad(Object, EventArgs)

Define o estado inicializado do controle associado a dados antes do carregamento do controle.

(Herdado de DataBoundControl)
OnPreRender(EventArgs)

Manipula o evento PreRender.

(Herdado de BaseDataBoundControl)
OnUnload(EventArgs)

Aciona o evento Unload.

(Herdado de Control)
OpenFile(String)

Obtém um Stream usado para ler um arquivo.

(Herdado de Control)
PerformDataBinding(IEnumerable)

Associa a fonte de dados especificada ao controle FormView.

PerformSelect()

Recupera dados da fonte de dados associada.

(Herdado de DataBoundControl)
PrepareControlHierarchy()

Define a hierarquia de controle do controle FormView.

RaiseBubbleEvent(Object, EventArgs)

Atribui quaisquer fontes de evento e suas informações para o pai do controle.

(Herdado de Control)
RaisePostBackEvent(String)

Gera os eventos apropriados para o controle FormView quando ele executa um postback para o servidor.

RemovedControl(Control)

Chamado após um controle filho ser removido da coleção Controls do objeto Control.

(Herdado de Control)
Render(HtmlTextWriter)

Exibe o controle FormView no cliente.

RenderBeginTag(HtmlTextWriter)

Renderiza a marca de abertura HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
RenderChildren(HtmlTextWriter)

Gera o conteúdo dos filhos de um controle de servidor para um objeto HtmlTextWriter fornecido, que grava o conteúdo a ser renderizado no cliente.

(Herdado de Control)
RenderContents(HtmlTextWriter)

Renderiza o conteúdo do controle no gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(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.

(Herdado de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Gera o conteúdo do controle de servidor a um objeto HtmlTextWriter fornecido usando um objeto ControlAdapter fornecido.

(Herdado de Control)
RenderEndTag(HtmlTextWriter)

Renderiza a marca de fechamento HTML do controle para o gravador especificado. Esse método é usado principalmente por desenvolvedores de controle.

(Herdado de WebControl)
ResolveAdapter()

Obtém o adaptador de controle responsável por renderizar o controle especificado.

(Herdado de Control)
ResolveClientUrl(String)

Obtém uma URL que pode ser usada pelo navegador.

(Herdado de Control)
ResolveUrl(String)

Converte uma URL em uma que possa ser usada no cliente solicitante.

(Herdado de Control)
SaveControlState()

Salva o estado das propriedades de controle FormView que precisam ser persistentes, mesmo quando a propriedade EnableViewState é definida como false.

SaveViewState()

Salva o estado de exibição atual do controle FormView.

SetDesignModeState(IDictionary)

Define os dados de tempo de design para um controle.

(Herdado de Control)
SetPageIndex(Int32)

Define o índice da página exibida atualmente no controle FormView.

SetRenderMethodDelegate(RenderMethod)

Atribui um delegado do manipulador de eventos para renderizar o controle de servidor e seu conteúdo em seu controle pai.

(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.

(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.

(Herdado de Control)
ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.

(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.

UpdateItem(Boolean)

Atualiza o registro atual na fonte de dados.

ValidateDataSource(Object)

Verifica se o objeto ao qual um controle associado a dados está associado é um objeto com o qual ele pode trabalhar.

(Herdado de DataBoundControl)

Eventos

CallingDataMethods

Ocorre quando os métodos de dados estão sendo chamados.

(Herdado de DataBoundControl)
CreatingModelDataSource

Ocorre quando o objeto ModelDataSource está sendo criado.

(Herdado de DataBoundControl)
DataBinding

Ocorre quando o controle de servidor é associado a uma fonte de dados.

(Herdado de Control)
DataBound

Ocorre após o controle de servidor ser associado a uma fonte de dados.

(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.

(Herdado de Control)
Init

Ocorre quando o controle de servidor é inicializado, que é a primeira etapa do ciclo de vida.

(Herdado de Control)
ItemCommand

Ocorre quando um botão é clicado dentro de um controle FormView.

ItemCreated

Ocorre depois que todas as linhas forem criadas em um controle FormView.

ItemDeleted

Ocorre quando se clica em um botão Excluir em um controle FormView, mas após a operação de exclusão.

ItemDeleting

Ocorre quando se clica em um botão Excluir em um controle FormView, mas antes da operação de exclusão.

ItemInserted

Ocorre ao clicar em um botão Inserir dentro de um controle FormView, porém depois da operação de inserção.

ItemInserting

Ocorre ao clicar em um botão Inserir em um controle FormView, porém antes da operação de inserção.

ItemUpdated

Ocorre quando um botão Atualizar dentro de um controle FormView é clicado após a operação de atualização.

ItemUpdating

Ocorre quando um botão Atualizar dentro de um controle FormView é clicado, mas antes da operação de atualização.

Load

Ocorre quando o controle de servidor é carregado no objeto Page.

(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.

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.

PageIndexChanged

Ocorre quando o valor da propriedade PageIndex é alterado depois de uma operação de paginação.

PageIndexChanging

Ocorre quando o valor da propriedade PageIndex é alterado antes de uma operação de paginação.

PreRender

Ocorre depois que o objeto Control é carregado, mas antes da renderização.

(Herdado de Control)
Unload

Ocorre quando o controle de servidor é descarregado da memória.

(Herdado de Control)

Implantações explícitas de interface

IAttributeAccessor.GetAttribute(String)

Obtém um atributo do controle da Web com o nome especificado.

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

Define um atributo do controle da Web para o nome e o valor especificados.

(Herdado de WebControl)
IControlBuilderAccessor.ControlBuilder

Para obter uma descrição desse membro, confira ControlBuilder.

(Herdado de Control)
IControlDesignerAccessor.GetDesignModeState()

Para obter uma descrição desse membro, confira GetDesignModeState().

(Herdado de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Para obter uma descrição desse membro, confira SetDesignModeState(IDictionary).

(Herdado de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Para obter uma descrição desse membro, confira SetOwnerControl(Control).

(Herdado de Control)
IControlDesignerAccessor.UserData

Para obter uma descrição desse membro, confira UserData.

(Herdado de Control)
IDataBindingsAccessor.DataBindings

Para obter uma descrição desse membro, confira DataBindings.

(Herdado de Control)
IDataBindingsAccessor.HasDataBindings

Para obter uma descrição desse membro, confira 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.

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.

IDataBoundControl.DataSource

Obtém ou define o objeto que contém a lista de dados que o controle FormView recupera.

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.

IDataBoundControl.DataSourceObject

Obtém o objeto de fonte de dados que contém a lista de itens de dados que o controle FormView recupera.

IDataBoundItemControl.DataKey

Obtém o objeto que representa o valor de chave de dados da linha no controle FormView.

IDataBoundItemControl.Mode

Obtém o modo atual do controle FormView.

IDataItemContainer.DataItemIndex

Para obter uma descrição desse membro, confira DataItemIndex.

IDataItemContainer.DisplayIndex

Para obter uma descrição desse membro, confira DisplayIndex.

IExpressionsAccessor.Expressions

Para obter uma descrição desse membro, confira Expressions.

(Herdado de Control)
IExpressionsAccessor.HasExpressions

Para obter uma descrição desse membro, confira HasExpressions.

(Herdado de Control)
IParserAccessor.AddParsedSubObject(Object)

Para obter uma descrição desse membro, confira AddParsedSubObject(Object).

(Herdado de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)

Determina as opções de evento de postback para o controle FormView.

IPostBackEventHandler.RaisePostBackEvent(String)

Aciona eventos para o controle FormView quando ele executa um postback para o servidor.

Métodos de Extensão

EnablePersistedSelection(BaseDataBoundControl)
Obsoleto.

Permite que a seleção seja persistida nos controles de dados que dão suporte à seleção e à paginação.

FindDataSourceControl(Control)

Retorna a fonte de dados associada ao controle de dados do controle especificado.

FindFieldTemplate(Control, String)

Retorna o modelo do campo para a coluna especificada no contêiner de nomenclatura do controle especificado.

FindMetaTable(Control)

Retorna o objeto metatable para o controle que contém dados.

GetDefaultValues(INamingContainer)

Obtém a coleção de valores padrão para o controle de dados especificado.

GetMetaTable(INamingContainer)

Obtém os metadados de tabela para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable)

Define os metadados de tabela para o controle de dados especificado.

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

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

SetMetaTable(INamingContainer, MetaTable, Object)

Define os metadados de tabela e o mapeamento de valores padrão para o controle de dados especificado.

TryGetMetaTable(INamingContainer, MetaTable)

Determina se os metadados da tabela estão disponíveis.

EnableDynamicData(INamingContainer, Type)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

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

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

EnableDynamicData(INamingContainer, Type, Object)

Habilita o comportamento de Dados Dinâmicos para o controle de dados especificado.

Aplica-se a

Confira também