DetailsViewMode Énumération

Définition

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

public enum class DetailsViewMode
public enum DetailsViewMode
type DetailsViewMode = 
Public Enum DetailsViewMode
Héritage
DetailsViewMode

Champs

Edit 1

Mode d'édition qui permet à l'utilisateur de mettre à jour les valeurs d'un enregistrement existant.

Insert 2

Mode d'insertion qui permet à l'utilisateur d'entrer les valeurs d'un nouvel enregistrement.

ReadOnly 0

Mode d'affichage qui empêche l'utilisateur de modifier les valeurs d'un enregistrement.

Exemples

L’exemple de code suivant montre comment conserver le DetailsView contrôle en mode édition après une opération de mise à jour en définissant la DefaultMode propriété sur DetailsViewMode.Edit.


<%@ 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>DetailsView DefaultMode Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView DefaultMode Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="true"   
          autogeneraterows="true"
          allowpaging="true"
          defaultmode="Edit"   
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </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>DetailsView DefaultMode Example</title>
</head>
<body>
    <form id="Form1" runat="server">
        
      <h3>DetailsView DefaultMode Example</h3>
                
        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogenerateeditbutton="true"   
          autogeneraterows="true"
          allowpaging="true"
          defaultmode="Edit"   
          runat="server">
               
          <headerstyle backcolor="Navy"
            forecolor="White"/>
                    
        </asp:detailsview>
        
        <!-- 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="DetailsViewSource" runat="server" 
          ConnectionString=
            "<%$ ConnectionStrings:NorthWindConnectionString%>"
          InsertCommand="INSERT INTO [Customers]([CustomerID],
            [CompanyName], [Address], [City], [PostalCode], [Country]) 
            VALUES (@CustomerID, @CompanyName, @Address, @City, 
            @PostalCode, @Country)"

          SelectCommand="Select [CustomerID], [CompanyName], 
            [Address], [City], [PostalCode], [Country] From 
            [Customers]">
        </asp:SqlDataSource>
    </form>
  </body>
</html>

Remarques

L’énumération DetailsViewMode est utilisée pour représenter les modes de saisie de données d’un DetailsView contrôle. Pour déterminer le mode actuel du contrôle, utilisez la CurrentMode propriété . Après une opération d’insertion ou de mise à jour, le DetailsView contrôle revient au mode spécifié par la DefaultMode propriété. Par défaut, le contrôle revient en mode lecture seule. Vous pouvez spécifier un autre mode vers lequel revenir en définissant la DefaultMode propriété . Pour modifier les modes par programmation, utilisez la ChangeMode méthode . Lorsque le DetailsView contrôle change de mode, les événements du tableau suivant sont déclenchés.

événement Description
ModeChanging Se produit lorsqu’un DetailsView contrôle tente de changer entre le mode d’édition, d’insertion et de lecture seule, mais avant que le mode ne change réellement. Cet événement est souvent utilisé pour annuler un changement de mode.
ModeChanged Se produit après qu’un DetailsView contrôle soit passé du mode édition, insertion ou lecture seule à un autre mode. Cet événement est souvent utilisé pour effectuer une tâche lorsque le contrôle change de DetailsView mode.

S’applique à

Voir aussi