Mit den Steuerelementen „MultiView“ und „Ansicht“ können Sie den Inhalt einer Seite in verschiedene Gruppen unterteilen und jeweils nur eine Gruppe anzeigen. Jedes Ansichtssteuerelement verwaltet den Inhalt einer Gruppe, und alle Ansichtssteuerelemente sind in einem MultiView-Steuerelement enthalten.
Ein Multiview-Steuerelement ist jeweils nur für die Anzeige jeweils einer Ansicht verantwortlich. Die Ansichtsanzeige wird als aktive Ansicht bezeichnet.
Die Syntax des MultiView-Steuerelements lautet:
<asp:MultView ID= "MultiView1" runat= "server"></asp:MultiView>
Die Syntax des View-Steuerelements lautet:
<asp:View ID= "View1" runat= "server"></asp:View>
Die Kontrolle kann jedoch nicht alleine existieren. Wenn Sie versuchen, es alleine zu verwenden, erhalten Sie eine Fehlermeldung. Es wird immer mit einem Multi-View-Controller verwendet:
<asp:MultView ID= "MultiView1" runat= "server"> <asp:View ID= "View1" runat= "server"> </asp:View></asp:MultiView>
Ansichten und Multiview-Steuerelemente werden von der Control-Klasse abgeleitet. und erbt alle seine Eigenschaften, Methoden und Ereignisse. Die wichtigste Eigenschaft eines Ansichtssteuerelements ist die boolesche Eigenschaft Visible, die die Sichtbarkeit einer Ansicht festlegt.
Multiview-Steuerelemente verfügen über die folgenden wichtigen Funktionen:
Eigentum | beschreiben |
---|---|
Ansichten | Ein Ansichtssteuerelement, das mehrere Ansichten integriert. |
ActiveViewIndex | Der nullbasierte Index, der die aktive Ansicht darstellt. Wenn keine Ansicht aktiv ist, beträgt der Indexwert -1. |
Die CommandName-Eigenschaften der Schaltflächensteuerelemente, die sich auf die Navigation des MultiView-Steuerelements beziehen, sind einigen verwandten Feldern des MultiView-Steuerelements zugeordnet.
Wenn sich beispielsweise der CommandName-Wert eines Schaltflächensteuerelements auf die Navigation mehrerer Ansichten bezieht, navigiert es automatisch zur nächsten Ansicht, wenn auf die Schaltfläche geklickt wird.
Die folgende Tabelle zeigt die Standardbefehlsnamen für die oben genannten Eigenschaften:
Element | beschreiben |
---|---|
NextViewCommandName | nächste Ansicht |
PreviousViewCommandName | Vorherige Ansicht |
SwitchViewByIDCommandName | SwitchViewByID |
SwitchViewByIndexCommandName | SwitchViewByIndex |
Wichtige Methoden der Multi-Viewpoint-Steuerung sind:
Verfahren | beschreiben |
---|---|
SetActiveview | Aktive Ansicht festlegen |
GetActiveview | Aktive Ansicht abrufen |
Jedes Mal, wenn sich die Ansicht ändert, wird die Seite an den Server zurückgesendet und einige Ereignisse werden ausgelöst. Einige wichtige Ereignisse sind:
Ereignis | beschreiben |
---|---|
ActiveViewChanged | Wird ausgelöst, wenn sich eine Ansicht ändert |
Aktivieren | Ausgelöst durch aktive Ansicht |
Deaktivieren | Ausgelöst durch inaktive Ansicht |
Zusätzlich zu den oben genannten Eigenschaften, Methoden und Ereignissen erben Multiview-Steuerelemente Mitglieder der Steuerelement- und Objektklassen.
Die Beispielseite verfügt über drei Ansichten. Die Navigationsansicht jeder Ansicht verfügt über zwei Schaltflächen.
Der Code für die Inhaltsdatei lautet wie folgt:
<%@ Page Language="C#" AutoEventWireup="true" CodeBehind="Default.aspx.cs" Inherits="multiviewdemo._Default" %><!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> Untitled Page </title> </head> <body> <form id="form1" runat="server"> <div> <h2>MultiView and View Controls</h2> <asp:DropDownList ID="DropDownList1" runat="server" onselectedindexchanged="DropDownList1_SelectedIndexChanged"> </asp:DropDownList> <hr /> <asp:MultiView ID="MultiView1" runat="server" ActiveViewIndex="2" onactiveviewchanged="MultiView1_ActiveViewChanged" > <asp:View ID="View1" runat="server"> <h3>This is view 1</h3> <br /> <asp:Button CommandName="NextView" ID="btnnext1" runat="server" Text = "Go To Next" /> <asp:Button CommandArgument="View3" CommandName="SwitchViewByID" ID="btnlast" runat="server" Text ="Go To Last" /> </asp:View> <asp:View ID="View2" runat="server"> <h3>This is view 2</h3> <asp:Button CommandName="NextView" ID="btnnext2" runat="server" Text = "Go To Next" /> <asp:Button CommandName="PrevView" ID="btnprevious2" runat="server" Text = "Go To Previous View" /> </asp:View> <asp:View ID="View3" runat="server"> <h3> This is view 3</h3> <br /> <asp:Calendar ID="Calender1" runat="server"></asp:Calendar> <br /> <asp:Button CommandArgument="0" CommandName="SwitchViewByIndex" ID="btnfirst" runat="server" Text = "Go To Next" /> <asp:Button CommandName="PrevView" ID="btnprevious" runat="server" Text = "Go To Previous View" /> </asp:View> </asp:MultiView> </div> </form> </body></html>
Beachten Sie Folgendes:
MultiView.ActiveViewIndex bestimmt, welche Ansichten angezeigt werden. Dies ist die einzige auf der Seite gerenderte Ansicht. Der Standardwert von ActiveViewIndex, wenn keine Ansicht angezeigt wird, ist -1. Da ActiveViewIndex im Beispiel als 2 definiert ist, zeigt es bei der Ausführung die dritte Ansicht an.