Cette documentation est archivée et n’est pas conservée.

FormViewMode, énumération

Remarque : cette énumération est nouvelle dans le .NET Framework version 2.0.

Représente les différents modes d'entrée des données d'un contrôle FormView.

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans system.web.dll)

public enum FormViewMode
public enum FormViewMode
public enum FormViewMode

 Nom de membreDescription
EditMode d'édition qui permet à l'utilisateur de mettre à jour les valeurs d'un enregistrement existant. 
InsertMode d'insertion qui permet à l'utilisateur d'entrer les valeurs d'un nouvel enregistrement. 
ReadOnlyMode d'affichage qui empêche l'utilisateur de modifier les valeurs d'un enregistrement. 

L'énumération FormViewMode est utilisée pour représenter les modes d'entrée des données d'un contrôle FormView. Pour déterminer le mode actuel d'un contrôle, utilisez la propriété CurrentMode. Après avoir exécuté une opération d'insertion ou de mise à jour, le contrôle FormView retourne au mode spécifié par la propriété DefaultMode. Par défaut, le contrôle retourne en lecture seule. Vous pouvez spécifier un autre mode auquel retourner en définissant la propriété DefaultMode. Pour modifier des modes par programme, utilisez la méthode ChangeMode. Lorsque le contrôle FormView modifie des modes, les événements de la table suivante sont déclenchés.

Événement

Description

ModeChanging

Se produit lorsqu'un contrôle FormView tente de basculer entre les modes édition, insertion et lecture seule, mais avant que le mode ne soit réellement modifié. Cet événement est souvent utilisé pour annuler une modification du mode.

ModeChanged

Se produit après qu'un contrôle FormView est passé du mode édition, insertion ou lecture seule à un autre mode. Cet événement est souvent utilisé pour exécuter une tâche lorsque le contrôle FormView modifie des modes.

L'exemple suivant montre comment maintenir le contrôle FormView en mode édition après une opération de mise à jour en affectant FormViewMode.Edit à la propriété DefaultMode.


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

<html>
  <body>
    <form runat="server">
        
      <h3>FormView DefaultMode Example</h3>
                       
      <asp:formview id="EmployeeFormView"
        datasourceid="EmployeeSource"
        allowpaging="true"
        datakeynames="EmployeeID"
        defaultmode="Edit"
        emptydatatext="No employees found."  
        runat="server">
        
        <rowstyle backcolor="LightGreen"
          wrap="false"/>
        <editrowstyle backcolor="LightBlue"
          wrap="false"/>

        <itemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="EmployeeImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <%# Eval("FirstName") %> <%# Eval("LastName") %>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <%# Eval("Title") %>
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="Edit"
                  text="Edit"
                  commandname="Edit"
                  runat="server"/> 
              </td>
            </tr>
          </table>       
        </itemtemplate>
        <edititemtemplate>
          <table>
            <tr>
              <td rowspan="4">
                <asp:image id="EmployeeEditImage"
                  imageurl='<%# Eval("PhotoPath") %>'
                  alternatetext='<%# Eval("LastName") %>' 
                  runat="server"/>
              </td>
              <td colspan="2">
                  &nbsp; 
              </td>
            </tr>
            <tr>
              <td>
                <b>Name:</b>
              </td>
              <td>
                <asp:textbox id="FirstNameUpdateTextBox"
                  text='<%# Bind("FirstName") %>'
                  runat="server"/>
                <asp:textbox id="LastNameUpdateTextBox"
                  text='<%# Bind("LastName") %>'
                  runat="server"/>
              </td>
            </tr>
            <tr>
              <td>
                <b>Title:</b>
              </td>
              <td>
                <asp:textbox id="TitleUpdateTextBox"
                  text='<%# Bind("Title") %>'
                  runat="server"/> 
              </td>
            </tr>
            <tr>
              <td colspan="2">
                <asp:linkbutton id="UpdateButton"
                  text="Update"
                  commandname="Update"
                  runat="server"/>
              </td>
            </tr>
          </table>       
        </edititemtemplate> 
                  
      </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]"
        updatecommand="Update [Employees] Set [LastName]=@LastName, [FirstName]=@FirstName, [Title]=@Title Where [EmployeeID]=@EmployeeID"
        connectionstring="<%$ ConnectionStrings:NorthWindConnectionString%>" 
        runat="server"/>
            
    </form>
  </body>
</html>


Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0
Afficher: