MenuItemCollection.Remove メソッド

.NET Framework クラス ライブラリ リファレンス

MenuItemCollection.Remove メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定した MenuItem オブジェクトを MenuItemCollection オブジェクトから削除します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Sub Remove ( _
    value As MenuItem _
)

Visual Basic (使用法)

Dim instance As MenuItemCollection
Dim value As MenuItem

instance.Remove(value)

C#

public void Remove (
    MenuItem value
)

C++

public:
void Remove (
    MenuItem^ value
)

J#

public void Remove (
    MenuItem value
)

JScript

public function Remove (
    value : MenuItem
)

パラメータ

value

削除する MenuItem オブジェクト。

解説

Remove メソッドを使用して、指定したメニュー項目をコレクションから削除します。削除されるメニュー項目の後に続く項目はすべて、空いた位置を埋め合わせるように上に移動します。移動した項目のインデックスも更新されます。

メモ
MenuItemCollection オブジェクトは、null 値だけでなく、複製の MenuItem オブジェクトも格納できます。

または、RemoveAt メソッドを使用して、コレクションの特定のインデックス位置からメニュー項目を削除することもできます。Clear メソッドを使用して、コレクションからすべてのメニュー項目を削除することもできます。

使用例

Remove メソッドを使用して、MenuItemCollection オブジェクトから MenuItem オブジェクトをプログラムによって削除する方法のコード例を次に示します。

Visual Basic

<%@ Page Language="VB" %>

<script runat="server">
    
  Sub Page_Load(ByVal sender As
 Object, ByVal e As EventArgs)
  
    If Not IsPostBack Then
    
      ' Retrieve the root menu item from the Items
      ' collection of the Menu control.
      Dim homeMenuItem As MenuItem = NavigationMenu.Items(0)

      ' Retrieve the Movie submenu item from the ChildItems
      ' collection of the root menu item.
      Dim movieSubMenuItem As MenuItem = NavigationMenu.FindItem("Home\Movies")

      ' Remove the Movie submenu item.
      If movieSubMenuItem IsNot Nothing Then
      
        homeMenuItem.ChildItems.Remove(movieSubMenuItem)
        
      End If
        
    End If
        
  End Sub

</script>

<html>
  <body>
    <form runat="server">
    
      <h3>MenuItemCollection Remove Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <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>

C#

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

<script runat="server">
    
  void Page_Load(Object sender, EventArgs e)
  {
    if (!IsPostBack)
    {
      // Retrieve the root menu item from the Items
      // collection of the Menu control.
      MenuItem homeMenuItem = NavigationMenu.Items[0];

      // Retrieve the Movie submenu item from the ChildItems
      // collection of the root menu item.
      MenuItem movieSubMenuItem = NavigationMenu.FindItem(@"Home\Movies");

      // Remove the Movie submenu item.
      if (movieSubMenuItem != null)
      {
        homeMenuItem.ChildItems.Remove(movieSubMenuItem);
      }
    }
  }

</script>

<html>
  <body>
    <form runat="server">
    
      <h3>MenuItemCollection Remove Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server">
        
        <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>

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
MenuItemCollection クラス
MenuItemCollection メンバ
System.Web.UI.WebControls 名前空間
Menu クラス
MenuItem クラス
Menu.Items プロパティ
MenuItem.ChildItems プロパティ
Add
AddAt
Clear
RemoveAt