DetailsViewMode Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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
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. |