共用方式為

MenuItemCollection.CopyTo 方法

  • 參考

定義

命名空間:
System.Web.UI.WebControls
組件:
System.Web.dll

複製目前 MenuItemCollection 物件的內容。

多載

CopyTo(Array, Int32)

從目標陣列中的指定索引處開始，將 MenuItemCollection 物件中的所有項目複製到相容的一維 Array 中。
CopyTo(MenuItem[], Int32)

從目標陣列中的指定索引開始，從 MenuItemCollection 物件中，將所有項目複製至相容的一維陣列 MenuItem 物件。

CopyTo(Array, Int32)

從目標陣列中的指定索引處開始，將 MenuItemCollection 物件中的所有項目複製到相容的一維 Array 中。

public:
 virtual void CopyTo(Array ^ array, int index);
public void CopyTo (Array array, int index);
abstract member CopyTo : Array * int -> unit
override this.CopyTo : Array * int -> unit
Public Sub CopyTo (array As Array, index As Integer)

參數

array
Array

以零起始的 Array，會接收從目前 MenuItemCollection 所複製的項目。

index
Int32

目標陣列中開始接收複製內容的位置。

實作

CopyTo(Array, Int32)

例外狀況

ArgumentException

array 不是 MenuItem 物件的陣列。

備註

CopyTo使用 方法，將目前 MenuItemCollection 物件的內容複寫到指定的以零起始 System.Array 的 。 專案會從目標陣列的指定索引開始複製。 System.Array使用 之後，您可以使用陣列語法來存取 物件中的 MenuItemCollection 專案。

或者，您也可以使用 GetEnumerator 方法來建立列舉值，以用來存取集合中的專案。

另請參閱

適用於

CopyTo(MenuItem[], Int32)

從目標陣列中的指定索引開始，從 MenuItemCollection 物件中，將所有項目複製至相容的一維陣列 MenuItem 物件。

public:
 void CopyTo(cli::array <System::Web::UI::WebControls::MenuItem ^> ^ array, int index);
public void CopyTo (System.Web.UI.WebControls.MenuItem[] array, int index);
member this.CopyTo : System.Web.UI.WebControls.MenuItem[] * int -> unit
Public Sub CopyTo (array As MenuItem(), index As Integer)

參數

array
MenuItem[]

MenuItem 物件之以零起始的陣列，會接收從目前 MenuItemCollection 所複製的項目。

index
Int32

目標陣列中開始接收複製內容的位置。

範例

下列程式碼範例示範如何使用 CopyTo 方法，將 物件中的 MenuItemCollection 專案複製到 物件的陣列 MenuItem 。


<%@ 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)
  {

    // Display the submenu items of the Music
    // menu item. 

    // Retrieve the Music menu item.
    MenuItem musicMenuItem = NavigationMenu.FindItem(@"Home");

    // Declare an array of MenuItem objects.
         MenuItem[] musicItemArray = new MenuItem[musicMenuItem.ChildItems.Count];

    // Use the CopyTo method to copy the submenu items 
    // of the Music menu item into the array.
    musicMenuItem.ChildItems.CopyTo(musicItemArray, 0);
    
    // Display the menu items.
    Message.Text = "The submenu items of the Home menu item are: <br/><br/>";

    foreach (MenuItem item in musicItemArray)
    {

      Message.Text += item.Text + "<br />";

    }

  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection CopyTo 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>
      
      <hr/>

      <asp:label id="Message" 
        runat="server"/>

    </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)

    ' Display the submenu items of the Music
    ' menu item. 

    ' Retrieve the Music menu item.
    Dim musicMenuItem As MenuItem = NavigationMenu.FindItem("Home")

    ' Declare an array of MenuItem objects.
    Dim musicItemArray(musicMenuItem.ChildItems.Count - 1) As MenuItem
    
    ' Use the CopyTo method to copy the submenu items 
    ' of the Music menu item into the array.
    musicMenuItem.ChildItems.CopyTo(musicItemArray, 0)
    
    ' Display the menu items.
        Message.Text = "The submenu items of the Home menu item are: <br/><br/>"
    
    Dim item As MenuItem
    For Each item In musicItemArray
    
      Message.Text &= item.Text & "<br />"

    Next

  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemCollection CopyTo Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItemCollection CopyTo 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>
      
      <hr/>

      <asp:label id="Message" 
        runat="server"/>

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

備註

CopyTo使用 方法，將目前 MenuItemCollection 物件的內容複寫到指定的以零起始的陣列中。 專案會從目標陣列的指定索引開始複製。 透過陣列，您接著可以使用陣列語法來存取 物件中的 MenuItemCollection 專案。

或者，您也可以使用 GetEnumerator 方法來建立列舉值，以用來存取集合中的專案。

另請參閱

適用於