SubMenuStyleCollection Class

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Represents a collection of SubMenuStyle objects in a Menu control.

public ref class SubMenuStyleCollection : System::Web::UI::StateManagedCollection

public class SubMenuStyleCollection : System.Web.UI.StateManagedCollection

type SubMenuStyleCollection = class
    inherit StateManagedCollection

Public Class SubMenuStyleCollection
Inherits StateManagedCollection

Inheritance: Object

StateManagedCollection
SubMenuStyleCollection

Examples

The following example demonstrates how to use the SubMenuStyleCollection class to specify the style settings for the submenus in a Menu control based on the submenu's level. In this example, the LevelSubMenuStyles property returns a SubMenuStyleCollection object.


<%@ 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>Menu LevelSubMenuStyles</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu LevelSubMenuStyles</h3>

      <asp:menu id="NavigationMenu"
        staticdisplaylevels="3"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">
        
        <levelsubmenustyles>
          <asp:submenustyle backcolor="LightSteelBlue"
            forecolor="Black"/>
          <asp:submenustyle backcolor="SkyBlue"
            forecolor="Gray"/>          
        </levelsubmenustyles>  
      
        <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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>Menu LevelSubMenuStyles</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>Menu LevelSubMenuStyles</h3>

      <asp:menu id="NavigationMenu"
        staticdisplaylevels="3"
        staticsubmenuindent="10" 
        orientation="Vertical"
        target="_blank"  
        runat="server">
        
        <levelsubmenustyles>
          <asp:submenustyle backcolor="LightSteelBlue"
            forecolor="Black"/>
          <asp:submenustyle backcolor="SkyBlue"
            forecolor="Gray"/>          
        </levelsubmenustyles>  
      
        <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>

Remarks

The SubMenuStyleCollection class is used to store and manage a collection of SubMenuStyle objects in a Menu control. The Menu control uses the SubMenuStyleCollection class as the underlying data type of the LevelSubMenuStyles property.

The LevelSubMenuStyles property provides additional style choices in addition to the StaticMenuStyle and DynamicMenuStyle properties. The first style in the SubMenuStyleCollection collection corresponds to the submenu style for the first level of the menu. The second style in the collection corresponds to the submenu style for the second level of the menu, and so on. The LevelSubMenuStyles property is most often used to generate a navigation menu, like a Web site map, where menu items at a certain level should have the same appearance, regardless of whether they have submenus.

The SubMenuStyleCollection class inherits most of its members from the StateManagedCollection class. For more information on the inherited members, see the StateManagedCollection collection.

Properties

Count	Gets the number of elements contained in the StateManagedCollection collection. (Inherited from StateManagedCollection)
Item[Int32]	Gets a reference to the SubMenuStyle object at the specified index in the SubMenuStyleCollection collection object.

Methods

Add(SubMenuStyle)	Adds a submenu style to the SubMenuStyleCollection collection.
Clear()	Removes all items from the StateManagedCollection collection. (Inherited from StateManagedCollection)
Contains(SubMenuStyle)	Determines whether a SubMenuStyleCollection collection contains a specific SubMenuStyle instance.
CopyTo(Array, Int32)	Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index. (Inherited from StateManagedCollection)
CopyTo(SubMenuStyle[], Int32)	Copies the contents of a SubMenuStyleCollection collection to an array, starting at a specified array index.
CreateKnownType(Int32)	Creates an Object of the data type that corresponds to the specified index.
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
GetEnumerator()	Returns an iterator that iterates through the StateManagedCollection collection. (Inherited from StateManagedCollection)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetKnownTypes()	Creates an array of Type objects that contains the supported data types of the SubMenuStyleCollection class.
GetType()	Gets the Type of the current instance. (Inherited from Object)
IndexOf(SubMenuStyle)	Determines the location of a specified SubMenuStyle object in the SubMenuStyleCollection collection.
Insert(Int32, SubMenuStyle)	Inserts a SubMenuStyle object into the SubMenuStyleCollection collection at the specified index.
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
OnClear()	When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection. (Inherited from StateManagedCollection)
OnClearComplete()	When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection. (Inherited from StateManagedCollection)
OnInsert(Int32, Object)	Called before the Add(SubMenuStyle) and Insert(Int32, SubMenuStyle) methods.
OnInsertComplete(Int32, Object)	When overridden in a derived class, performs additional work after the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection. (Inherited from StateManagedCollection)
OnRemove(Int32, Object)	When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection. (Inherited from StateManagedCollection)
OnRemoveComplete(Int32, Object)	When overridden in a derived class, performs additional work after the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection. (Inherited from StateManagedCollection)
OnValidate(Object)	When overridden in a derived class, validates an element of the StateManagedCollection collection. (Inherited from StateManagedCollection)
Remove(SubMenuStyle)	Removes the first occurrence of the specified SubMenuStyle object from the SubMenuStyleCollection collection.
RemoveAt(Int32)	Removes the SubMenuStyle object at the specified location.
SetDirty()	Forces the entire StateManagedCollection collection to be serialized into view state. (Inherited from StateManagedCollection)
SetDirtyObject(Object)	Instructs a SubMenuStyle object contained by the SubMenuStyleCollection collection to record its entire state to view state.
ToString()	Returns a string that represents the current object. (Inherited from Object)

Explicit Interface Implementations

ICollection.Count	Gets the number of elements contained in the StateManagedCollection collection. (Inherited from StateManagedCollection)
ICollection.IsSynchronized	Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). This method returns `false` in all cases. (Inherited from StateManagedCollection)
ICollection.SyncRoot	Gets an object that can be used to synchronize access to the StateManagedCollection collection. This method returns `null` in all cases. (Inherited from StateManagedCollection)
IEnumerable.GetEnumerator()	Returns an iterator that iterates through the StateManagedCollection collection. (Inherited from StateManagedCollection)
IList.Add(Object)	Adds an item to the StateManagedCollection collection. (Inherited from StateManagedCollection)
IList.Clear()	Removes all items from the StateManagedCollection collection. (Inherited from StateManagedCollection)
IList.Contains(Object)	Determines whether the StateManagedCollection collection contains a specific value. (Inherited from StateManagedCollection)
IList.IndexOf(Object)	Determines the index of a specified item in the StateManagedCollection collection. (Inherited from StateManagedCollection)
IList.Insert(Int32, Object)	Inserts an item into the StateManagedCollection collection at the specified index. (Inherited from StateManagedCollection)
IList.IsFixedSize	Gets a value indicating whether the StateManagedCollection collection has a fixed size. This method returns `false` in all cases. (Inherited from StateManagedCollection)
IList.IsReadOnly	Gets a value indicating whether the StateManagedCollection collection is read-only. (Inherited from StateManagedCollection)
IList.Item[Int32]	Gets the IStateManager element at the specified index. (Inherited from StateManagedCollection)
IList.Remove(Object)	Removes the first occurrence of the specified object from the StateManagedCollection collection. (Inherited from StateManagedCollection)
IList.RemoveAt(Int32)	Removes the IStateManager element at the specified index. (Inherited from StateManagedCollection)
IStateManager.IsTrackingViewState	Gets a value indicating whether the StateManagedCollection collection is saving changes to its view state. (Inherited from StateManagedCollection)
IStateManager.LoadViewState(Object)	Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains. (Inherited from StateManagedCollection)
IStateManager.SaveViewState()	Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server. (Inherited from StateManagedCollection)
IStateManager.TrackViewState()	Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page. (Inherited from StateManagedCollection)

Extension Methods

Cast<TResult>(IEnumerable)	Casts the elements of an IEnumerable to the specified type.
OfType<TResult>(IEnumerable)	Filters the elements of an IEnumerable based on a specified type.
AsParallel(IEnumerable)	Enables parallelization of a query.
AsQueryable(IEnumerable)	Converts an IEnumerable to an IQueryable.

Applies to