DetailsViewMode Enumeración
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Representa los distintos modos de entrada de datos de un control DetailsView.
public enum class DetailsViewMode
public enum DetailsViewMode
type DetailsViewMode =
Public Enum DetailsViewMode
- Herencia
Campos
Edit | 1 | Modo de edición que permite al usuario actualizar los valores de un registro existente. |
Insert | 2 | Modo de inserción que permite al usuario especificar los valores de un registro nuevo. |
ReadOnly | 0 | Modo de presentación que impide que el usuario modifique los valores de un registro. |
Ejemplos
En el ejemplo de código siguiente se muestra cómo mantener el DetailsView control en modo de edición después de una operación de actualización estableciendo la DefaultMode propiedad DetailsViewMode.Edit
en .
<%@ 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>
Comentarios
La DetailsViewMode enumeración se usa para representar los modos de entrada de datos de un DetailsView control. Para determinar el modo actual del control, use la CurrentMode propiedad . Después de una operación de inserción o actualización, el DetailsView control vuelve al modo especificado por la DefaultMode propiedad . De forma predeterminada, el control vuelve al modo de solo lectura. Puede especificar un modo alternativo al que volver estableciendo la DefaultMode propiedad . Para cambiar los modos mediante programación, use el ChangeMode método . Cuando el DetailsView control cambia los modos, se generan los eventos de la tabla siguiente.
evento | Descripción |
---|---|
ModeChanging | Se produce cuando un DetailsView control intenta cambiar entre el modo de edición, inserción y solo lectura, pero antes de que el modo cambie realmente. Este evento se suele usar para cancelar un cambio de modo. |
ModeChanged | Se produce después de que un DetailsView control haya cambiado del modo de edición, inserción o solo lectura a otro modo. Este evento se usa a menudo para realizar una tarea cuando el DetailsView control cambia los modos. |