Aracılığıyla paylaş


MenuItemBinding.Value Özellik

Tanım

Geri gönderme olaylarını işlemek için kullanılan veriler gibi nesnenin MenuItemBinding uygulandığı menü öğesiyle ilgili ek verileri depolamak için kullanılan, görüntülenmeyen bir değeri alır veya ayarlar.

public:
 property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };
public string Value { get; set; }
member this.Value : string with get, set
Public Property Value As String

Özellik Değeri

öğesinin MenuItemBinding uygulandığı menü öğesi hakkında ek veriler; bu veriler görüntülenmez. Varsayılan değer, bu özelliğin ayarlanmadığını gösteren boş bir dizedir ("").

Örnekler

Aşağıdaki kod örneği, bir menü öğesiyle ilişkilendirilmiş görüntülenmemiş bir değer belirtmek için özelliğinin nasıl kullanılacağını Value gösterir. Bu değer, nesnenin uygulandığı her menü öğesinde MenuItemBinding kullanılır. Bu örneğin doğru çalışması için aşağıdaki örnek XML verilerini Menu.xml 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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        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">
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>MenuItemBinding Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <h3>MenuItemBinding Example</h3>

      <asp:menu id="NavigationMenu"
        datasourceid="MenuSource"
        runat="server">
        
        <databindings>
        
          <asp:menuitembinding datamember="MapHomeNode"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="1"
            textfield="Title"
            valuefield="Description"
            imageurlfield="ImageUrl"
            tooltipfield="ToolTip"/>
          <asp:menuitembinding datamember="MapNode" 
            depth="2"
            text="Static Title"
            value="Static Description"
            imageurl="~\Images\StaticImage.jpg"
            tooltip="Static ToolTip"/>
          
        </databindings>
        
      </asp:menu>

      <asp:xmldatasource id="MenuSource"
        datafile="Menu.xml"
        runat="server"/> 

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

Aşağıdaki kod, önceki örnek için örnek site haritası verileridir.

<MapHomeNode ImageUrl="~\Images\Home.gif"

Title="Home"

Description="Root Page"

ToolTip="Home Page">

<MapNode ImageUrl="~\Images\Music.gif"

Title="Music"

Description="Music Category"

ToolTip="Music Page">

<MapNode ImageUrl="~\Images\Classical.gif"

Title="Classical"

Description="Classical Section"

ToolTip="Classical Page"/>

<MapNode ImageUrl="~\Images\Rock.gif"

Title="Rock"

Description="Rock Section"

ToolTip="Rock Page"/>

<MapNode ImageUrl="~\Images\Jazz.gif"

Title="Jazz"

Description="Jazz Section"

ToolTip="Jazz Page"/>

</MapNode>

<MapNode ImageUrl="~\Images\Movies.gif"

Title="Movies"

Description="Movies Category"

ToolTip="Movies Page">

<MapNode ImageUrl="~\Images\Action.gif"

Title="Action"

Description="Action Section"

ToolTip="Action Page"/>

<MapNode ImageUrl="~\Images\Drama.gif"

Title="Drama"

Description="Drama Section"

ToolTip="Drama Page"/>

<MapNode ImageUrl="~\Images\Musical.gif"

Title="Musical"

Description="Musical Section"

ToolTip="Musical Page"/>

</MapNode>

</MapHomeNode>

Açıklamalar

Menu Denetim bir veri kaynağına bağlı olduğunda, nesnesinin Value özelliğine bağlanacak değeri belirtmek için MenuItem.Value özelliğini MenuItem kullanın. Bu değer, nesnenin MenuItemBinding uygulandığı tüm menü öğeleriyle paylaşılır. Belirtilen değer bir menü öğesinde görüntülenmez ve geri gönderme olaylarını işlemek için kullanılan veriler gibi nesnenin MenuItemBinding uygulandığı menü öğesiyle ilgili ek verileri depolamak için kullanılır.

Not

Özelliğini doğrudan ayarlayarak Value tek bir menü öğesinin değerini geçersiz kılabilirsiniz.

Her menü öğesi için aynı değeri belirtmek üzere bu özelliği kullanmak yerine, özelliğini ayarlayarak ValueField bir MenuItem nesnenin özelliğini veri kaynağının bir alanına bağlayabilirsinizValue. İşlendiğinde, nesnenin Value uygulandığı her menü öğesinin MenuItemBinding özelliği alandan karşılık gelen değeri içerir.

Not

Value ve ValueField özelliklerinin her ikisi de ayarlanırsa, ValueField özellik öncelikli olur.

Bu özelliğin değeri ayarlandığında, tasarımcı aracı kullanılarak otomatik olarak bir kaynak dosyasına kaydedilebilir. Daha fazla bilgi için bkz LocalizableAttribute . ve Genelleştirme ve Yerelleştirme.

Şunlara uygulanır

Ayrıca bkz.