MenuEventArgs Sınıf

Tanım

Bir Menu denetimin MenuItemClick ve MenuItemDataBound olayları için veri sağlar. Bu sınıf devralınamaz.

public ref class MenuEventArgs sealed : System::Web::UI::WebControls::CommandEventArgs
public sealed class MenuEventArgs : System.Web.UI.WebControls.CommandEventArgs
type MenuEventArgs = class
    inherit CommandEventArgs
Public NotInheritable Class MenuEventArgs
Inherits CommandEventArgs
Devralma

Örnekler

Aşağıdaki kod örneği, denetimde görüntülenmeden önce menü öğesinin MenuEventArgs özelliklerini değiştirmek için MenuItemDataBound olay işleyicisine geçirilen nesnenin nasıl kullanılacağını Menu gösterir. ImageUrl Menü öğesinin Home özelliği, yalnızca bu menü öğesinde görüntü görüntüleyecek şekilde ayarlanır. Bu örneğin doğru çalışması için aşağıdaki örnek site haritası verilerini Web.site haritası adlı bir dosyaya kopyalamanız gerekir.


<%@ 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 MenuItemDataBound_NavigationMenu(Object sender, MenuEventArgs e)
  {
    // Display an image for the Home menu item only by
    // setting its ImageUrl property.
    if (e.Item.Text == "Home")
    {
      // Use an @-quoted string to bypass the escape sequence
      // processing.
      e.Item.ImageUrl = @"Images\Home.jpg";
    }
  }

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuEventArgs Example</title>
</head>
<body>
    <form id="form1" runat="server">
    
      <h3>MenuEventArgs Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        datasourceid="menusource" 
        onmenuitemdatabound="MenuItemDataBound_NavigationMenu" 
        runat="server">

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        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 MenuItemDataBound_NavigationMenu(ByVal sender As Object, ByVal e As MenuEventArgs)
  
    ' Display an image for the Home menu item only by
    ' setting its ImageUrl property.
    If e.Item.Text = "Home" Then
    
      e.Item.ImageUrl = "Images\Home.jpg"
      
    End If
      
  End Sub

</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuEventArgs Example</title>
</head>
<body>
    <form id="Form1" runat="server">
    
      <h3>MenuEventArgs Example</h3>
    
      <asp:menu id="NavigationMenu"
        staticdisplaylevels="2"
        staticsubmenuindent="10" 
        orientation="Vertical"
        datasourceid="menusource" 
        onmenuitemdatabound="MenuItemDataBound_NavigationMenu" 
        runat="server">

      </asp:menu>
      
      <asp:SiteMapDataSource id="MenuSource"
        Runat="server"/>

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

Aşağıda, önceki örnek için örnek site haritası verileri verilmiştir.

<siteMap>

<siteMapNode url="~\Home.aspx"

title="Home"

description="Home">

<siteMapNode url="~\Music.aspx"

title="Music"

description="Music">

<siteMapNode url="~\Classical.aspx"

title="Classical"

description="Classical"/>

<siteMapNode url="~\Rock.aspx"

title="Rock"

description="Rock"/>

<siteMapNode url="~\Jazz.aspx"

title="Jazz"

description="Jazz"/>

</siteMapNode>

<siteMapNode url="~\Movies.aspx"

title="Movies"

description="Movies">

<siteMapNode url="~\Action.aspx"

title="Action"

description="Action"/>

<siteMapNode url="~\Drama.aspx"

title="Drama"

description="Drama"/>

<siteMapNode url="~\Musical.aspx"

title="Musical"

description="Musical"/>

</siteMapNode>

</siteMapNode>

</siteMap>

Açıklamalar

MenuEventArgs sınıfı, aşağıdaki tabloda yer alan olaylar için bir olay işleyicisine geçirilen olay verilerini depolamak için kullanılır.

Olay Description
MenuItemClick Bir menü öğesine tıklandığında gerçekleşir. Bu olay genellikle bir denetimi sayfadaki başka bir Menu denetimle eşitlemek için kullanılır.
MenuItemDataBound Menü öğesi verilere bağlı olduğunda gerçekleşir. Bu olay genellikle bir denetimde Menu işlenmeden önce menü öğesini değiştirmek için kullanılır.

Oluşturulan olaya bağlı olarak, kullanıcı tarafından tıklanan menü öğesine veya veriye bağlı menü öğesine özelliğini kullanarak Item erişebilirsiniz.

Sınıfının bir örneğinin ilk özellik değerlerinin MenuEventArgs listesi için oluşturucuya MenuEventArgs bakın.

Oluşturucular

MenuEventArgs(MenuItem)

Belirtilen menü öğesini kullanarak sınıfın MenuEventArgs yeni bir örneğini başlatır.

MenuEventArgs(MenuItem, Object, CommandEventArgs)

Belirtilen menü öğesini, komut kaynağını ve olay bağımsız değişkenlerini kullanarak sınıfın yeni bir örneğini MenuEventArgs başlatır.

Özellikler

CommandArgument

Komutun bağımsız değişkenini alır.

(Devralındığı yer: CommandEventArgs)
CommandName

Komutun adını alır.

(Devralındığı yer: CommandEventArgs)
CommandSource

Object Olayı tetikleyen öğesini alır.

Item

Oluşturulan olayla ilişkili menü öğesini alır.

Yöntemler

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi işlevi görür.

(Devralındığı yer: Object)
GetType()

Type Geçerli örneğini alır.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli Objectöğesinin sığ bir kopyasını oluşturur.

(Devralındığı yer: Object)
ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.

(Devralındığı yer: Object)

Şunlara uygulanır

Ayrıca bkz.