MenuItemBinding.ValueField 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
Value 개체가 적용된 MenuItem 개체의 MenuItemBinding 속성에 바운딩하기 위해 데이터 소스 필드의 이름을 가져오거나 설정합니다.
public:
property System::String ^ ValueField { System::String ^ get(); void set(System::String ^ value); };[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }[System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")]
public string ValueField { get; set; }[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, set[<System.ComponentModel.TypeConverter("System.Web.UI.Design.DataSourceViewSchemaConverter, System.Design, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a")>]
member this.ValueField : string with get, setPublic Property ValueField As String속성 값
Value이 적용된 MenuItem의 MenuItemBinding에 바인딩할 필드의 이름입니다. 기본값은 빈 문자열("")로, 이 속성이 설정되어 있지 않음을 나타냅니다.
- 특성
예제
다음 코드 예제를 사용 하는 방법에 설명 합니다 ValueField 속성에 바인딩할 필드의 이름을 지정 하는 Value 메뉴 항목의 속성입니다. 제대로 작동 하려면이 예제에서는 Menu.xml 라는 파일에 아래 샘플 XML 데이터를 복사 해야 합니다.
<%@ 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"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</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"
formatstring="({0})"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_self" />
<asp:menuitembinding datamember="MapNode"
depth="1"
formatstring="[{0}]"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
<asp:menuitembinding datamember="MapNode"
depth="2"
formatstring="<{0}>"
textfield="Title"
valuefield="Description"
imageurlfield="ImageUrl"
tooltipfield="ToolTip"
target="_blank"/>
</DataBindings>
</asp:menu>
<asp:xmldatasource id="MenuSource"
datafile="Menu.xml"
runat="server"/>
</form>
</body>
</html>
다음 코드는 이전 예제에 대 한 사이트 맵 데이터 샘플입니다.
<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>
설명
때를 Menu 컨트롤이 데이터 소스에 바인딩된, 사용 하 여를 ValueField 속성에 바인딩할 필드의 이름을 지정 하는 Value 의 속성을 MenuItem 개체. 렌더링 될 때를 Value 하려는 각 메뉴 항목의 속성을 MenuItemBinding 개체가 적용 된 필드에서 해당 값을 포함 합니다. 지정 된 값을 메뉴 항목에 표시 되지 않으며 메뉴 항목에 대 한 추가 데이터를 저장 하는 데 사용 되는 MenuItemBinding 포스트백 이벤트 처리에 사용 되는 데이터와 같은 개체에 적용 됩니다.
참고
설정 하 여 개별 메뉴 항목에 대 한 값을 재정의할 수 해당 Value 속성을 직접.
바인딩 기준에 설정 하 여 먼저 설정 해야 데이터 원본에 여러 테이블이 나 특성이 있으면, 합니다 Depth 속성을 DataMember 속성 또는 둘 다.
바인딩할이 속성을 사용 하는 대신 합니다 Value 의 속성을 MenuItem 바인딩할 수 있습니다이 정적 값으로 설정 하 여 필드에 개체를 MenuItemBinding.Value 속성. 각 메뉴 항목에 대해 동일한 값을 지정할 수 있습니다는 MenuItemBinding 개체 적용 됩니다.
참고
경우는 Value 및 ValueField 속성이 모두 설정의 ValueField 속성이 우선 합니다.