NavBarGroupDataFields.NavigateUrlField Property

Gets or sets the name of a data field (or an xml element’s attribute) which provides group navigation locations.

Namespace: DevExpress.Web

Assembly: DevExpress.Web.v24.1.dll

NuGet Package: DevExpress.Web

Declaration

C#

[DefaultValue("")]
public override string NavigateUrlField { get; set; }

VB.NET

<DefaultValue("")>
Public Overrides Property NavigateUrlField As String

Property Value

Type	Default	Description
String	String.Empty	A string value that specifies the name of the required data source field.

Remarks

The NavigateUrlField property is in effect if the NavBarGroupDataFields control is bound to a data source (via the ASPxDataWebControlBase.DataSourceID or ASPxDataWebControlBase.DataSource property).

Use the NavigateUrlField property to specify the bound data source’s data field (or an xml element’s attribute) which stores navbar group’s navigate URLs. The NavigateUrlField property maps the NavBarGroup.NavigateUrl properties of NavBarGroup objects to the specified data field’s values.

You can format the obtained navigation locations by using the NavBarGroupDataFields.NavigateUrlFormatString property.

If the NavigateUrlField property of a data bound NavBarGroupDataFields control is not defined, the control can automatically obtain group navigation URLs from a data field whose name is “NavigateUrl” (which is equal to the NavBarGroup.NavigateUrl property’s name). You can also handle the ASPxNavBar.GroupDataBound event to manipulate a group’s settings, as required.

Example

In the code sample below, the ASPxNavBar control is bound to an XML file using a standard XmlDataSource component. The item/group NavigateUrlField and TextField properties are used to specify the names of data item attributes from which the corresponding item/group settings should be obtained. The ItemDataBound and GroupDataBound events are handled to add corresponding images to items and groups respectively.

The image below shows the result.

C#

protected void ASPxNavBar1_ItemDataBound(object source, DevExpress.Web.NavBarItemEventArgs e) {
     System.Xml.XmlNode dataItem = ((e.Item.DataItem as IHierarchyData).Item as System.Xml.XmlNode);
     switch (dataItem.Name) {
          case "ctor":
               e.Item.Image.Url = "Images/ctor.gif";
               break;
          case "property":
               e.Item.Image.Url = "Images/property.gif";
               break;
          case "method":
               e.Item.Image.Url = "Images/method.gif";
               break;
          case "event":
               e.Item.Image.Url = "Images/event.gif";
               break;
     }
}

protected void ASPxNavBar1_GroupDataBound(object source, DevExpress.Web.NavBarGroupEventArgs e) {
     e.Group.HeaderImage.Url = "Images/class.gif";
}

VB.NET

Protected Sub ASPxNavBar1_ItemDataBound(ByVal source As Object, ByVal e As DevExpress.Web.NavBarItemEventArgs)
     Dim dataItem As System.Xml.XmlNode = (TryCast((TryCast(e.Item.DataItem, IHierarchyData)).Item, System.Xml.XmlNode))
     Select Case dataItem.Name
          Case "ctor"
               e.Item.Image.Url = "Images/ctor.gif"
          Case "property"
               e.Item.Image.Url = "Images/property.gif"
          Case "method"
               e.Item.Image.Url = "Images/method.gif"
          Case "event"
               e.Item.Image.Url = "Images/event.gif"
     End Select
End Sub

Protected Sub ASPxNavBar1_GroupDataBound(ByVal source As Object, ByVal e As DevExpress.Web.NavBarGroupEventArgs)
     e.Group.HeaderImage.Url = "Images/class.gif"
End Sub

ASPX

<dx:ASPxNavBar ID="ASPxNavBar1" runat="server" DataSourceID="XmlDataSource1" 
     onitemdatabound="ASPxNavBar1_ItemDataBound" 
     ongroupdatabound="ASPxNavBar1_GroupDataBound">
     <GroupDataFields NavigateUrlField="HelpUrl" TextField="Title" />
     <ItemDataFields NavigateUrlField="HelpUrl" TextField="Title" />
</dx:ASPxNavBar>

<asp:XmlDataSource ID="XmlDataSource1" runat="server" DataFile="~/App_Data/TreeView/HelpNav.xml" XPath="/namespace/*">
</asp:XmlDataSource>