DetailsViewMode Enumeración

  • Referencia

Definición

Espacio de nombres:
System.Web.UI.WebControls
Ensamblado:
System.Web.dll

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
Object
ValueType
Enum
DetailsViewMode

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.Editen .


<%@ 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.

Se aplica a

Consulte también