MenuItemStyleCollection Klasse

Definition

Stellt eine Auflistung von MenuItemStyle-Objekten in einem Menu-Steuerelement dar. Diese Klasse kann nicht vererbt werden.

public ref class MenuItemStyleCollection sealed : System::Web::UI::StateManagedCollection
public sealed class MenuItemStyleCollection : System.Web.UI.StateManagedCollection
type MenuItemStyleCollection = class
    inherit StateManagedCollection
Public NotInheritable Class MenuItemStyleCollection
Inherits StateManagedCollection
Vererbung
MenuItemStyleCollection

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die MenuItemStyleCollection -Klasse verwendet wird, um die Stileinstellungen für die Menüelemente in einem Menu Steuerelement basierend auf der Ebene des Menüelements anzugeben. In diesem Beispiel wird die LevelMenuItemStyles -Eigenschaft deklarativ erstellt, und ein MenuItemStyle -Objekt wird entfernt und ein weiteres dem MenuItemStyleCollection -Objekt hinzugefügt.


<%@ 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 Page_Load(Object sender, EventArgs e)
  {

    if (!IsPostBack)
    {

      // Use the Add and RemoveAt methods to programmatically 
      // remove the third level menu item style and replace 
      // it with a new style, in this case replacing the green background
        // and yellow text with the blue background and white text. 

        MenuItemStyle newStyle = new MenuItemStyle();
        newStyle.BackColor = System.Drawing.Color.Blue;
        newStyle.ForeColor = System.Drawing.Color.White;

        // Remove the last of the three menu item styles. Note that
        // since the collection has a zero-based index, the third
        // entry has an index value of 2.
        MainMenuID.LevelMenuItemStyles.RemoveAt(2);
        MainMenuID.LevelMenuItemStyles.Add(newStyle);

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemStyleCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemStyleCollection Example</h3>
         <!--Add MenuItemStyle objects to the MenuItemStyleCollection -->
         <!--using LevelMenuItemStyles.  -->
         <!--Note that each menu item style represents a level in the menu -->

      <asp:Menu id="MainMenuID"
       Font-Names= "Arial"
        ForeColor="Blue"
        runat="server">
         
         <LevelMenuItemStyles>
         <asp:MenuItemStyle BackColor="Azure" 
             Font-Italic="true"
             Font-Names="Arial"
             ForeColor="Black" />
         
           <asp:MenuItemStyle BackColor="Black" 
             Font-Italic="false"
             Font-Names="Arial"
             ForeColor="White" />
             
         <asp:MenuItemStyle BackColor="Green" 
             Font-Italic="true"
             Font-Names="Arial"
             ForeColor="Yellow" />
       
         </LevelMenuItemStyles>

        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

        
      </asp:Menu>

    </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">
<script runat="server">

Sub Page_Load(ByVal sender As [Object], ByVal e As EventArgs) 
    
    If Not IsPostBack Then
        
        ' Use the Add and RemoveAt methods to programmatically 
        ' remove the third level menu item style and replace 
        ' it with a new style, in this case replacing the green background
        ' and yellow text with the blue background and white text. 
        Dim newStyle As New MenuItemStyle()
        newStyle.BackColor = System.Drawing.Color.Blue
        newStyle.ForeColor = System.Drawing.Color.White
        
        ' Remove the last of the three menu item styles. Note that
        ' since the collection has a zero-based index, the third
        ' entry has an index value of 2.
        MainMenuID.LevelMenuItemStyles.RemoveAt(2)
        MainMenuID.LevelMenuItemStyles.Add(newStyle)
    End If
 
End Sub 'Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemStyleCollection Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemStyleCollection Example</h3>
         <!--Add MenuItemStyle objects to the MenuItemStyleCollection -->
         <!--using LevelMenuItemStyles.   -->
         <!--Note that each menu item style represents a level in the menu -->

      <asp:Menu id="MainMenuID"
       Font-Names= "Arial"
        ForeColor="Blue"
        runat="server">
         
         <LevelMenuItemStyles>
         <asp:MenuItemStyle BackColor="Azure" 
             Font-Italic="true"
             Font-Names="Arial"
             ForeColor="Black" />
         
           <asp:MenuItemStyle BackColor="Black" 
             Font-Italic="false"
             Font-Names="Arial"
             ForeColor="White" />
             
         <asp:MenuItemStyle BackColor="Green" 
             Font-Italic="true"
             Font-Names="Arial"
             ForeColor="Yellow" />
       
         </LevelMenuItemStyles>

        <items>
          <asp:menuitem text="Home"
            tooltip="Home">
            <asp:menuitem text="Music"
              tooltip="Music">
              <asp:menuitem text="Classical"
                tooltip="Classical"/>
              <asp:menuitem text="Rock"
                tooltip="Rock"/>
              <asp:menuitem text="Jazz"
                tooltip="Jazz"/>
            </asp:menuitem>
            <asp:menuitem text="Movies"
              tooltip="Movies">
              <asp:menuitem text="Action"
                tooltip="Action"/>
              <asp:menuitem text="Drama"
                tooltip="Drama"/>
              <asp:menuitem text="Musical"
                tooltip="Musical"/>
            </asp:menuitem>
          </asp:menuitem>
        </items>

        
      </asp:Menu>

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

Hinweise

Die MenuItemStyleCollection -Klasse wird verwendet, um eine Auflistung von MenuItemStyle -Objekten in einem Menu -Steuerelement zu speichern und zu verwalten. Das Menu Steuerelement verwendet die MenuItemStyleCollection -Klasse als zugrunde liegenden Datentyp der LevelMenuItemStyles Eigenschaften und LevelSelectedStyles .

Die LevelMenuItemStyles Eigenschaften und LevelSelectedStyles sind eine Alternative zu den einzelnen Stileigenschaften (z StaticMenuItemStyle. B. ). Diese Eigenschaften werden auf reguläre Menüelemente bzw. das ausgewählte Menüelement basierend auf der Ebene des Menüelements im Menü angewendet. Die erste Formatvorlage in der Auflistung entspricht der Menüelementformatvorlage für die erste Ebene des Menüs. Die zweite Formatvorlage in der Auflistung entspricht der Menüelementformatvorlage für die zweite Ebene des Menüs usw. Die LevelMenuItemStyles Eigenschaften und LevelSelectedStyles werden am häufigsten verwendet, um Menüs zu generieren, bei denen Menüelemente auf einer bestimmten Ebene das gleiche Aussehen haben, unabhängig davon, ob sie Untermenüs haben.

Die MenuItemStyleCollection -Klasse erbt die meisten ihrer Member von der StateManagedCollection -Klasse. Weitere Informationen zu den geerbten Membern finden Sie unter StateManagedCollection.

Eigenschaften

Count

Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.

(Geerbt von StateManagedCollection)
Item[Int32]

Ruft das MenuItemStyle-Objekt am angegebenen Index aus der Auflistung ab.

Methoden

Add(MenuItemStyle)

Fügt das angegebene MenuItemStyle-Objekt an das Ende der aktuellen Auflistung an.

Clear()

Entfernt alle Elemente aus der StateManagedCollection-Auflistung.

(Geerbt von StateManagedCollection)
Contains(MenuItemStyle)

Bestimmt, ob das angegebene MenuItemStyle-Objekt in der Auflistung vorhanden ist.

CopyTo(Array, Int32)

Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird.

(Geerbt von StateManagedCollection)
CopyTo(MenuItemStyle[], Int32)

Kopiert alle Elemente aus dem MenuItemStyleCollection-Objekt in ein kompatibles eindimensionales Array von MenuItemStyle-Objekten, wobei am angegebenen Index des Zielarrays begonnen wird.

CreateKnownType(Int32)

Beim Überschreiben in einer abgeleiteten Klasse wird eine Instanz einer Klasse erstellt, die IStateManager implementiert. Der Typ des erstellten Objekts basiert auf dem angegebenen Element der Auflistung, der von der GetKnownTypes()-Methode zurückgegeben wird.

(Geerbt von StateManagedCollection)
Equals(Object)

Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist.

(Geerbt von Object)
GetEnumerator()

Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.

(Geerbt von StateManagedCollection)
GetHashCode()

Fungiert als Standardhashfunktion.

(Geerbt von Object)
GetKnownTypes()

Beim Überschreiben in einer abgeleiteten Klasse wird ein Array von IStateManager-Typen abgerufen, die die StateManagedCollection-Auflistung enthalten kann.

(Geerbt von StateManagedCollection)
GetType()

Ruft den Type der aktuellen Instanz ab.

(Geerbt von Object)
IndexOf(MenuItemStyle)

Bestimmt den Index des angegebenen MenuItemStyle-Objekts in der Auflistung.

Insert(Int32, MenuItemStyle)

Fügt das angegebene MenuItemStyle-Objekt in der Auflistung an der angegebenen Indexposition ein.

MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.

(Geerbt von Object)
OnClear()

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear()-Methode alle Elemente aus der Auflistung entfernt.

(Geerbt von StateManagedCollection)
OnClearComplete()

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Clear()-Methode alle Elemente aus der Auflistung entfernt hat.

(Geerbt von StateManagedCollection)
OnInsert(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzufügt.

(Geerbt von StateManagedCollection)
OnInsertComplete(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzugefügt hat.

(Geerbt von StateManagedCollection)
OnRemove(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt.

(Geerbt von StateManagedCollection)
OnRemoveComplete(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt hat.

(Geerbt von StateManagedCollection)
OnValidate(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Element der StateManagedCollection-Auflistung validiert.

(Geerbt von StateManagedCollection)
Remove(MenuItemStyle)

Entfernt das angegebene MenuItemStyle-Objekt aus der Auflistung.

RemoveAt(Int32)

Entfernt das MenuItemStyle-Objekt an der angegebenen Indexposition aus der Auflistung.

SetDirty()

Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung.

(Geerbt von StateManagedCollection)
SetDirtyObject(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein in der Auflistung enthaltenes object angewiesen, seinen gesamten Zustand im Ansichtszustand aufzuzeichnen, anstatt nur die Änderungsinformationen aufzuzeichnen.

(Geerbt von StateManagedCollection)
ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.

(Geerbt von Object)

Explizite Schnittstellenimplementierungen

ICollection.Count

Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.

(Geerbt von StateManagedCollection)
ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist. Diese Methode gibt immer false zurück.

(Geerbt von StateManagedCollection)
ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann. Diese Methode gibt immer null zurück.

(Geerbt von StateManagedCollection)
IEnumerable.GetEnumerator()

Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.

(Geerbt von StateManagedCollection)
IList.Add(Object)

Fügt der StateManagedCollection-Auflistung ein Element hinzu.

(Geerbt von StateManagedCollection)
IList.Clear()

Entfernt alle Elemente aus der StateManagedCollection-Auflistung.

(Geerbt von StateManagedCollection)
IList.Contains(Object)

Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält.

(Geerbt von StateManagedCollection)
IList.IndexOf(Object)

Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung.

(Geerbt von StateManagedCollection)
IList.Insert(Int32, Object)

Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein.

(Geerbt von StateManagedCollection)
IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe aufweist. Diese Methode gibt immer false zurück.

(Geerbt von StateManagedCollection)
IList.IsReadOnly

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist.

(Geerbt von StateManagedCollection)
IList.Item[Int32]

Ruft das IStateManager-Element am angegebenen Index ab.

(Geerbt von StateManagedCollection)
IList.Remove(Object)

Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung.

(Geerbt von StateManagedCollection)
IList.RemoveAt(Int32)

Entfernt das IStateManager-Element am angegebenen Index.

(Geerbt von StateManagedCollection)
IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert.

(Geerbt von StateManagedCollection)
IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her.

(Geerbt von StateManagedCollection)
IStateManager.SaveViewState()

Speichert die Änderungen an der StateManagedCollection-Auflistung und allen darin enthaltenen IStateManager-Objekten seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.

(Geerbt von StateManagedCollection)
IStateManager.TrackViewState()

Weist die StateManagedCollection-Auflistung und alle in ihr enthaltenen IStateManager-Objekte an, die Änderungen im Ansichtszustand nachzuverfolgen, sodass diese für die gleiche Seite anforderungsübergreifend beibehalten werden können.

(Geerbt von StateManagedCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ um

OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs

AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.

AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.

Gilt für:

Weitere Informationen