Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

View-Klasse

Hinweis: Diese Klasse ist neu in .NET Framework, Version 2.0.

Stellt ein Steuerelement dar, das als Container für eine Gruppe von Steuerelementen in einem MultiView-Steuerelement fungiert.

Namespace: System.Web.UI.WebControls
Assembly: System.Web (in system.web.dll)

public class View : Control
public class View extends Control
public class View extends Control

Das View-Steuerelement ist ein Container für eine Gruppe von Steuerelementen. Ein View-Steuerelement muss immer in einem MultiView-Steuerelement enthalten sein. Es kann jeweils nur ein View-Steuerelement als aktive Ansicht innerhalb eines MultiView-Steuerelements definiert werden.

Die ActiveViewIndex-Eigenschaft gibt das aktive View-Steuerelement in der Views-Auflistung eines MultiView-Steuerelements an. Das Steuerelement für die aktive Ansicht wird für den Client wiedergegeben, solange das enthaltende MultiView-Steuerelement sichtbar ist. Bestimmen Sie mithilfe der Visible-Eigenschaft, ob ein View-Steuerelement und seine untergeordneten Steuerelemente auf der Seite angezeigt und für den Client wiedergegeben werden.

Ein View-Steuerelement kann Steuerelemente eines beliebigen Typs enthalten, einschließlich anderer MultiView-Steuerelemente. Ein View-Steuerelement unterstützt keine Stileigenschaften. Wenn Sie Formate auf ein View-Steuerelement anwenden möchten, fügen Sie dem View-Steuerelement eines oder mehrere Panel-Steuerelemente hinzu.

Die View-Klasse stellt das Activate-Ereignis und das Deactivate-Ereignis bereit. Das Activate-Ereignis wird ausgelöst, wenn das aktuelle View-Steuerelement zur aktiven Ansicht wird. Dies tritt ein, wenn sich der Wert der ActiveViewIndex-Eigenschaft ändert oder die SetActiveView-Methode zum Angeben eines anderen View-Steuerelements aufgerufen wird. Wenn View1 z. B. die aktive Ansicht in einem MultiView-Steuerelement darstellt und wenn sich die ActiveViewIndex-Eigenschaft ändert und View2 angibt, wird für View2 das Activate-Ereignis und für View1 das Deactivate-Ereignis ausgelöst.

Um es Benutzern zu ermöglichen, innerhalb eines MultiView-Steuerelements zwischen mehreren View-Steuerelementen zu navigieren, können Sie jedem View-Steuerelement ein LinkButton-Steuerelement oder ein Button-Steuerelement hinzufügen. Legen Sie die CommandName-Eigenschaft des LinkButton-Steuerelements oder des Button-Steuerelements auf die ID des View-Steuerelements fest, zu dem navigiert werden soll. Ein Codebeispiel finden Sie unter ActiveViewChanged.

Weitere Informationen zum Bearbeiten von View-Steuerelementen in einem MultiView-Steuerelement finden Sie unter dem Thema MultiView.

Im folgenden Codebeispiel wird veranschaulicht, wie ein MultiView-Steuerelement erstellt wird, das drei View-Steuerelemente enthält. Beim erstmaligen Laden der Seite wird DefaultView als aktive Ansicht festgelegt. Jedes View-Steuerelement enthält Linkschaltflächen, mit denen der Benutzer zu anderen Ansichten navigieren kann. Beachten Sie, dass jedes View-Steuerelement ein Panel-Steuerelement enthält, das die Anwendung von Formaten ermöglicht.

<%@ Page Language="VB" %>

<html>
<head>
    <script runat="server">

        Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
            ' The first time the page loads,
            ' render the DefaultView.
            If Not IsPostBack Then
                ' Set DefaultView as the active view.
                MultiView1.SetActiveView(DefaultView)
            End If

        End Sub

        Sub LinkButton_Command(sender As Object, e As System.Web.UI.WebControls.CommandEventArgs)
            ' Determine which link button was clicked
            ' and set the active view to
            ' the view selected by the user.
            Select Case (e.CommandArgument)
                Case "DefaultView"
                    MultiView1.SetActiveView(DefaultView)
                Case "News"
                    MultiView1.SetActiveView(NewsView)
                Case "Shopping"
                    MultiView1.SetActiveView(ShoppingView)
                Case Else
                    Throw New Exception("You did not select a valid list item.")

            End Select

        End Sub

</script>

</html>
<body>
    <form ID="Form1" runat="server">
        
        <h3>MultiView Class Example</h3>

        <asp:MultiView id="MultiView1"
            runat="Server">

            <asp:View id="DefaultView" 
                runat="Server">                

                <asp:Panel id="DefaultViewPanel" 
                    Width="330px" 
                    BackColor="#C0C0FF" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">  

                    <asp:Label id="DefaultLabel1" 
                        Font-bold="true"
                        Font-size="14" 
                        Text="The Default View"
                        runat="Server">
                    </asp:Label>                  

                    <asp:BulletedList id="DefaultBulletedList1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Today's Weather</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Stock Quotes</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's News Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Featured Shopping</asp:ListItem>
                    </asp:BulletedList>

                    <hr>

                    <asp:Label id="DefaultLabel2"                      
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br>
                
                    <asp:LinkButton id="Default_NewsLink" 
                        Text="Go to News View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="News" 
                        CommandName="Link"
			Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="Default_ShoppingLink"
                        Text="Go to Shopping View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="Shopping" 
                        CommandName="Link"
			Width="150px"
                        runat="server">
                    </asp:LinkButton><br><br>

                </asp:Panel>

            </asp:View>

            <asp:View id="NewsView" 
                runat="Server">

                <asp:Panel id="NewsPanel1" 
                    Width="330px" 
                    BackColor="#C0FFC0" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">

                    <asp:Label id="NewsLabel1" 
                        Font-bold="true"
                        Font-size="14"
                        Text="The News View"
                        runat="Server">                    
                    </asp:Label>

                    <asp:BulletedList id="NewsBulletedlist1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Today's International Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's National Headlines</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Today's Local News</asp:ListItem>
                    </asp:BulletedList>

		            <hr>

                    <asp:Label id="NewsLabel2"                      
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br>

                    <asp:LinkButton id="News_DefaultLink" 
                        Text="Go to the Default View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="DefaultView" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="News_ShoppingLink" 
                        Text="Go to Shopping View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="Shopping" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton><br><br>

                </asp:Panel>

            </asp:View>

            <asp:View id="ShoppingView" 
                runat="Server">

                <asp:Panel id="ShoppingPanel1" 
                    Width="330px" 
                    BackColor="#FFFFC0" 
                    BorderColor="#404040"
                    BorderStyle="Double"
                    runat="Server">

                    <asp:Label id="ShoppingLabel1" 
                        Font-Bold="true"
                        Font-size="14"                         
                        Text="The Shopping View"
                        runat="Server">
                    </asp:Label>

                    <asp:BulletedList id="ShoppingBulletedlist1" 
                        BulletStyle="Disc" 
                        DisplayMode="Hyperlink"
                        Target="_blank"
                        runat="Server">
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Home and Garden </asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Women's Fashions</asp:ListItem>
                            <asp:ListItem Value="http://www.microsoft.com">Shop for Men's Fashions</asp:ListItem>
                    </asp:BulletedList>

                    <hr>

                    <asp:Label id="ShoppingLabel2" 
                        Font-size="12" 
                        Text="Click a link to display a different view:"
                        runat="Server">
                    </asp:Label><br>

                    <asp:LinkButton id="Shopping_DefaultLink" 
                        Text="Go to the Default View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="DefaultView" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton>

                    <asp:LinkButton id="Shopping_NewsLink"
                        Text="Go to News View" 
                        OnCommand="LinkButton_Command"
                        CommandArgument="News" 
                        CommandName="Link"
                        Width="150px"
                        runat="Server">
                    </asp:LinkButton><br><br>

                </asp:Panel>

            </asp:View>

        </asp:MultiView>

    </form>
</body>
</html>

  • AspNetHostingPermission  für den Betrieb in einer Hostumgebung. Anforderungswert: LinkDemand, Berechtigungswert: Minimal
  • AspNetHostingPermission  für den Betrieb in einer Hostumgebung. Anforderungswert: InheritanceDemand, Berechtigungswert: Minimal

Alle öffentlichen statischen (Shared in Visual Basic) Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

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

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

.NET Framework

Unterstützt in: 2.0
Anzeigen: