Partager via


FormView Classe

Définition

Affiche les valeurs d’un enregistrement unique à partir d’une source de données à l’aide de modèles définis par l’utilisateur. Le FormView contrôle vous permet de modifier, supprimer et 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

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

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

Présentation

Le FormView contrôle est utilisé pour afficher un enregistrement unique à partir d’une source de données. Il est similaire au contrôle, sauf qu’il affiche des modèles définis par l’utilisateur DetailsView au lieu de champs de ligne. La création de vos propres modèles vous offre une plus grande flexibilité pour contrôler la façon dont les données sont affiché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 programmatique au FormView modèle objet pour définir dynamiquement les propriétés, gérer les événements, et ainsi de suite.

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

Modèles

Pour que le contrôle affiche le FormView 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 du texte à afficher dans la ligne du 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: En guise d’alternative, vous pouvez simplement spécifier du 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 d’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 du pagineur affiché lorsque la fonctionnalité de pagination est activée (lorsque la AllowPaging propriété est définie truesur ). 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 a 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 Data-Binding syntaxe d’expression.

Les contrôles d’entrée dans le modèle d’élément de modification et insérer un modèle 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 d’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 (par SqlDataSourceexemple, ou ObjectDataSource) ou AccessDataSourceà n’importe quelle collection de sources de données qui implémente l’interface System.Collections.IEnumerable , telle que 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 est automatiquement lié 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 préférée à lier aux données.

  • Pour établir une liaison à une source de données qui implémente l’interface System.Collections.IEnumerable , définissez par programme la DataSource propriété du FormView contrôle sur la source de données, puis appelez la DataBind méthode. Lorsque vous utilisez cette méthode, le FormView contrôle ne fournit pas de fonctionnalités intégrées 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 Mappage de contenu d’accès aux données.

Note

Ce contrôle peut être utilisé pour afficher l’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 l’afficher dans votre application. Dans la mesure du possible, il est fortement recommandé que les valeurs soient encodées au format HTML avant qu’elles ne soient 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. Les contrôles de serveur de validation sont également fournis pour évaluer l’entrée utilisateur. Pour plus d’informations, consultez Présentation des contrôles de validation.

Opérations sur les données

Le FormView contrôle fournit de nombreuses fonctionnalités intégrées qui permettent à l’utilisateur de mettre à jour, supprimer, insérer et 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.

Note

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 CommandName propriétés sont 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 « Supprimer » Utilisé dans les opérations de suppression pour supprimer l’enregistrement affiché de la source de données. Déclenche les événements et ItemDeleted les ItemDeleting événements.
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 événements et ItemInserted les ItemInserting événements.
Nouveau « Nouveau » Utilisé dans les opérations d’insertion pour placer le FormView contrôle en mode d’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 l’index de la page vers laquelle naviguer. Déclenche les événements et PageIndexChanged les PageIndexChanging événements. Note: Ce type de bouton est généralement utilisé uniquement dans le modèle de pagineur.
Update « Mettre à 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 événements et ItemUpdated les ItemUpdating événements.

Contrairement au bouton Supprimer (qui supprime immédiatement l’enregistrement affiché), lorsque le bouton Modifier ou Nouveau est cliqué, 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 sorte que le bouton Modifier soit remplacé par une mise à jour et un bouton Annuler. Les contrôles d’entrée appropriés pour le type de données du champ (par exemple, un TextBox ou un CheckBox contrôle) sont généralement affichés avec la valeur d’un champ que l’utilisateur doit modifier. Cliquer sur le bouton Mettre à jour met à jour l’enregistrement dans la source de données, tout en cliquant sur le bouton Annuler abandonne les modifications.

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’élément d’insertion est généralement défini de sorte que le bouton Nouveau soit remplacé par un bouton Insertion et Annuler, et que les contrôles d’entrée vides s’affichent pour que l’utilisateur entre les valeurs du nouvel enregistrement. Cliquer sur le bouton Insérer insère l’enregistrement dans la source de données, tout en cliquant sur le bouton Annuler abandonne les modifications.

Le FormView contrôle fournit une fonctionnalité de pagination, qui permet à l’utilisateur d’accéder à d’autres enregistrements dans la source de données. Lorsqu’elle est activée, une ligne de pagineur s’affiche dans le FormView contrôle qui contient les contrôles de navigation de page. Pour activer la pagination, définissez la AllowPaging propriété sur true. Vous pouvez personnaliser la ligne du pagineur en définissant les propriétés des objets contenus dans la PagerStyle propriété et dans celle-ci PagerSettings . Au lieu d’utiliser l’interface utilisateur de ligne du pagineur intégrée, 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.

Style, propriété 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 de 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 de la ligne de données lorsque le FormView contrôle est en mode Insertion.
PagerStyle Paramètres de style de la ligne du pagineur affichée dans le FormView contrôle lorsque la fonctionnalité de pagination est activée.
RowStyle Paramètres de style de 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 que 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 bouton dans un FormView contrôle est cliqué. Cet événement est souvent utilisé pour effectuer une tâche lorsqu’un bouton est cliqué dans le contrôle.
ItemCreated Se produit une fois tous les FormViewRow objets créés 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 une fois 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 lorsqu’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 Insertion (un bouton dont la CommandName propriété est définie sur « Insertion ») est cliqué, mais après que le contrôle insère l’enregistrement FormView . Cet événement est souvent utilisé pour vérifier les résultats de l’opération d’insertion.
ItemInserting Se produit lorsqu’un bouton Insertion 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 une fois que le FormView contrôle met à 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 contrôle ne met à jour l’enregistrement FormView . Cet événement est souvent utilisé pour annuler l’opération de mise à jour.
ModeChanged Se produit après que le FormView contrôle change les modes (pour modifier, insérer ou lire uniquement). Cet événement est souvent utilisé pour effectuer une tâche lorsque le FormView contrôle change de mode.
ModeChanging Se produit avant les modes de modification du FormView contrôle (pour modifier, insérer ou lire uniquement). Cet événement est souvent utilisé pour annuler une modification de mode.
PageIndexChanged Se produit lorsqu’un des boutons du pagineur est cliqué, mais après que le FormView contrôle gère l’opération de pagination. Cet événement est couramment utilisé lorsque vous devez effectuer une tâche une fois que l’utilisateur accède à un autre enregistrement dans le contrôle.
PageIndexChanging Se produit lorsqu’un des boutons du pagineur est cliqué, mais avant que le FormView contrôle gère 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 des marques conformes 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 dans les modèles. Dans ce cas, aucune table externe supplémentaire n’est requise. Vous pouvez empêcher le rendu de la table en définissant la RenderOuterTable propriété sur 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

Nom Description
FormView()

Initialise une nouvelle instance de la classe FormView.

Propriétés

Nom Description
AccessKey

Obtient ou définit la clé d’accès qui vous permet d’accéder rapidement au 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 du ou UserControl de l’objet Page qui contient ce contrôle.

(Hérité de Control)
Attributes

Obtient la collection d’attributs arbitraires (pour le rendu uniquement) qui ne correspondent pas aux 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 en arrière-plan d’un FormView contrôle.

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 du pagineur affichée en bas du FormView contrôle.

Caption

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

CaptionAlign

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

CellPadding

Obtient ou définit la quantité d’espace entre le contenu d’une cellule et la bordure de la cellule.

CellSpacing

Obtient ou définit la quantité d’espace entre les cellules.

ChildControlsCreated

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

(Hérité de Control)
ClientID

Obtient l’ID de contrôle pour le 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 ClientID propriété.

(Hérité de Control)
ClientIDSeparator

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

(Hérité de Control)
Context

Obtient l’objet HttpContext associé au contrôle serveur pour la requête Web actuelle.

(Hérité de Control)
Controls

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

(Hérité de CompositeDataBoundControl)
ControlStyle

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

(Hérité de WebControl)
ControlStyleCreated

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

(Hérité de WebControl)
CssClass

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

(Hérité de WebControl)
CurrentMode

Obtient le mode d’entrée de données actuel du FormView contrôle.

DataItem

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

DataItemContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataItemContainernoms implémente .

(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 FormView contrôle à partir de la source de données.

DataKey

Obtient un DataKey objet 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 de la source de données.

DataKeysContainer

Obtient une référence au conteneur d’affectation de noms si le conteneur d’affectation de IDataKeysControlnoms implémente .

(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 est lié, 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 à partir 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 de données sur lequel le FormView contrôle 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 sur la page appelée lorsque le contrôle effectue une opération de suppression.

DesignMode

Obtient une valeur indiquant si un contrôle est utilisé sur une surface 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 FormView contrôle 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 FormView contrôle ne contient aucun enregistrement.

EmptyDataTemplate

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

EmptyDataText

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

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 validateur gère les exceptions qui se produisent pendant les 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 des contrôles enfants qu’il contient, au client demandeur.

(Hérité de Control)
Events

Obtient une liste de délégués de gestionnaire 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 du pied de page dans un FormView contrôle.

FooterStyle

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

FooterTemplate

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

FooterText

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

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 FormView contrôle.

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 actuel ont 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 FormView contrôle.

HeaderStyle

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

HeaderTemplate

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

HeaderText

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

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 FormView contrôle sur la page.

ID

Obtient ou définit l’identificateur programmatique affecté au contrôle serveur.

(Hérité de Control)
IdSeparator

Obtient le caractère utilisé pour séparer les 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 d’insertion.

InsertMethod

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

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 FormView contrôle lorsque le contrôle est en mode d’insertion.

IsBoundUsingDataSourceID

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

(Hérité de BaseDataBoundControl)
IsChildControlStateCleared

Obtient une valeur indiquant si les contrôles contenus dans ce contrôle ont un état de 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 en cours d’utilisation.

(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é de la ligne de données dans un FormView contrôle 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 ID au lieu de l’index.

(Hérité de Control)
NamingContainer

Obtient une référence au conteneur d’affectation de noms du contrôle serveur, qui crée un espace de noms unique pour la différenciation entre les contrôles serveur avec la même ID valeur de propriété.

(Hérité de Control)
Page

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

(Hérité de Control)
PageCount

Obtient le nombre total de pages requises pour afficher chaque enregistrement dans 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 qui vous permet de définir les propriétés des boutons du pagineur dans un FormView contrôle.

PagerStyle

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

PagerTemplate

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

Parent

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

(Hérité de Control)
RenderingCompatibility

Obtient une valeur qui spécifie la version ASP.NET avec laquelle le code HTML rendu est compatible.

(Hérité de Control)
RenderOuterTable

Obtient ou définit une valeur qui indique si le contrôle place le code HTML rendu dans un table élément afin d’appliquer des styles inline.

RequiresDataBinding

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

(Hérité de BaseDataBoundControl)
Row

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

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 FormView contrôle lorsque le contrôle est en mode lecture seule.

SelectArguments

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

(Hérité de DataBoundControl)
SelectedValue

Obtient la valeur de clé de données de l’enregistrement actif dans un FormView contrôle.

SelectMethod

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

(Hérité de DataBoundControl)
Site

Obtient des informations sur le conteneur qui héberge le contrôle actuel lors du rendu sur une surface de conception.

(Hérité de Control)
SkinID

Obtient ou définit la peau à appliquer au contrôle.

(Hérité de WebControl)
Style

Obtient une collection d’attributs de texte qui seront rendus en tant qu’attribut de style sur la balise externe du 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 sur « disabled » lorsque la propriété du IsEnabled contrôle est 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 HtmlTextWriterTag valeur du FormView contrôle.

TagName

Obtient le nom de la balise de contrôle. Cette propriété est principalement utilisée par les 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 PageUserControl ou qui contient le contrôle serveur actuel.

(Hérité de Control)
ToolTip

Obtient ou définit le texte affiché lorsque le pointeur de la souris pointe sur le contrôle serveur Web.

(Hérité de WebControl)
TopPagerRow

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

UniqueID

Obtient l’identificateur unique qualifié hiérarchiquement pour le contrôle serveur.

(Hérité de Control)
UpdateMethod

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

ValidateRequestMode

Obtient ou définit une valeur qui indique si le contrôle vérifie l’entrée du client à partir du navigateur pour obtenir des 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 sur plusieurs requêtes pour la même page.

(Hérité de Control)
ViewStateIgnoresCase

Obtient une valeur qui indique si l’objet ne respecte pas la StateBag 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

Nom Description
AddAttributesToRender(HtmlTextWriter)

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

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

Appelé après l’ajout d’un contrôle enfant à la Controls collection 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 du ControlCollection contrôle serveur.

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

Copie tous les éléments non vides du style spécifié dans le contrôle Web, en remplaçant les éléments de style existants du contrôle. Cette méthode est principalement utilisée par les 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 page au contrôle.

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

Commence le suivi 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 le remet à la Trace propriété à afficher lorsque le suivi est activé pour la page.

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

Bascule le FormView contrôle vers le mode d’entrée de données spécifié.

ClearCachedClientID()

Définit la valeur mise en ClientID cache sur null.

(Hérité de Control)
ClearChildControlState()

Supprime les informations d’état du contrôle pour les contrôles enfants du contrôle serveur.

(Hérité de Control)
ClearChildState()

Supprime les informations d’état d’affichage et d’état de contrôle pour 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()

Définit la ClientIDMode propriété de l’instance de contrôle actuelle et de tous les contrôles enfants sur Inherit.

(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 les développeurs de contrôles.

(Hérité de WebControl)
CreateChildControls()

Crée la hiérarchie de contrôle utilisée pour afficher un contrôle composite lié aux données en fonction des valeurs stockées dans l’état d’affichage.

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

Crée la hiérarchie de contrôles utilisée pour afficher le FormView contrôle avec la source de données spécifiée.

CreateControlCollection()

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

(Hérité de Control)
CreateControlStyle()

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

CreateDataSourceSelectArguments()

Crée l’objet DataSourceSelectArguments qui contient les arguments passés à la source de données pour traitement.

CreateRow(Int32, DataControlRowType, DataControlRowState)

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

CreateTable()

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

DataBind()

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

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 FormView contrôle de la source de données.

Dispose()

Permet à un contrôle de serveur d’effectuer le nettoyage final avant de libérer de la mémoire.

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

Met fin au suivi 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. Si ce n’est pas le cas, il crée des contrôles enfants.

(Hérité de Control)
EnsureDataBound()

Permet de s’assurer que le FormView contrôle est lié aux données le cas échéant.

EnsureID()

Crée un identificateur pour les contrôles qui n’ont pas d’identificateur affecté.

(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é dans la ligne de données et les stocke dans l’objet spécifié IOrderedDictionary .

FindControl(String, Int32)

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

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

Recherche le conteneur d’affectation de noms actuel pour un contrôle serveur avec le paramètre spécifié id .

(Hérité de Control)
Focus()

Définit le focus d’entrée sur un contrôle.

(Hérité de Control)
GetData()

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

(Hérité de DataBoundControl)
GetDataSource()

Récupère l’interface IDataSource avec 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()

Sert de fonction de hachage par défaut.

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

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

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

Obtient l’URL qui correspond à un ensemble de paramètres de routage.

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

Obtient l’URL qui correspond à un ensemble 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 ensemble de paramètres d’itinéraire et à un nom d’itinéraire.

(Hérité de Control)
GetType()

Obtient la Type de l’instance actuelle.

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

Retourne la partie préfixée de la UniqueID propriété 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 les événements sont inscrits pour le contrôle ou les contrôles enfants.

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

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

InitializeRow(FormViewRow)

Initialise l’objet spécifié FormViewRow .

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 FormView contrôle.

IsLiteralContent()

Détermine si le contrôle serveur contient uniquement du contenu littéral.

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

Charge l’état des propriétés de FormView contrôle qui doivent être conservées, même lorsque la EnableViewState propriété est définie falsesur .

LoadViewState(Object)

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

MapPathSecure(String)

Récupère le chemin d’accès physique auquel un chemin virtuel, absolu ou relatif, est mappé.

(Hérité de Control)
MarkAsDataBound()

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

(Hérité de DataBoundControl)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

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

Copie tous les éléments non vides du style spécifié dans le contrôle Web, mais n’écrasera aucun élément de style existant du contrôle. Cette méthode est principalement utilisée par les 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 FormView contrôle sont définies sur leurs valeurs par défaut.

OnBubbleEvent(Object, EventArgs)

Gère un événement transmis via la hiérarchie de contrôle.

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

Rebind le contrôle lié aux données à ses données après la modification de l’une des propriétés d’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 le chargement du contrôle.

(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 élément utilisé pour lire un fichier.

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

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

PerformSelect()

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

(Hérité de DataBoundControl)
PrepareControlHierarchy()

Configure la hiérarchie de contrôle du FormView contrôle.

RaiseBubbleEvent(Object, EventArgs)

Affecte toutes les sources 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 FormView contrôle lorsqu’il publie sur le serveur.

RemovedControl(Control)

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

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

Affiche le FormView contrôle sur le client.

RenderBeginTag(HtmlTextWriter)

Restitue la balise d’ouverture HTML du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles.

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

Génère le contenu des enfants d’un contrôle serveur dans un objet fourni HtmlTextWriter , qui écrit le contenu à restituer sur le client.

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

Restitue le contenu du contrôle au writer spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles.

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

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

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

Génère le contenu du contrôle serveur dans un objet fourni HtmlTextWriter et stocke les informations de suivi sur le contrôle si le suivi est activé.

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

Affiche la balise de fermeture HTML du contrôle dans l’enregistreur spécifié. Cette méthode est principalement utilisée par les développeurs de contrôles.

(Hérité de WebControl)
ResolveAdapter()

Obtient l’adaptateur de contrôle 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 utilisable sur le client demandeur.

(Hérité de Control)
SaveControlState()

Enregistre l’état des propriétés de FormView contrôle qui doivent être conservées, même lorsque la EnableViewState propriété est définie falsesur .

SaveViewState()

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

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 FormView contrôle.

SetRenderMethodDelegate(RenderMethod)

Affecte un délégué de gestionnaire d’événements pour restituer le contrôle serveur et son contenu dans son contrôle parent.

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

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

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

Définit les données de trace pour le suivi au moment du design des données de rendu, à l’aide de la clé de 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 auquel commencer le suivi et l’enregistrement des modifications de l’état d’affichage dans le FormView contrôle.

UpdateItem(Boolean)

Met à jour l’enregistrement actif dans la source de données.

ValidateDataSource(Object)

Vérifie que l’objet auquel un contrôle lié aux données est lié est un contrôle qu’il peut utiliser.

(Hérité de DataBoundControl)

Événements

Nom Description
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, qui est la dernière étape du cycle de vie du contrôle de serveur lorsqu’une page ASP.NET est demandée.

(Hérité de Control)
Init

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

(Hérité de Control)
ItemCommand

Se produit lorsqu’un bouton dans un FormView contrôle est cliqué.

ItemCreated

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

ItemDeleted

Se produit lorsqu’un bouton Supprimer dans un FormView contrôle est cliqué, mais après l’opération de suppression.

ItemDeleting

Se produit lorsqu’un bouton Supprimer dans un FormView contrôle est cliqué, mais avant l’opération de suppression.

ItemInserted

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

ItemInserting

Se produit lorsqu’un bouton Insérer dans un FormView contrôle est cliqué, mais avant l’opération d’insertion.

ItemUpdated

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

ItemUpdating

Se produit lorsqu’un bouton Mettre à jour dans un FormView contrôle est cliqué, 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 bascule entre le FormView mode d’édition, d’insertion et de lecture seule, mais une fois le mode modifié.

ModeChanging

Se produit lorsque le contrôle bascule entre le FormView mode d’édition, d’insertion et de lecture seule, mais avant que le mode ne change.

PageIndexChanged

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

PageIndexChanging

Se produit lorsque la valeur de la PageIndex propriété 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

Nom Description
IAttributeAccessor.GetAttribute(String)

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

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

Définit un attribut du contrôle Web sur le nom et la valeur spécifiés.

(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 de clé primaire des éléments affichés dans le FormView contrôle.

IDataBoundControl.DataMember

Obtient ou définit le nom de la liste des éléments de données auxquels le FormView contrôle est lié 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 récupérées par le FormView contrôle.

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 récupérés par le FormView contrôle.

IDataBoundControl.DataSourceObject

Obtient l’objet de source de données qui contient la liste des éléments de données récupérés par le FormView contrôle.

IDataBoundItemControl.DataKey

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

IDataBoundItemControl.Mode

Obtient le mode actuel du FormView contrôle.

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 pour le FormView contrôle.

IPostBackEventHandler.RaisePostBackEvent(String)

Déclenche des événements pour le FormView contrôle lorsqu’il publie sur le serveur.

Méthodes d’extension

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

Active le comportement des données dynamiques pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type, Object)

Active le comportement des données dynamiques pour le contrôle de données spécifié.

EnableDynamicData(INamingContainer, Type)

Active le comportement des données dynamiques pour le contrôle de données spécifié.

EnablePersistedSelection(BaseDataBoundControl)
Obsolète.

Permet de conserver 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 de la colonne spécifiée dans le conteneur d’affectation de noms du contrôle spécifié.

FindMetaTable(Control)

Retourne l’objet métatable pour le contrôle de données contenant.

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, IDictionary<String,Object>)

Définit les métadonnées de table et le mappage de 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 de valeurs par défaut 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é.

TryGetMetaTable(INamingContainer, MetaTable)

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

S’applique à

Voir aussi