Freigeben über

DetailsView.DefaultMode Eigenschaft

Definition

Namespace:
System.Web.UI.WebControls
Assembly:
System.Web.dll

Dient zum Abrufen oder Festlegen des Standarddateneingabemodus des DetailsView Steuerelements.

public:
 virtual property System::Web::UI::WebControls::DetailsViewMode DefaultMode { System::Web::UI::WebControls::DetailsViewMode get(); void set(System::Web::UI::WebControls::DetailsViewMode value); };
public virtual System.Web.UI.WebControls.DetailsViewMode DefaultMode { get; set; }
member this.DefaultMode : System.Web.UI.WebControls.DetailsViewMode with get, set
Public Overridable Property DefaultMode As DetailsViewMode

Eigenschaftswert

DetailsViewMode

Einer der DetailsViewMode Werte. Der Standardwert lautet DetailsViewMode.ReadOnly.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Wert ist keiner der DetailsViewMode Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die DefaultMode Eigenschaft verwendet wird, um anzugeben, dass das DetailsView Steuerelement im Bearbeitungsmodus verbleiben soll, nachdem ein Datensatz aktualisiert wurde.


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

Verwenden Sie die DefaultMode Eigenschaft, um anzugeben, ob das DetailsView Steuerelement den Bearbeitungs-, Einfüge- oder schreibgeschützten Modus zurückgibt, nachdem ein Bearbeitungs- oder Einfügevorgang ausgeführt wurde. Standardmäßig kehrt das DetailsView Steuerelement in den schreibgeschützten Modus zurück. Sie können das DetailsView Steuerelement jedoch im Bearbeitungs- oder Einfügemodus beibehalten, indem Sie diese Eigenschaft auf den entsprechenden Wert festlegen. In der folgenden Tabelle sind die verschiedenen Moduswerte aufgeführt.

Modus Beschreibung
DetailsViewMode.Edit Das DetailsView Steuerelement befindet sich im Bearbeitungsmodus, sodass der Benutzer die Werte eines Datensatzes aktualisieren kann.
DetailsViewMode.Insert Das DetailsView Steuerelement befindet sich im Einfügemodus, sodass der Benutzer der Datenquelle einen neuen Datensatz hinzufügen kann.
DetailsViewMode.ReadOnly Das DetailsView Steuerelement befindet sich im schreibgeschützten Modus, bei dem es sich um den normalen Anzeigemodus handelt.

Gilt für:

Weitere Informationen