(0) exportieren Drucken
Alle erweitern
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

DetailsView.ModeChanging-Ereignis

Aktualisiert: November 2007

Tritt ein, wenn ein DetailsView-Steuerelement versucht, zwischen dem Bearbeitungsmodus, Einfügemodus und dem schreibgeschützten Modus zu wechseln, allerdings bevor die CurrentMode-Eigenschaft aktualisiert wurde.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
public event DetailsViewModeEventHandler ModeChanging
/** @event */
public void add_ModeChanging (DetailsViewModeEventHandler value)
/** @event */
public void remove_ModeChanging (DetailsViewModeEventHandler value)

JScript unterstützt keine Ereignisse.
<asp:DetailsView OnModeChanging="DetailsViewModeEventHandler" />

Das ModeChanging-Ereignis wird ausgelöst, wenn ein DetailsView-Steuerelement versucht, zwischen Bearbeitungsmodus, Einfügemodus und schreibgeschütztem Modus zu wechseln, allerdings bevor die CurrentMode-Eigenschaft aktualisiert wurde. Dadurch können Sie einen Ereignishandler bereitstellen, der bei jedem Auftreten dieses Ereignisses eine benutzerdefinierte Routine ausführt, beispielsweise den Abbruch des Moduswechsels.

Ein DetailsViewModeEventArgs-Objekt wird an den Ereignishandler übergeben. Damit können Sie den neuen Modus bestimmen und ermitteln, ob der Moduswechsel durch den Abbruch eines Bearbeitungsvorgangs durch den Benutzer verursacht wurde. Zudem können Sie den Moduswechsel abbrechen. Sie können den neuen Modus mithilfe der NewMode-Eigenschaft ermitteln. Mithilfe der CancelingEdit-Eigenschaft können Sie ermitteln, ob der Moduswechsel durch den Abbruch eines Bearbeitungsvorgangs durch den Benutzer verursacht wurde. Sie können den Moduswechsel abbrechen, indem Sie die Cancel-Eigenschaft auf true festlegen.

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mithilfe des ModeChanging-Ereignisses das Pagingfeature deaktivieren, wenn sich das DetailsView-Steuerelement im Bearbeitungsmodus befindet.


<%@ Page language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">

    void CustomerDetailView_ModeChanging(Object sender, DetailsViewModeEventArgs e)
  {
    // Disable the paging feature in edit mode.
    if (e.NewMode == DetailsViewMode.Edit)
    {
        CustomerDetailView.AllowPaging = false;
    }
    else
    {
        CustomerDetailView.AllowPaging = true;
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>DetailsView ModeChanging Example</title>
</head>
<body>
    <form id="Form1" runat="server">

      <h3>DetailsView ModeChanging Example</h3>

        <asp:detailsview id="CustomerDetailView"
          datasourceid="DetailsViewSource"
          datakeynames="CustomerID"
          autogeneraterows="true"
          autogenerateeditbutton="true" 
          allowpaging="true"
          onmodechanging="CustomerDetailView_ModeChanging" 
          runat="server">

          <fieldheaderstyle 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>



Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)
Vielen Dank für Ihr Feedback.

Community-Beiträge

HINZUFÜGEN
Anzeigen:
© 2014 Microsoft. Alle Rechte vorbehalten.