Freigeben über


DetailsViewMode Enumeration

Definition

Stellt die verschiedenen Dateneingabemodi eines DetailsView-Steuerelements dar.

public enum class DetailsViewMode
public enum DetailsViewMode
type DetailsViewMode = 
Public Enum DetailsViewMode
Vererbung
DetailsViewMode

Felder

Edit 1

Ein Bearbeitungsmodus, in dem der Benutzer die Werte eines vorhandenen Datensatzes aktualisieren kann.

Insert 2

Ein Einfügemodus, in dem der Benutzer die Werte für einen neuen Datensatz eingeben kann.

ReadOnly 0

Ein Anzeigemodus, der verhindert, dass Benutzer die Werte eines Datensatzes ändern.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie das DetailsView Steuerelement nach einem Aktualisierungsvorgang im Bearbeitungsmodus beibehalten wird, indem die DefaultMode -Eigenschaft auf festgelegt wird 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>

Hinweise

Die DetailsViewMode Enumeration wird verwendet, um die Dateneingabemodi eines DetailsView Steuerelements darzustellen. Verwenden Sie die -Eigenschaft, um den aktuellen Modus des Steuerelements CurrentMode zu bestimmen. Nach einem Einfüge- oder Aktualisierungsvorgang kehrt das DetailsView Steuerelement in den von der DefaultMode -Eigenschaft angegebenen Modus zurück. Standardmäßig kehrt das Steuerelement in den schreibgeschützten Modus zurück. Sie können einen alternativen Modus für die Rückkehr angeben, indem Sie die DefaultMode -Eigenschaft festlegen. Verwenden Sie die -Methode, um die ChangeMode Modi programmgesteuert zu ändern. Wenn das Steuerelement die DetailsView Modi ändert, werden die Ereignisse in der folgenden Tabelle ausgelöst.

event Beschreibung
ModeChanging Tritt auf, wenn ein DetailsView Steuerelement versucht, zwischen dem Bearbeitungs-, Einfüge- und schreibgeschützten Modus zu wechseln, aber bevor sich der Modus tatsächlich ändert. Dieses Ereignis wird häufig verwendet, um eine Modusänderung abzubrechen.
ModeChanged Tritt auf, nachdem ein DetailsView Steuerelement vom Bearbeitungs-, Einfüge- oder schreibgeschützten Modus in einen anderen Modus geändert wurde. Dieses Ereignis wird häufig verwendet, um eine Aufgabe auszuführen, wenn das Steuerelement den DetailsView Modus ändert.

Gilt für:

Weitere Informationen