DetailsView.DefaultMode Eigenschaft

  • Referenz

Definition

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

Ruft den Standarddateneingabemodus des DetailsView-Steuerelements ab oder legt diesen fest.

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 ist DetailsViewMode.ReadOnly.

Ausnahmen

ArgumentOutOfRangeException

Der angegebene Wert ist keiner der DetailsViewMode-Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DefaultMode Eigenschaft verwenden, um anzugeben, dass das DetailsView Steuerelement im Bearbeitungsmodus verbleiben sollte, 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 wird das DetailsView Steuerelement in den schreibgeschützten Modus zurückgegeben. Sie können das Steuerelement jedoch im Bearbeitungs- oder Einfügenmodus beibehalten DetailsView , indem Sie diese Eigenschaft auf den entsprechenden Wert festlegen. In der folgenden Tabelle sind die verschiedenen Moduswerte aufgeführt.

Mode BESCHREIBUNG
DetailsViewMode.Edit Das DetailsView Steuerelement befindet sich im Bearbeitungsmodus, mit dem der Benutzer die Werte eines Datensatzes aktualisieren kann.
DetailsViewMode.Insert Das DetailsView Steuerelement befindet sich im Einfügemodus, mit dem der Benutzer dem Datenquellen einen neuen Datensatz hinzufügen kann.
DetailsViewMode.ReadOnly Das DetailsView Steuerelement befindet sich im schreibgeschützten Modus, der der normale Anzeigemodus ist.

Gilt für

Siehe auch