Partager via


FormView Classe

Définition

Affiche les valeurs d’un enregistrement unique d’une source de données à l’aide de modèles définis par l’utilisateur. Le contrôle FormView vous permet de modifier, de supprimer et d’insérer des enregistrements.

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
Héritage
Attributs
Implémente

Exemples

L’exemple suivant montre comment utiliser un FormView contrôle pour afficher les valeurs d’un SqlDataSource contrôle.


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

L’exemple suivant montre comment utiliser un FormView contrôle pour modifier des enregistrements existants.

Important

Dans cet exemple, le contrôle comporte une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

L’exemple suivant montre comment utiliser un FormView contrôle pour insérer de nouveaux enregistrements.

Important

Dans cet exemple, le contrôle comporte une zone de texte qui accepte l’entrée utilisateur, qui est une menace de sécurité potentielle. Par défaut, les pages web ASP.NET vérifient que l’entrée d’utilisateur n’inclut pas de script ou d’éléments HTML. Pour plus d’informations, consultez Vue d’ensemble des attaques 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>

Remarques

Dans cette rubrique :

Introduction

Le FormView contrôle est utilisé pour afficher un enregistrement unique à partir d’une source de données. Il est similaire au DetailsView contrôle, sauf qu’il affiche des modèles définis par l’utilisateur au lieu des champs de ligne. La création de vos propres modèles vous offre une plus grande flexibilité dans le contrôle de l’affichage des données. Le FormView contrôle prend en charge les fonctionnalités suivantes :

  • Liaison à des contrôles de source de données, tels que SqlDataSource et ObjectDataSource.

  • Fonctionnalités d’insertion intégrées.

  • Fonctionnalités intégrées de mise à jour et de suppression.

  • Fonctionnalités de pagination intégrées.

  • Accès par programmation au FormView modèle objet pour définir dynamiquement les propriétés, gérer les événements, etc.

  • Apparence personnalisable via des modèles, des thèmes et des styles définis par l’utilisateur.

Modèles

Pour que le FormView contrôle affiche du contenu, vous devez créer des modèles pour les différentes parties du contrôle. La plupart des modèles sont facultatifs ; Toutefois, vous devez créer un modèle pour le mode dans lequel le contrôle est configuré. Par exemple, un FormView contrôle qui prend en charge l’insertion d’enregistrements doit avoir un modèle d’élément d’insertion défini. Le tableau suivant répertorie les différents modèles que vous pouvez créer.

Type de modèle Description
EditItemTemplate Définit le contenu de la ligne de données lorsque le FormView contrôle est en mode édition. Ce modèle contient généralement des contrôles d’entrée et des boutons de commande avec lesquels l’utilisateur peut modifier un enregistrement existant.
EmptyDataTemplate Définit le contenu de la ligne de données vide affichée lorsque le FormView contrôle est lié à une source de données qui ne contient aucun enregistrement. Ce modèle contient généralement du contenu pour avertir l’utilisateur que la source de données ne contient aucun enregistrement.
FooterTemplate Définit le contenu de la ligne de pied de page. Ce modèle contient généralement tout contenu supplémentaire que vous souhaitez afficher dans la ligne de pied de page. Note: En guise d’alternative, vous pouvez simplement spécifier le texte à afficher dans la ligne de pied de page en définissant la FooterText propriété .
HeaderTemplate Définit le contenu de la ligne d’en-tête. Ce modèle contient généralement tout contenu supplémentaire que vous souhaitez afficher dans la ligne d’en-tête. Note: Vous pouvez également spécifier le texte à afficher dans la ligne d’en-tête en définissant la HeaderText propriété .
ItemTemplate Définit le contenu de la ligne de données lorsque le FormView contrôle est en mode lecture seule. Ce modèle contient généralement du contenu pour afficher les valeurs d’un enregistrement existant.
InsertItemTemplate Définit le contenu de la ligne de données lorsque le FormView contrôle est en mode Insertion. Ce modèle contient généralement des contrôles d’entrée et des boutons de commande avec lesquels l’utilisateur peut ajouter un nouvel enregistrement.
PagerTemplate Définit le contenu de la ligne de pagineur affichée lorsque la fonctionnalité de pagination est activée (lorsque la AllowPaging propriété a la truevaleur ). Ce modèle contient généralement des contrôles avec lesquels l’utilisateur peut accéder à un autre enregistrement. Note: Le FormView contrôle dispose d’une interface utilisateur de ligne de pagineur intégrée. Vous devez créer un modèle de pagineur uniquement si vous souhaitez créer votre propre ligne de pagineur personnalisée.

Pour afficher la valeur d’un champ dans un modèle d’élément, utilisez une expression de liaison de données. Pour plus d’informations sur les expressions de liaison de données, consultez Syntaxe des expressions de liaison de données.

Les contrôles d’entrée dans le modèle de modification d’élément et le modèle d’insertion d’élément peuvent être liés aux champs d’une source de données à l’aide d’une expression de liaison bidirectionnelle. Cela permet au FormView contrôle d’extraire automatiquement les valeurs du contrôle d’entrée pour une opération de mise à jour ou d’insertion. Les expressions de liaison bidirectionnelle permettent également aux contrôles d’entrée dans un modèle d’élément de modification d’afficher automatiquement les valeurs de champ d’origine. Pour plus d’informations sur les expressions de liaison bidirectionnelle, consultez Liaison à des bases de données.

Liaison à des données

Le FormView contrôle peut être lié à un contrôle de source de données (tel que SqlDataSource, ObjectDataSourceou AccessDataSource) ou à toute collection de sources de données qui implémente l’interface System.Collections.IEnumerable , comme System.Data.DataView, System.Collections.ArrayList, System.Collections.Generic.List<T>ou d’autres types de collection. Utilisez l’une des méthodes suivantes pour lier le FormView contrôle au type de source de données approprié :

  • Pour établir une liaison à un contrôle de source de données, définissez la DataSourceID propriété du FormView contrôle sur la ID valeur du contrôle de source de données. Le FormView contrôle se lie automatiquement au contrôle de source de données spécifié et peut tirer parti des fonctionnalités du contrôle de source de données pour effectuer des fonctionnalités d’insertion, de mise à jour, de suppression et de pagination. Il s’agit de la méthode recommandée pour la liaison aux données.

  • Pour établir une liaison à une source de données qui implémente l’interface System.Collections.IEnumerable , définissez par programmation la DataSource propriété du FormView contrôle sur la source de données, puis appelez la DataBind méthode . Lors de l’utilisation de cette méthode, le FormView contrôle ne fournit pas de fonctionnalité intégrée d’insertion, de mise à jour, de suppression et de pagination. Vous devez fournir cette fonctionnalité à l’aide de l’événement approprié.

Pour plus d’informations sur la liaison de données, consultez ASP.NET Data Access Content Map.

Notes

Ce contrôle peut être utilisé pour afficher une entrée utilisateur, qui peut inclure un script client malveillant. Vérifiez les informations envoyées à partir d’un client pour le script exécutable, les instructions SQL ou tout autre code avant de les afficher dans votre application. Dans la mesure du possible, il est vivement recommandé que les valeurs soient encodées au format HTML avant d’être affichées dans ce contrôle. ASP.NET fournit une fonctionnalité de validation de demande d’entrée pour bloquer le script et le code HTML dans l’entrée utilisateur. Des contrôles serveur de validation sont également fournis pour évaluer les entrées utilisateur. Pour plus d’informations, consultez Présentation des contrôles de validation.

Opérations de données

Le FormView contrôle fournit de nombreuses fonctionnalités intégrées qui permettent à l’utilisateur de mettre à jour, de supprimer, d’insérer et de pager des éléments dans le contrôle. Lorsque le FormView contrôle est lié à un contrôle de source de données, le FormView contrôle peut tirer parti des fonctionnalités du contrôle de source de données et fournir des fonctionnalités de mise à jour, de suppression, d’insertion et de pagination automatiques.

Notes

Le FormView contrôle peut prendre en charge les opérations de mise à jour, de suppression, d’insertion et de pagination avec d’autres types de sources de données ; toutefois, vous devez fournir un gestionnaire d’événements approprié avec l’implémentation de ces opérations.

Étant donné que le FormView contrôle utilise des modèles, il ne permet pas de générer automatiquement des boutons de commande pour effectuer des opérations de mise à jour, de suppression ou d’insertion. Vous devez inclure manuellement ces boutons de commande dans le modèle approprié. Le FormView contrôle reconnaît certains boutons dont les propriétés sont CommandName définies sur des valeurs spécifiques. Le tableau suivant répertorie les boutons de commande que le FormView contrôle reconnaît.

Bouton Valeur CommandName Description
Annuler « Annuler » Utilisé dans la mise à jour ou l’insertion d’opérations pour annuler l’opération et ignorer les valeurs entrées par l’utilisateur. Le FormView contrôle retourne ensuite au mode spécifié par la DefaultMode propriété .
Supprimer "Delete" Utilisé dans les opérations de suppression pour supprimer l’enregistrement affiché de la source de données. Déclenche les ItemDeleting événements et ItemDeleted .
Modifier « Modifier » Utilisé dans les opérations de mise à jour pour placer le FormView contrôle en mode édition. Le contenu spécifié dans la EditItemTemplate propriété s’affiche pour la ligne de données.
Insérer « Insérer » Utilisé dans les opérations d’insertion pour tenter d’insérer un nouvel enregistrement dans la source de données à l’aide des valeurs fournies par l’utilisateur. Déclenche les ItemInserting événements et ItemInserted .
Nouveau « Nouveau » Utilisé dans les opérations d’insertion pour placer le FormView contrôle en mode insertion. Le contenu spécifié dans la InsertItemTemplate propriété s’affiche pour la ligne de données.
Page « Page » Utilisé dans les opérations de pagination pour représenter un bouton dans la ligne du pagineur qui effectue la pagination. Pour spécifier l’opération de pagination, définissez la CommandArgument propriété du bouton sur « Suivant », « Prev », « First », « Last » ou sur l’index de la page vers laquelle naviguer. Déclenche les PageIndexChanging événements et PageIndexChanged . Note: Ce type de bouton est généralement utilisé uniquement dans le modèle du pagineur.
Update « Mise à jour » Utilisé dans les opérations de mise à jour pour tenter de mettre à jour l’enregistrement affiché dans la source de données avec les valeurs fournies par l’utilisateur. Déclenche les ItemUpdating événements et ItemUpdated .

Contrairement au bouton Supprimer (qui supprime immédiatement l’enregistrement affiché), lorsque vous cliquez sur le bouton Modifier ou Nouveau, le FormView contrôle passe en mode édition ou insertion, respectivement. En mode édition, le contenu contenu dans la EditItemTemplate propriété s’affiche pour l’élément de données actif. En règle générale, le modèle d’élément de modification est défini de telle sorte que le bouton Modifier est remplacé par un bouton Mettre à jour et annuler. Les contrôles d’entrée appropriés pour le type de données du champ (par exemple, un ou un TextBoxCheckBox contrôle) sont généralement affichés avec la valeur d’un champ que l’utilisateur peut modifier. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement dans la source de données, tandis que cliquer sur le bouton Annuler abandonne toute modification.

De même, le contenu contenu dans la InsertItemTemplate propriété s’affiche pour l’élément de données lorsque le contrôle est en mode insertion. Le modèle d’insertion d’élément est généralement défini de telle sorte que le bouton Nouveau soit remplacé par un bouton Insérer et un bouton Annuler, et que des contrôles d’entrée vides s’affichent pour que l’utilisateur entre les valeurs du nouvel enregistrement. Le fait de cliquer sur le bouton Insérer insère l’enregistrement dans la source de données, tandis que le fait de cliquer sur le bouton Annuler abandonne toute modification.

Le FormView contrôle fournit une fonctionnalité de pagination, qui permet à l’utilisateur de naviguer vers d’autres enregistrements dans la source de données. Lorsque cette option est activée, une ligne du pagineur s’affiche dans le FormView contrôle qui contient les contrôles de navigation de page. Pour activer la pagination, définissez la propriété sur AllowPagingtrue. Vous pouvez personnaliser la ligne du pagineur en définissant les propriétés des objets contenus dans la PagerStylePagerSettings propriété et . Au lieu d’utiliser l’interface utilisateur de ligne intégrée du pagineur, vous pouvez créer votre propre interface utilisateur à l’aide de la PagerTemplate propriété .

Personnalisation de l’interface utilisateur

Vous pouvez personnaliser l’apparence du FormView contrôle en définissant les propriétés de style pour les différentes parties du contrôle. Le tableau suivant répertorie les différentes propriétés de style.

Propriété Style Description
EditRowStyle Paramètres de style de la ligne de données lorsque le FormView contrôle est en mode édition.
EmptyDataRowStyle Paramètres de style pour la ligne de données vide affichée dans le FormView contrôle lorsque la source de données ne contient aucun enregistrement.
FooterStyle Paramètres de style pour la ligne de pied de page du FormView contrôle.
HeaderStyle Paramètres de style pour la ligne d’en-tête du FormView contrôle.
InsertRowStyle Paramètres de style pour la ligne de données lorsque le FormView contrôle est en mode insertion.
PagerStyle Paramètres de style pour la ligne du pagineur affiché dans le FormView contrôle lorsque la fonctionnalité de pagination est activée.
RowStyle Paramètres de style pour la ligne de données lorsque le FormView contrôle est en mode lecture seule.

Événements

Le FormView contrôle fournit plusieurs événements sur lesquels vous pouvez programmer. Cela vous permet d’exécuter une routine personnalisée chaque fois qu’un événement se produit. Le tableau suivant répertorie les événements pris en charge par le FormView contrôle.

Événement Description
ItemCommand Se produit lorsqu'un clic est effectué sur un bouton du contrôle FormView. Cet événement est souvent utilisé pour effectuer une tâche lorsqu’un bouton est cliqué dans le contrôle.
ItemCreated Se produit après la création de tous les FormViewRow objets dans le FormView contrôle. Cet événement est souvent utilisé pour modifier les valeurs d’un enregistrement avant son affichage.
ItemDeleted Se produit lorsqu’un bouton Supprimer (un bouton dont la CommandName propriété est définie sur « Supprimer ») est cliqué, mais après que le FormView contrôle a supprimé l’enregistrement de la source de données. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de suppression.
ItemDeleting Se produit quand un bouton Supprimer est cliqué, mais avant que le FormView contrôle supprime l’enregistrement de la source de données. Cet événement est souvent utilisé pour annuler l’opération de suppression.
ItemInserted Se produit lorsqu’un bouton Insérer (un bouton dont la CommandName propriété est définie sur « Insérer ») est cliqué, mais après que le FormView contrôle insère l’enregistrement. Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion.
ItemInserting Se produit lorsqu’un bouton Insérer est cliqué, mais avant que le FormView contrôle insère l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération d’insertion.
ItemUpdated Se produit lorsqu’un bouton Mettre à jour (un bouton dont la CommandName propriété est définie sur « Mettre à jour ») est cliqué, mais après que le FormView contrôle a mis à jour la ligne. Cet événement est souvent utilisé pour vérifier les résultats de l’opération de mise à jour.
ItemUpdating Se produit lorsqu’un bouton Mettre à jour est cliqué, mais avant que le FormView contrôle ne met à jour l’enregistrement. Cet événement est souvent utilisé pour annuler l’opération de mise à jour.
ModeChanged Se produit après que le contrôle change de FormView mode (pour modifier, insérer ou en mode lecture seule). Cet événement est souvent utilisé pour effectuer une tâche lorsque le contrôle change de FormView mode.
ModeChanging Se produit avant que le contrôle change de FormView mode (pour modifier, insérer ou en mode lecture seule). Cet événement est souvent utilisé pour annuler un changement de mode.
PageIndexChanged Se produit lorsqu'un clic est effectué sur un des boutons de pagineur, mais une fois que le contrôle FormView a géré l'opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche après que l’utilisateur accède à un autre enregistrement dans le contrôle.
PageIndexChanging Se produit lorsqu'un clic est effectué sur des boutons du pagineur et avant que le contrôle FormView n'ait géré l'opération de pagination. Cet événement est souvent utilisé pour annuler l’opération de pagination.

Accessibilité

Pour plus d’informations sur la configuration de ce contrôle afin qu’il génère un balisage conforme aux normes d’accessibilité, consultez Accessibilité dans Visual Studio et ASP.NET et ASP.NET contrôles et accessibilité.

Application de styles CSS

Le FormView contrôle vous permet de spécifier des règles de style CSS dans le balisage. Si vous utilisez des modèles pour personnaliser l’apparence du FormView contrôle, vous pouvez spécifier des styles CSS dans le balisage des modèles. Dans ce cas, aucune table externe supplémentaire n’est requise. Vous pouvez empêcher le rendu de la table en affectant à la propriété la RenderOuterTable valeur false.

Syntaxe déclarative

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

Constructeurs

FormView()

Initialise une nouvelle instance de la classe FormView.

Propriétés

AccessKey

Obtient ou définit la touche d'accès rapide qui vous permet de naviguer rapidement vers le contrôle serveur Web.

(Hérité de WebControl)
Adapter

Obtient l'adaptateur spécifique au navigateur pour le contrôle.

(Hérité de Control)
AllowPaging

Obtient ou définit une valeur indiquant si la fonctionnalité de pagination est activée.

AppRelativeTemplateSourceDirectory

Obtient ou définit le répertoire virtuel relatif à l'application de l'objet Page ou UserControl qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d'attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas à des propriétés du contrôle.

(Hérité de WebControl)
BackColor

Obtient ou définit la couleur d'arrière-plan du contrôle serveur Web.

(Hérité de WebControl)
BackImageUrl

Obtient ou définit l'URL d'une image à afficher à l'arrière-plan d'un contrôle FormView.

BindingContainer

Obtient le contrôle qui contient la liaison de données de ce contrôle.

(Hérité de Control)
BorderColor

Obtient ou définit la couleur de bordure du contrôle Web.

(Hérité de WebControl)
BorderStyle

Obtient ou définit le style de bordure du contrôle serveur Web.

(Hérité de WebControl)
BorderWidth

Obtient ou définit la largeur de bordure du contrôle serveur Web.

(Hérité de WebControl)
BottomPagerRow

Obtient l'objet FormViewRow qui représente la ligne de pagineur affichée en bas du contrôle FormView.

Caption

Obtient ou définit le texte à afficher dans un élément de légende HTML d'un contrôle FormView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

CaptionAlign

Obtient ou définit la position horizontale ou verticale de l'élément de légende HTML dans un contrôle FormView. Cette propriété est fournie pour rendre le contrôle plus accessible aux utilisateurs d'appareils de technologie d'assistance.

CellPadding

Obtient ou définit l'espace entre le contenu d'une cellule et la bordure de celle-ci.

CellSpacing

Obtient ou définit l'espace entre les cellules.

ChildControlsCreated

Obtient une valeur qui indique si des contrôles enfants du contrôle serveur ont été créés.

(Hérité de Control)
ClientID

Obtient l’ID de contrôle du balisage HTML généré par ASP.NET.

(Hérité de Control)
ClientIDMode

Obtient ou définit l'algorithme utilisé pour générer la valeur de la propriété ClientID.

(Hérité de Control)
ClientIDSeparator

Obtient une valeur de caractère représentant le caractère de séparation utilisé dans la propriété ClientID.

(Hérité de Control)
Context

Obtient l'objet HttpContext associé au contrôle serveur pour la demande Web en cours.

(Hérité de Control)
Controls

Obtient une collection de contrôles enfants dans le contrôle composite lié aux données.

(Hérité de CompositeDataBoundControl)
ControlStyle

Obtient le style d'un contrôle serveur Web. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ControlStyleCreated

Obtient une valeur indiquant si un objet Style a été créé pour la propriété ControlStyle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CssClass

Obtient ou définit la classe de feuille de style en cascade (CSS, Cascading Style Sheet) rendue par le contrôle serveur Web sur le client.

(Hérité de WebControl)
CurrentMode

Obtient le mode d'entrée des données actuel du contrôle FormView.

DataItem

Obtient l'élément de données lié au contrôle FormView.

DataItemContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataItemContainer.

(Hérité de Control)
DataItemCount

Obtient le nombre d'éléments de données dans la source de données.

DataItemIndex

Obtient l'index de l'élément de données lié au contrôle FormView de la source de données.

DataKey

Obtient un objet DataKey qui représente la clé primaire de l'enregistrement affiché.

DataKeyNames

Obtient ou définit un tableau qui contient les noms des champs clés pour la source de données.

DataKeysContainer

Obtient une référence au conteneur d'attribution de noms si celui-ci implémente IDataKeysControl.

(Hérité de Control)
DataMember

Obtient ou définit le nom de la liste des données auxquelles le contrôle lié aux données se lie, dans les cas où la source de données contient plusieurs listes distinctes d'éléments de données.

(Hérité de DataBoundControl)
DataSource

Obtient ou définit l'objet duquel le contrôle lié aux données récupère sa liste d'éléments de données.

(Hérité de BaseDataBoundControl)
DataSourceID

Obtient ou définit l’ID du contrôle à partir duquel le contrôle lié aux données récupère sa liste d’éléments de données.

(Hérité de DataBoundControl)
DataSourceObject

Obtient un objet qui implémente l'interface IDataSource, qui fournit l'accès au contenu des données de l'objet.

(Hérité de DataBoundControl)
DefaultMode

Obtient ou définit le mode d'entrée des données dans lequel le contrôle FormView retourne après une opération de mise à jour, d'insertion ou d'annulation.

DeleteMethod

Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération de suppression.

DeleteMethod

Obtient ou définit le nom de la méthode à appeler afin de supprimer des données.

(Hérité de CompositeDataBoundControl)
DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une aire de conception.

(Hérité de Control)
EditItemTemplate

Obtient ou définit le contenu personnalisé d'un élément en mode édition.

EditRowStyle

Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données lorsqu'un contrôle FormView est en mode édition.

EmptyDataRowStyle

Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données vide affichée lorsque la source de données liée à un contrôle FormView ne contient pas d'enregistrements.

EmptyDataTemplate

Obtient ou définit le contenu défini par l'utilisateur de la ligne de données vide rendue lorsqu'un contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements.

EmptyDataText

Obtient ou définit le texte à afficher dans la ligne de données vide rendue lorsqu'un contrôle FormView est lié à une source de données qui ne contient pas d'enregistrements.

Enabled

Obtient ou définit une valeur indiquant si le contrôle serveur Web est activé.

(Hérité de WebControl)
EnableModelValidation

Obtient ou définit une valeur qui indique si un contrôle de validateur doit gérer les exceptions susceptibles de se produire lors des opérations d'insertion ou de mise à jour.

EnableTheming

Obtient ou définit une valeur indiquant si les thèmes s'appliquent à ce contrôle.

(Hérité de WebControl)
EnableViewState

Obtient ou définit une valeur indiquant si le contrôle serveur conserve son état d’affichage, et l’état d’affichage de tous les contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient la liste des délégués de gestionnaires d'événements pour le contrôle. Cette propriété est en lecture seule.

(Hérité de Control)
Font

Obtient les propriétés de police associées au contrôle serveur Web.

(Hérité de WebControl)
FooterRow

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

FooterStyle

Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pied de page dans un contrôle FormView.

FooterTemplate

Obtient ou définit le contenu défini par l'utilisateur pour la ligne de pied de page dans un contrôle FormView.

FooterText

Obtient ou définit le texte à afficher dans la ligne de pied de page d'un contrôle FormView.

ForeColor

Obtient ou définit la couleur de premier plan (généralement la couleur du texte) du contrôle serveur Web.

(Hérité de WebControl)
GridLines

Obtient ou définit le style de quadrillage d'un contrôle FormView.

HasAttributes

Obtient une valeur indiquant si le contrôle a des attributs définis.

(Hérité de WebControl)
HasChildViewState

Obtient une valeur indiquant si les contrôles enfants du contrôle serveur en cours possèdent des paramètres d'état d'affichage enregistrés.

(Hérité de Control)
HeaderRow

Obtient l'objet FormViewRow qui représente la ligne d'en-tête dans un contrôle FormView.

HeaderStyle

Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne d'en-tête dans un contrôle FormView.

HeaderTemplate

Obtient ou définit le contenu défini par l'utilisateur pour la ligne d'en-tête dans un contrôle FormView.

HeaderText

Obtient ou définit le texte à afficher dans la ligne d'en-tête d'un contrôle FormView.

Height

Obtient ou définit la hauteur du contrôle serveur Web.

(Hérité de WebControl)
HorizontalAlign

Obtient ou définit l'alignement horizontal d'un contrôle FormView sur la page.

ID

Obtient ou définit l'ID programmatique assigné au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer des identificateurs de contrôle.

(Hérité de Control)
Initialized

Obtient une valeur indiquant si le contrôle lié aux données a été initialisé.

(Hérité de BaseDataBoundControl)
InsertItemTemplate

Obtient ou définit le contenu personnalisé d'un élément en mode insertion.

InsertMethod

Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération d'insertion.

InsertMethod

Obtient ou définit le nom de la méthode à appeler afin d'insérer des données.

(Hérité de CompositeDataBoundControl)
InsertRowStyle

Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données dans un contrôle FormView lorsque le contrôle est en mode insertion.

IsBoundUsingDataSourceID

Obtient une valeur indiquant si la propriété DataSourceID est définie.

(Hérité de BaseDataBoundControl)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle utilisent l'état du contrôle.

(Hérité de Control)
IsDataBindingAutomatic

Obtient une valeur qui indique si la liaison de données est automatique.

(Hérité de BaseDataBoundControl)
IsEnabled

Obtient une valeur indiquant si le contrôle est activé.

(Hérité de WebControl)
IsTrackingViewState

Obtient une valeur qui indique si le contrôle serveur enregistre les modifications apportées à son état d'affichage.

(Hérité de Control)
IsUsingModelBinders

Obtient une valeur qui indique si la liaison de modèle est utilisée.

(Hérité de CompositeDataBoundControl)
IsViewStateEnabled

Obtient une valeur indiquant si l'état d'affichage est activé pour ce contrôle.

(Hérité de Control)
ItemTemplate

Obtient ou définit le contenu personnalisé pour la ligne de données dans un contrôle FormView lorsque le contrôle est en mode lecture seule.

ItemType

Obtient ou définit le nom du type d'élément de données pour la liaison de données fortement typée.

(Hérité de DataBoundControl)
LoadViewStateByID

Obtient une valeur indiquant si le contrôle participe au chargement de son état d'affichage par ID et non par index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d'attribution de noms du contrôle serveur, qui crée un espace de noms unique pour différencier les contrôles serveur dont la propriété ID possède la même valeur.

(Hérité de Control)
Page

Obtient une référence à l'instance de Page qui contient le contrôle serveur.

(Hérité de Control)
PageCount

Obtient le nombre total de pages requises pour afficher tous les enregistrements de la source de données.

PageIndex

Obtient ou définit l'index de la page affichée.

PagerSettings

Obtient une référence à l'objet PagerSettings vous permettant de définir les propriétés des boutons du pagineur dans un contrôle FormView.

PagerStyle

Obtient une référence à l'objet TableItemStyle vous permettant de définir l'apparence de la ligne de pagineur dans un contrôle FormView.

PagerTemplate

Obtient ou définit le contenu personnalisé de la ligne de pagineur dans un contrôle FormView.

Parent

Obtient une référence au contrôle parent du contrôle serveur dans la hiérarchie des contrôles de la page.

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le HTML restitué sera compatible.

(Hérité de Control)
RenderOuterTable

Obtient ou définit une valeur qui indique si le contrôle intègre le HTML restitué dans un élément table pour lui appliquer des styles intralignes.

RequiresDataBinding

Obtient ou définit une valeur indiquant si la méthode DataBind() doit être appelée.

(Hérité de BaseDataBoundControl)
Row

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

RowStyle

Obtient une référence à l'objet TableItemStyle qui vous permet de définir l'apparence de la ligne de données dans un contrôle FormView lorsque le contrôle est en mode lecture seule.

SelectArguments

Obtient un objet DataSourceSelectArguments que le contrôle lié aux données utilise lors de la récupération de données d'un contrôle de source de données.

(Hérité de DataBoundControl)
SelectedValue

Obtient la valeur de clés des données de l'enregistrement en cours dans un contrôle FormView.

SelectMethod

Nom de la méthode à appeler pour pouvoir lire les données.

(Hérité de DataBoundControl)
Site

Obtient des informations sur le conteneur qui héberge le contrôle en cours lorsqu'il est rendu sur une aire de conception.

(Hérité de Control)
SkinID

Obtient ou définit l’apparence à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d'attributs de texte qui sont rendus en tant qu'attribut de style sur la balise extérieure d'un contrôle serveur Web.

(Hérité de WebControl)
SupportsDisabledAttribute

Obtient une valeur qui indique si le contrôle doit définir l'attribut disabled de l'élément HTML rendu avec la valeur « disabled » quand la propriété IsEnabled du contrôle a la valeur false.

(Hérité de BaseDataBoundControl)
TabIndex

Obtient ou définit l'index de tabulation du contrôle serveur Web.

(Hérité de WebControl)
TagKey

Obtient la valeur HtmlTextWriterTag du contrôle FormView.

TagName

Obtient le nom de la balise du contrôle. Cette propriété est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
TemplateControl

Obtient ou définit une référence au modèle qui contient ce contrôle.

(Hérité de Control)
TemplateSourceDirectory

Obtient le répertoire virtuel du Page ou du UserControl qui contient le contrôle serveur en cours.

(Hérité de Control)
ToolTip

Obtient ou définit le texte affiché quand le pointeur de la souris est positionné sur le contrôle serveur Web.

(Hérité de WebControl)
TopPagerRow

Obtient l'objet FormViewRow qui représente la ligne de pagineur affichée en haut d'un contrôle FormView.

UniqueID

Obtient l'identificateur unique qualifié sur le plan hiérarchique du contrôle serveur.

(Hérité de Control)
UpdateMethod

Obtient ou définit le nom de la méthode dans la page appelée lorsque le contrôle effectue une opération de mise à jour.

UpdateMethod

Obtient ou définit le nom de la méthode à appeler afin de mettre à jour des données.

(Hérité de CompositeDataBoundControl)
ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l'entrée cliente du navigateur à la recherche de valeurs potentiellement dangereuses.

(Hérité de Control)
ViewState

Obtient un dictionnaire d'informations d'état qui vous permet d'enregistrer et de restaurer l'état d'affichage d'un contrôle serveur entre plusieurs demandes de la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l'objet StateBag respecte la casse.

(Hérité de Control)
ViewStateMode

Obtient ou définit le mode d'état d'affichage de ce contrôle.

(Hérité de Control)
Visible

Obtient ou définit une valeur qui indique si un contrôle serveur est rendu en tant qu’interface utilisateur sur la page.

(Hérité de Control)
Width

Obtient ou définit la largeur du contrôle serveur web.

(Hérité de WebControl)

Méthodes

AddAttributesToRender(HtmlTextWriter)

Ajoute des attributs et des styles HTML qui doivent être rendus au HtmlTextWriterTag spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
AddedControl(Control, Int32)

Méthode appelée après qu’un contrôle enfant est ajouté à la collection Controls de l’objet Control.

(Hérité de Control)
AddParsedSubObject(Object)

Avertit le contrôle serveur qu’un élément XML ou HTML a été analysé, et ajoute l’élément à l’objet ControlCollection du contrôle serveur.

(Hérité de Control)
ApplyStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ApplyStyleSheetSkin(Page)

Applique les propriétés de style définies dans la feuille de style de la page au contrôle.

(Hérité de Control)
BeginRenderTracing(TextWriter, Object)

Commence le traçage au moment du design des données de rendu.

(Hérité de Control)
BuildProfileTree(String, Boolean)

Collecte des informations sur le contrôle serveur et les livre à la propriété Trace à afficher lorsque le traçage est activé pour la page.

(Hérité de Control)
ChangeMode(FormViewMode)

Bascule le contrôle FormView en mode d'entrée des données spécifié.

ClearCachedClientID()

Affecte à la valeur ClientID mise en cache la valeur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations sur l'état du contrôle des contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations sur l'état d'affichage et sur l'état du contrôle de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildViewState()

Supprime les informations d'état d'affichage de tous les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearEffectiveClientIDMode()

Affecte la valeur ClientIDMode à la propriété Inherit de l'instance de contrôle actuelle et de tous contrôles enfants.

(Hérité de Control)
ConfirmInitState()

Définit l'état initialisé du contrôle lié aux données.

(Hérité de BaseDataBoundControl)
CopyBaseAttributes(WebControl)

Copie les propriétés non encapsulées par l'objet Style du contrôle serveur Web spécifié vers le contrôle serveur Web à partir duquel cette méthode est appelée. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Crée la hiérarchie des contrôles utilisée pour restituer un contrôle composite lié aux données basé sur les valeurs qui sont stockées dans l'état d'affichage.

(Hérité de CompositeDataBoundControl)
CreateChildControls(IEnumerable, Boolean)

Crée la hiérarchie des contrôles utilisée pour rendre le contrôle FormView à l'aide de la source de données spécifiée.

CreateControlCollection()

Crée un objet ControlCollection pour contenir les contrôles enfants (littéraux et serveur) du contrôle serveur.

(Hérité de Control)
CreateControlStyle()

Crée un objet de style de tableau par défaut pour le contrôle FormView.

CreateDataSourceSelectArguments()

Crée l'objet DataSourceSelectArguments qui contient les arguments passés à la source de données pour être traités.

CreateRow(Int32, DataControlRowType, DataControlRowState)

Crée un objet FormViewRow à l'aide de l'index de l'élément, du type de ligne et de l'état de ligne spécifiés.

CreateTable()

Crée la table conteneur pour le contrôle FormView.

DataBind()

Lie la source de données au contrôle FormView.

DataBind(Boolean)

Lie une source de données au contrôle serveur appelé et tous ses contrôles enfants avec une option pour déclencher l'événement DataBinding.

(Hérité de Control)
DataBindChildren()

Lie une source de données aux contrôles enfants du contrôle serveur.

(Hérité de Control)
DeleteItem()

Supprime l'enregistrement actif dans le contrôle FormView de la source de données.

Dispose()

Permet à un contrôle serveur d'effectuer le nettoyage final avant qu'il soit libéré de la mémoire.

(Hérité de Control)
EndRenderTracing(TextWriter, Object)

Met fin au traçage au moment du design des données de rendu.

(Hérité de Control)
EnsureChildControls()

Détermine si le contrôle serveur contient des contrôles enfants. S'il ne contient pas de contrôles enfants, il en crée.

(Hérité de Control)
EnsureDataBound()

S'assure que le contrôle FormView est lié aux données lorsque cela s'avère nécessaire.

EnsureID()

Crée un identificateur pour les contrôles auxquels aucun identificateur n'est assigné.

(Hérité de Control)
Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.

(Hérité de Object)
ExtractRowValues(IOrderedDictionary, Boolean)

Récupère les valeurs de chaque champ déclarées dans la ligne de données spécifiée et les stocke dans l'objet IOrderedDictionary spécifié.

FindControl(String)

Recherche un contrôle serveur possédant le paramètre id spécifié dans le conteneur d'attribution de noms actuel.

(Hérité de Control)
FindControl(String, Int32)

Recherche le conteneur d'attribution de noms actuel d'un contrôle serveur avec l'id spécifié et un entier, spécifié dans le paramètre pathOffset, qui facilite la recherche. Vous ne devez pas substituer cette version de la méthode FindControl.

(Hérité de Control)
Focus()

Affecte le focus d'entrée à un contrôle.

(Hérité de Control)
GetData()

Récupère un objet DataSourceView que le contrôle lié aux données utilise pour exécuter des opérations de données.

(Hérité de DataBoundControl)
GetDataSource()

Récupère l'interface IDataSource à laquelle le contrôle lié aux données est associé, le cas échéant.

(Hérité de DataBoundControl)
GetDesignModeState()

Obtient les données au moment du design pour un contrôle.

(Hérité de Control)
GetHashCode()

Fait office de fonction de hachage par défaut.

(Hérité de Object)
GetRouteUrl(Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, Object)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetRouteUrl(String, RouteValueDictionary)

Obtient l'URL qui correspond à un jeu de paramètres d'itinéraire et à un nom d'itinéraire.

(Hérité de Control)
GetType()

Obtient le Type de l'instance actuelle.

(Hérité de Object)
GetUniqueIDRelativeTo(Control)

Retourne la partie préfixée de la propriété UniqueID du contrôle spécifié.

(Hérité de Control)
HasControls()

Détermine si le contrôle serveur contient des contrôles enfants.

(Hérité de Control)
HasEvents()

Retourne une valeur indiquant si des événements sont inscrits pour le contrôle ou des contrôles enfants.

(Hérité de Control)
InitializePager(FormViewRow, PagedDataSource)

Crée la ligne de pagineur pour le contrôle FormView.

InitializeRow(FormViewRow)

Initialise l'objet FormViewRow spécifié.

InsertItem(Boolean)

Insère l'enregistrement actif dans la source de données.

IsBindableType(Type)

Détermine si le type de données spécifié peut être lié à un champ dans le contrôle FormView.

IsLiteralContent()

Détermine si le contrôle serveur ne détient qu'un contenu littéral.

(Hérité de Control)
LoadControlState(Object)

Charge l'état des propriétés du contrôle FormView à faire persister, même lorsque la propriété EnableViewState a la valeur false.

LoadViewState(Object)

Charge l'état d'affichage enregistré précédemment du contrôle FormView.

MapPathSecure(String)

Récupère le chemin d'accès physique auquel un chemin d'accès virtuel, absolu ou relatif, correspond.

(Hérité de Control)
MarkAsDataBound()

Définit l'état du contrôle dans l'état d'affichage comme lié avec succès aux données.

(Hérité de DataBoundControl)
MemberwiseClone()

Crée une copie superficielle du Object actuel.

(Hérité de Object)
MergeStyle(Style)

Copie tous les éléments non vides du style spécifié vers le contrôle Web, mais ne remplace aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ModifiedOuterTableStylePropertyName()

Détermine si les règles de style CSS spécifiques à la table associées au contrôle FormView ont pour valeur leurs valeurs par défaut.

OnBubbleEvent(Object, EventArgs)

Gère un événement remonté dans la hiérarchie des contrôles.

OnCreatingModelDataSource(CreatingModelDataSourceEventArgs)

Déclenche l’événement CreatingModelDataSource.

(Hérité de DataBoundControl)
OnDataBinding(EventArgs)

Déclenche l’événement DataBinding.

(Hérité de Control)
OnDataBound(EventArgs)

Déclenche l’événement DataBound.

(Hérité de BaseDataBoundControl)
OnDataPropertyChanged()

Relie le contrôle lié aux données à ses données après la modification d'une des propriétés de l'identification de la source de données de base.

(Hérité de DataBoundControl)
OnDataSourceViewChanged(Object, EventArgs)

Déclenche l’événement DataSourceViewChanged.

(Hérité de DataBoundControl)
OnInit(EventArgs)

Déclenche l’événement Init.

OnItemCommand(FormViewCommandEventArgs)

Déclenche l’événement ItemCommand.

OnItemCreated(EventArgs)

Déclenche l’événement ItemCreated.

OnItemDeleted(FormViewDeletedEventArgs)

Déclenche l’événement ItemDeleted.

OnItemDeleting(FormViewDeleteEventArgs)

Déclenche l’événement ItemDeleting.

OnItemInserted(FormViewInsertedEventArgs)

Déclenche l’événement ItemInserted.

OnItemInserting(FormViewInsertEventArgs)

Déclenche l’événement ItemInserting.

OnItemUpdated(FormViewUpdatedEventArgs)

Déclenche l’événement ItemUpdated.

OnItemUpdating(FormViewUpdateEventArgs)

Déclenche l’événement ItemUpdating.

OnLoad(EventArgs)

Gère l'événement Load.

(Hérité de DataBoundControl)
OnModeChanged(EventArgs)

Déclenche l’événement ModeChanged.

OnModeChanging(FormViewModeEventArgs)

Déclenche l’événement ModeChanging.

OnPageIndexChanged(EventArgs)

Déclenche l’événement PageIndexChanged.

OnPageIndexChanging(FormViewPageEventArgs)

Déclenche l’événement PageIndexChanging.

OnPagePreLoad(Object, EventArgs)

Définit l'état initialisé du contrôle lié aux données avant que le contrôle ne soit chargé.

(Hérité de DataBoundControl)
OnPreRender(EventArgs)

Gère l'événement PreRender.

(Hérité de BaseDataBoundControl)
OnUnload(EventArgs)

Déclenche l’événement Unload.

(Hérité de Control)
OpenFile(String)

Obtient un Stream utilisé pour lire un fichier.

(Hérité de Control)
PerformDataBinding(IEnumerable)

Lie la source de données spécifiée au contrôle FormView.

PerformSelect()

Récupère les données de la source de données associée.

(Hérité de DataBoundControl)
PrepareControlHierarchy()

Définit la hiérarchie des contrôles du contrôle FormView.

RaiseBubbleEvent(Object, EventArgs)

Assigne les sources éventuelles de l'événement et ses informations au parent du contrôle.

(Hérité de Control)
RaisePostBackEvent(String)

Déclenche les événements appropriés pour le contrôle FormView lors de la publication sur le serveur.

RemovedControl(Control)

Méthode appelée après la suppression d’un contrôle enfant de la collection Controls de l’objet Control.

(Hérité de Control)
Render(HtmlTextWriter)

Affiche le contrôle FormView sur le client.

RenderBeginTag(HtmlTextWriter)

Génère le rendu de la balise d'ouverture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderChildren(HtmlTextWriter)

Produit le contenu des enfants d'un contrôle serveur dans un objet HtmlTextWriter fourni qui écrit le contenu à restituer sur le client.

(Hérité de Control)
RenderContents(HtmlTextWriter)

Génère le rendu du contenu du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
RenderControl(HtmlTextWriter)

Envoie le contenu du contrôle serveur à un objet HtmlTextWriter fourni et stocke les informations de traçage sur le contrôle si le traçage est activé.

(Hérité de Control)
RenderControl(HtmlTextWriter, ControlAdapter)

Génère le contenu du contrôle serveur dans un objet HtmlTextWriter à l'aide d'un objet ControlAdapter fourni.

(Hérité de Control)
RenderEndTag(HtmlTextWriter)

Génère le rendu de la balise de fermeture HTML du contrôle via le writer spécifié. Cette méthode est principalement utilisée par des développeurs de contrôles.

(Hérité de WebControl)
ResolveAdapter()

Obtient l'adaptateur de contrôles responsable du rendu du contrôle spécifié.

(Hérité de Control)
ResolveClientUrl(String)

Obtient une URL qui peut être utilisée par le navigateur.

(Hérité de Control)
ResolveUrl(String)

Convertit une URL en une URL que le client soit en mesure d'utiliser.

(Hérité de Control)
SaveControlState()

Enregistre l'état des propriétés du contrôle FormView à faire persister, même lorsque la propriété EnableViewState a la valeur false.

SaveViewState()

Enregistre l'état d'affichage actuel du contrôle FormView.

SetDesignModeState(IDictionary)

Définit les données au moment du design pour un contrôle.

(Hérité de Control)
SetPageIndex(Int32)

Définit l'index de la page actuellement affichée dans le contrôle FormView.

SetRenderMethodDelegate(RenderMethod)

Assigne un délégué de gestionnaires d'événements pour générer le rendu du contrôle serveur et de son contenu dans son contrôle parent.

(Hérité de Control)
SetTraceData(Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design à l'aide de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
SetTraceData(Object, Object, Object)

Définit les données de trace pour le suivi du rendu des données au moment du design, à l'aide de l'objet suivi, de la clé des données de trace et de la valeur des données de trace.

(Hérité de Control)
ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)
TrackViewState()

Marque le point de départ du suivi et de l'enregistrement des modifications d'état d'affichage apportées au contrôle FormView.

UpdateItem(Boolean)

Met à jour l'enregistrement en cours dans la source de données.

ValidateDataSource(Object)

Vérifie que l'objet auquel un contrôle lié aux données se lie est un objet avec qui il peut fonctionner.

(Hérité de DataBoundControl)

Événements

CallingDataMethods

Se produit lorsque les méthodes de données sont appelées.

(Hérité de DataBoundControl)
CreatingModelDataSource

Se produit lorsque l'objet ModelDataSource est créé.

(Hérité de DataBoundControl)
DataBinding

Se produit lorsque le contrôle serveur se lie à une source de données.

(Hérité de Control)
DataBound

Se produit après la liaison du contrôle serveur à une source de données.

(Hérité de BaseDataBoundControl)
Disposed

Se produit lorsqu'un contrôle serveur est libéré de la mémoire, ce qui constitue la dernière étape du cycle de vie d'un contrôle serveur en cas de demande d'une page ASP.NET.

(Hérité de Control)
Init

Se produit lorsque le contrôle serveur est initialisé, ce qui constitue la première étape de son cycle de vie.

(Hérité de Control)
ItemCommand

Se produit lorsqu'un clic est effectué sur un bouton du contrôle FormView.

ItemCreated

Se produit une fois que toutes les lignes sont créées dans un contrôle FormView.

ItemDeleted

Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle FormView, mais après l'opération de suppression.

ItemDeleting

Se produit lorsqu'un clic est effectué sur un bouton Supprimer d'un contrôle FormView, mais avant l'opération de suppression.

ItemInserted

Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle FormView, mais après l'opération d'insertion.

ItemInserting

Se produit lorsqu'un clic est effectué sur un bouton Insérer dans un contrôle FormView, mais avant l'opération d'insertion.

ItemUpdated

Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle FormView, mais après l'opération de mise à jour.

ItemUpdating

Se produit lorsqu'un clic est effectué sur un bouton Mettre à jour dans un contrôle FormView, mais avant l'opération de mise à jour.

Load

Se produit lorsque le contrôle serveur est chargé dans l'objet Page.

(Hérité de Control)
ModeChanged

Se produit lorsque le contrôle FormView bascule entre les modes édition, insertion et lecture seule, mais après le changement de mode.

ModeChanging

Se produit lorsque le contrôle FormView bascule entre les modes édition, insertion et lecture seule, mais avant le changement de mode.

PageIndexChanged

Se produit lorsque la valeur de la propriété PageIndex change après une opération de pagination.

PageIndexChanging

Se produit lorsque la valeur de la propriété PageIndex change avant une opération de pagination.

PreRender

Se produit après le chargement de l'objet Control mais avant le rendu.

(Hérité de Control)
Unload

Se produit lorsque le contrôle serveur est déchargé de la mémoire.

(Hérité de Control)

Implémentations d’interfaces explicites

IAttributeAccessor.GetAttribute(String)

Obtient un attribut du contrôle Web avec le nom spécifié.

(Hérité de WebControl)
IAttributeAccessor.SetAttribute(String, String)

Affecte au nom et à la valeur spécifiés un attribut du contrôle Web.

(Hérité de WebControl)
IControlBuilderAccessor.ControlBuilder

Pour obtenir une description de ce membre, consultez ControlBuilder.

(Hérité de Control)
IControlDesignerAccessor.GetDesignModeState()

Pour obtenir une description de ce membre, consultez GetDesignModeState().

(Hérité de Control)
IControlDesignerAccessor.SetDesignModeState(IDictionary)

Pour obtenir une description de ce membre, consultez SetDesignModeState(IDictionary).

(Hérité de Control)
IControlDesignerAccessor.SetOwnerControl(Control)

Pour obtenir une description de ce membre, consultez SetOwnerControl(Control).

(Hérité de Control)
IControlDesignerAccessor.UserData

Pour obtenir une description de ce membre, consultez UserData.

(Hérité de Control)
IDataBindingsAccessor.DataBindings

Pour obtenir une description de ce membre, consultez DataBindings.

(Hérité de Control)
IDataBindingsAccessor.HasDataBindings

Pour obtenir une description de ce membre, consultez HasDataBindings.

(Hérité de Control)
IDataBoundControl.DataKeyNames

Obtient ou définit un tableau qui contient les noms des champs clé primaire des éléments qui sont affichés dans le contrôle FormView.

IDataBoundControl.DataMember

Obtient ou définit le nom de la liste des éléments de données auquel le contrôle FormView se lie lorsque la source de données contient plusieurs listes d'éléments de données.

IDataBoundControl.DataSource

Obtient ou définit l'objet qui contient la liste des données que le contrôle FormView récupère.

IDataBoundControl.DataSourceID

Obtient ou définit l'ID du contrôle de source de données qui contient la liste des éléments de données que le contrôle FormView récupère.

IDataBoundControl.DataSourceObject

Obtient l'objet source de données qui contient la liste des éléments de données que le contrôle FormView récupère.

IDataBoundItemControl.DataKey

Obtient l'objet qui représente la valeur de clés des données de la ligne dans le contrôle FormView.

IDataBoundItemControl.Mode

Obtient le mode actuel du FormView.

IDataItemContainer.DataItemIndex

Pour obtenir une description de ce membre, consultez DataItemIndex.

IDataItemContainer.DisplayIndex

Pour obtenir une description de ce membre, consultez DisplayIndex.

IExpressionsAccessor.Expressions

Pour obtenir une description de ce membre, consultez Expressions.

(Hérité de Control)
IExpressionsAccessor.HasExpressions

Pour obtenir une description de ce membre, consultez HasExpressions.

(Hérité de Control)
IParserAccessor.AddParsedSubObject(Object)

Pour obtenir une description de ce membre, consultez AddParsedSubObject(Object).

(Hérité de Control)
IPostBackContainer.GetPostBackOptions(IButtonControl)

Détermine les options d'événement de publication (postback) du contrôle FormView.

IPostBackEventHandler.RaisePostBackEvent(String)

Déclenche des événements pour le contrôle FormView pendant la publication sur le serveur.

Méthodes d’extension

EnablePersistedSelection(BaseDataBoundControl)
Obsolète.

Permet la conservation de la sélection dans les contrôles de données qui prennent en charge la sélection et la pagination.

FindDataSourceControl(Control)

Retourne la source de données associée au contrôle de données pour le contrôle spécifié.

FindFieldTemplate(Control, String)

Retourne le modèle de champ pour la colonne spécifiée dans le conteneur d'attribution de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l'objet Metatable pour le contrôle de données conteneur.

GetDefaultValues(INamingContainer)

Obtient la collection des valeurs par défaut pour le contrôle de données spécifié.

GetMetaTable(INamingContainer)

Obtient les métadonnées de table pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable)

Définit les métadonnées de table pour le contrôle de données spécifié.

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

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

SetMetaTable(INamingContainer, MetaTable, Object)

Définit les métadonnées de table et le mappage des valeurs par défaut pour le contrôle de données spécifié.

TryGetMetaTable(INamingContainer, MetaTable)

Détermine si des métadonnées de table sont disponibles.

EnableDynamicData(INamingContainer, Type)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

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

Active le comportement Dynamic Data pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement Dynamic Data pour le contrôle de données spécifié.

S’applique à

Voir aussi