MenuItem Konstruktoren

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der MenuItem-Klasse.

Überlädt

Name	Beschreibung
MenuItem()	Initialisiert eine neue Instanz der MenuItem Klasse ohne Menütext oder einen Wert.
MenuItem(String)	Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts.
MenuItem(String, String)	Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts und -werts.
MenuItem(String, String, String)	Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, -werts und der URL zu einem Bild.
MenuItem(String, String, String, String)	Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, Werts, Bild-URL und Navigations-URL.
MenuItem(String, String, String, String, String)	Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, Werts, Bild-URL, Navigations-URL und Ziels.

MenuItem()

Initialisiert eine neue Instanz der MenuItem Klasse ohne Menütext oder einen Wert.

public:
 MenuItem();

public MenuItem();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie diesen Konstruktor verwenden, um eine neue Instanz der MenuItem Klasse zu erstellen. Das MenuItem Objekt wird dann verwendet, um die Menüelemente in einem Menu Steuerelement dynamisch aufzufüllen.


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem;
      homeMenuItem = CreateMenuItem("Home", "Home.aspx", "Home");

      // Create the submenu items.
      MenuItem musicSubMenuItem;
      musicSubMenuItem = CreateMenuItem("Music", "Music.aspx", "Music");

      MenuItem moviesSubMenuItem;
      moviesSubMenuItem = CreateMenuItem("Movies", "Movies.aspx", "Movies");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }
  
  MenuItem CreateMenuItem(String text, String url, String toolTip)
  {
    
    // Create a new MenuItem object.
    MenuItem menuItem = new MenuItem();
    
    // Set the properties of the MenuItem object using
    // the specified parameters.
    menuItem.Text = text;
    menuItem.NavigateUrl = url;
    menuItem.ToolTip = toolTip;
    
    return menuItem;
    
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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)
    
    If Not IsPostBack Then
      
      ' Create the menu structure.
    
      ' Create the root menu item.
      Dim homeMenuItem As MenuItem
      homeMenuItem = CreateMenuItem("Home", "Home.aspx", "Home")
    
      ' Create the submenu items.
      Dim musicSubMenuItem As MenuItem
      musicSubMenuItem = CreateMenuItem("Music", "Music.aspx", "Music")
    
      Dim moviesSubMenuItem As MenuItem
      moviesSubMenuItem = CreateMenuItem("Movies", "Movies.aspx", "Movies")
    
      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)
    
      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
    
  End Sub
  
  Function CreateMenuItem(ByVal text As String, ByVal url As String, ByVal toolTip As String) As MenuItem
    
    ' Create a new MenuItem object.
    Dim menuItem As New MenuItem()
    
    ' Set the properties of the MenuItem object using
    ' the specified parameters.
    MenuItem.Text = text
    MenuItem.NavigateUrl = url
    MenuItem.ToolTip = toolTip
    
    Return MenuItem
    
  End Function

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz einer MenuItem Klasse ohne Menütext oder einen Wert zu erstellen.

Note

Wenn dieser Konstruktor verwendet wird, werden alle Eigenschaften im MenuItem Objekt auf ihre Standardwerte festgelegt. Achten Sie darauf, die Eigenschaften nach dem Erstellen des Objekts nach Bedarf festzulegen.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

MenuItem(String)

Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts.

public:
 MenuItem(System::String ^ text);

public MenuItem(string text);

new System.Web.UI.WebControls.MenuItem : string -> System.Web.UI.WebControls.MenuItem

Public Sub New (text As String)

Parameter

text: String

Der Text, der für ein Menüelement in einem Menu Steuerelement angezeigt wird.

Beispiele


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem = new MenuItem("Home");

      // Create the submenu items.
      MenuItem musicSubMenuItem = new MenuItem("Music");
      MenuItem moviesSubMenuItem = new MenuItem("Movies");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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)
  
    If Not IsPostBack Then
    
      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music")
      Dim moviesSubMenuItem As New MenuItem("Movies")

      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)

      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
  
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der MenuItem Klasse mithilfe des durch den text Parameter angegebenen Menütexts zu erstellen.

Die folgende Tabelle zeigt den anfänglichen Eigenschaftswert für eine Instanz der MenuItem Klasse.

Eigentum	Anfangswert
Text	Der Wert des Textparameters.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

MenuItem(String, String)

Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts und -werts.

public:
 MenuItem(System::String ^ text, System::String ^ value);

public MenuItem(string text, string value);

new System.Web.UI.WebControls.MenuItem : string * string -> System.Web.UI.WebControls.MenuItem

Public Sub New (text As String, value As String)

Parameter

text: String

Der Text, der für ein Menüelement in einem Menu Steuerelement angezeigt wird.

value: String

Die zusätzlichen Daten, die dem Menüelement zugeordnet sind, z. B. Daten, die für die Behandlung von Postbackereignissen verwendet werden.

Beispiele


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem = new MenuItem("Home", "Root");

      // Create the submenu items.
      MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1");
      MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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)
  
    If Not IsPostBack Then
    
      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home", "Root")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music", "Category 1")
      Dim moviesSubMenuItem As New MenuItem("Movies", "Category 2")

      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)

      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
  
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der MenuItem Klasse zu erstellen, indem Sie den menütext bzw. den wert verwenden, der bzw. den die textvalue Parameter angeben.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz der MenuItem Klasse aufgeführt.

Eigentum	Anfangswert
Text	Der Wert des `text` Parameters.
Value	Der Wert des `value` Parameters.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

MenuItem(String, String, String)

Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, -werts und der URL zu einem Bild.

public:
 MenuItem(System::String ^ text, System::String ^ value, System::String ^ imageUrl);

public MenuItem(string text, string value, string imageUrl);

new System.Web.UI.WebControls.MenuItem : string * string * string -> System.Web.UI.WebControls.MenuItem

Public Sub New (text As String, value As String, imageUrl As String)

Parameter

text: String

Der Text, der für ein Menüelement in einem Menu Steuerelement angezeigt wird.

value: String

Die zusätzlichen Daten, die dem Menüelement zugeordnet sind, z. B. Daten, die für die Behandlung von Postbackereignissen verwendet werden.

imageUrl: String

Die URL zu einem Bild, das neben dem Text in einem Menüelement angezeigt wird.

Beispiele


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem = new MenuItem("Home", "Root", 
        @"Images\Home.jpg");

      // Create the submenu items.
      MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1", 
        @"Images\Music.jpg");
      MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2", 
        @"Images\Movies.jpg");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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)
  
    If Not IsPostBack Then
    
      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home", "Root", _
        "Images\Home.jpg")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music", "Category 1", _
        "Images\Music.jpg")
      Dim moviesSubMenuItem As New MenuItem("Movies", "Category 2", _
        "Images\Movies.jpg")

      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)

      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
  
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der MenuItem Klasse mithilfe der Menütext-, Wert- und Bild-URL zu erstellen, die bzw. die durch die textParameter value, bzw imageUrl . parameter angegeben wird.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz der MenuItem Klasse aufgeführt.

Eigentum	Anfangswert
Text	Der Wert des `text` Parameters.
Value	Der Wert des `value` Parameters.
ImageUrl	Der Wert des `imageUrl` Parameters.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

MenuItem(String, String, String, String)

Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, Werts, Bild-URL und Navigations-URL.

public:
 MenuItem(System::String ^ text, System::String ^ value, System::String ^ imageUrl, System::String ^ navigateUrl);

public MenuItem(string text, string value, string imageUrl, string navigateUrl);

new System.Web.UI.WebControls.MenuItem : string * string * string * string -> System.Web.UI.WebControls.MenuItem

Public Sub New (text As String, value As String, imageUrl As String, navigateUrl As String)

Parameter

text: String

Der Text, der für ein Menüelement in einem Menu Steuerelement angezeigt wird.

value: String

Die zusätzlichen Daten, die dem Menüelement zugeordnet sind, z. B. Daten, die für die Behandlung von Postbackereignissen verwendet werden.

imageUrl: String

Die URL zu einem Bild, das neben dem Text in einem Menüelement angezeigt wird.

navigateUrl: String

Die URL, mit der eine Verknüpfung hergestellt werden soll, wenn auf das Menüelement geklickt wird.

Beispiele


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem = new MenuItem("Home", "Root",
        @"Images\Home.jpg", "Home.aspx");

      // Create the submenu items.
      MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1",
        @"Images\Music.jpg", "Music.aspx");
      MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2",
        @"Images\Movies.jpg", "Movies.aspx");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        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)
  
    If Not IsPostBack Then
    
      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home", "Root", _
        "Images\Home.jpg", "Home.aspx")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music", "Category 1", _
        "Images\Music.jpg", "Music.aspx")
      Dim moviesSubMenuItem As New MenuItem("Movies", "Category 2", _
        "Images\Movies.jpg", "Movies.aspx")

      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)

      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
  
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der MenuItem Klasse zu erstellen, indem Sie den Menütext, den Wert, die Bild-URL und die Navigations-URL verwenden, die von den textparametern , value, imageUrlbzw navigateUrl . den Parametern angegeben wird.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz der MenuItem Klasse aufgeführt.

Eigentum	Anfangswert
Text	Der Wert des `text` Parameters.
Value	Der Wert des `value` Parameters.
ImageUrl	Der Wert des `imageUrl` Parameters.
NavigateUrl	Der Wert des `navigateUrl` Parameters.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

MenuItem(String, String, String, String, String)

Initialisiert eine neue Instanz der MenuItem Klasse mithilfe des angegebenen Menütexts, Werts, Bild-URL, Navigations-URL und Ziels.

public:
 MenuItem(System::String ^ text, System::String ^ value, System::String ^ imageUrl, System::String ^ navigateUrl, System::String ^ target);

public MenuItem(string text, string value, string imageUrl, string navigateUrl, string target);

new System.Web.UI.WebControls.MenuItem : string * string * string * string * string -> System.Web.UI.WebControls.MenuItem

Public Sub New (text As String, value As String, imageUrl As String, navigateUrl As String, target As String)

Parameter

text: String

Der Text, der für ein Menüelement in einem Menu Steuerelement angezeigt wird.

value: String

Die zusätzlichen Daten, die dem Menüelement zugeordnet sind, z. B. Daten, die für die Behandlung von Postbackereignissen verwendet werden.

imageUrl: String

Die URL zu einem Bild, das neben dem Text in einem Menüelement angezeigt wird.

navigateUrl: String

Die URL, mit der eine Verknüpfung hergestellt werden soll, wenn auf das Menüelement geklickt wird.

target: String

Das Zielfenster oder -frame, in dem der Webseiteninhalt angezeigt werden soll, der mit einem Menüelement verknüpft ist, wenn auf das Menüelement geklickt wird.

Beispiele


<%@ 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)
    {
      // Create the menu structure.

      // Create the root menu item.
      MenuItem homeMenuItem = new MenuItem("Home", "Root",
        @"Images\Home.jpg", "Home.aspx", "_self");

      // Create the submenu items.
      MenuItem musicSubMenuItem = new MenuItem("Music", "Category 1",
        @"Images\Music.jpg", "Music.aspx", "_blank");
      MenuItem moviesSubMenuItem = new MenuItem("Movies", "Category 2",
        @"Images\Movies.jpg", "Movies.aspx", "_blank");

      // Add the submenu items to the ChildItems
      // collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem);
      homeMenuItem.ChildItems.Add(moviesSubMenuItem);

      // Add the root menu item to the Items collection 
      // of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem);
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        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)
  
    If Not IsPostBack Then
    
      ' Create the menu structure.

      ' Create the root menu item.
      Dim homeMenuItem As New MenuItem("Home", "Root", _
        "Images\Home.jpg", "Home.aspx", "_self")

      ' Create the submenu items.
      Dim musicSubMenuItem As New MenuItem("Music", "Category 1", _
        "Images\Music.jpg", "Music.aspx", "_blank")
      Dim moviesSubMenuItem As New MenuItem("Movies", "Category 2", _
        "Images\Movies.jpg", "Movies.aspx", "_blank")

      ' Add the submenu items to the ChildItems
      ' collection of the root menu item.
      homeMenuItem.ChildItems.Add(musicSubMenuItem)
      homeMenuItem.ChildItems.Add(moviesSubMenuItem)

      ' Add the root menu item to the Items collection 
      ' of the Menu control.
      NavigationMenu.Items.Add(homeMenuItem)
      
    End If
  
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItem Constructor Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuItem Constructor Example</h3>
    
      <asp:menu id="NavigationMenu"
        orientation="Vertical"
        target="_blank" 
        runat="server"/>

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

Hinweise

Verwenden Sie diesen Konstruktor, um eine neue Instanz der MenuItem Klasse zu erstellen, indem Sie den Menütext, den Wert, die Bild-URL, die Navigations-URL und das Ziel verwenden, die jeweils durch die textParameter , value, , imageUrlnavigateUrlund die target Parameter angegeben werden.

In der folgenden Tabelle sind die anfänglichen Eigenschaftswerte für eine Instanz der MenuItem Klasse aufgeführt.

Eigentum	Anfangswert
Text	Der Wert des `text` Parameters.
Value	Der Wert des `value` Parameters.
ImageUrl	Der Wert des `imageUrl` Parameters.
NavigateUrl	Der Wert des `navigateUrl` Parameters.
Target	Der Wert des `target` Parameters.

Dieser Konstruktor wird häufig verwendet, wenn die Items Auflistung eines Menu Steuerelements oder der ChildItems Auflistung eines MenuItem Objekts dynamisch auffüllt wird.

Weitere Informationen

Gilt für:

Feedback

War diese Seite hilfreich?