aspMENU.net User Manual
Contents
1. aspM NU net User Manual Troubleshooting TABLE OF CONTENTS THOUDIGSROGUING Pae E a E ET 3 OVEIVIEW nes een 3 Frequently Asked Questions 22440220nn00nnnnnnnannnnnnnnnnnnnnnnnnnannnnnnnnne rn 4 1 How do I add aspMENU net to the Visual Studio toolbox 4 2 How do I add aspMENU net to my web form uuu 224sssnnner nennen 4 3 How do I specify the menl amp onteni seen 4 4 Is there a maximum number of items can specify per group 5 5 How do use Intellisense when making my XML files 5 6 How do I modify the menu group Style ccc eeeeeeeeeeeeeeteeeeeeeeeeeees 6 7 How do ladd files to the control nenne a 6 8 How can I provide varying access rights to particular menu GROUPS WSIS 2 sie an E euch 7 9 How do I define my user group u ren ae 7 10 Can handle events server side like the asp button control 8 11 How do I make each item a different height or width 8 12 How do I use multiple menus on a single page eessen 8 13 What does the OffsetX and OffsetY do uuuuesnssessnennnesnnnnnnnnnnnn nn 9 14 My Hrefs don t work for Menultems in my root group why not 9 15 What do the default values do 2 244400444nnnnnnnnnnnnnnn nn nnnnnn nn 9 16 How do I specify a value for a MenuGroup or Menultems that isn t a GETAU Fee a A mean or ean 9 17 What browser2. the menu content for your menu Page 7 of 12 aspMENU net User Manual e Define the UserList property for each Menultem or MenuGroup you wish to be visible by only particular user groups When doing this make sure you separate each specified group by a semicolon For example the file Menultem below is only visible by users who belong to users who belong to the Staff Student and Manager groups lt Menultem Caption File UserList Staff Student Manager gt 10 Can I handle events server side like the asp button control Perform the following actions to implement server side postback event for aspMENU net e Open create a web form in design mode e Highlight the instance of the asoMENU net control you wish to edit e Locate the PostBack property in the property grid and set it to True e For each menu item you wish to postback you must set the Href attribute in the XML to PostBack For example lt Menultem Caption Myltem Href PostBack gt 11 How do I make each item a different height or width By default each Menultem has its height and width set to the MenultemHeight and the MenultemWidth respectively If you want an Menultem to have a different height or width than the default it has to be specified in your data source XML file etc the XML File For example in the XML file you could have lt Menultem caption file height 200 gt This will set the height for the file Menultem to 200 p
3. versions are supported by aspMENU net 10 18 What browsers do the effects work with uueerseesnsennnenssnnneneennn 10 19 Why don t effects work with scrollable menus 10 20 How do I connect to a database uussnesssnnnnnennsssnnnnnnennnn nennen 11 21 Why does my menu render incorrectly some of the time 11 22 How do I make a Menultem link to another page 11 23 How do make a Menultem open a link in a new window 12 aspMENU net User Manual Page 2 of 12 aspMENU net User Manual TROUBLESHOOTING OVERVIEW This troubleshooting guide details what to do if your menu doesn t work appropriately after completing the steps outlined in the user manual It is split into a Frequently Asked Questions FAQ section and an Object Reference Section The FAQ section provides you with answers to some of the common questions Some of these questions are designed for users who want to achieve a very specific task others provide some information on some of the limitations of aspMENU net The Object Reference section gives you an in depth look into all public classes their properties methods and events This will supply the more advanced user with a great deal of information on the structure of aspMENU net which should come in handy if your menu isn t functioning correctly Only a skeleton of the complete Object
4. Due to the way the menus are rendered it isn t possible to have both scrolling and effects at the same time It is assumed that scrolling should take preference over effects because scrolling affects the way the menus are accessed while the effects just add visual appeal Page 10 of 12 aspMENU net User Manual 20 How do I connect to a database aspMENU net allows you to specify menu content through an XML file through a database or programmatically To connect to a database perform the following actions e Open create a web form in design mode e Highlight the instance of the aspMENU net control you wish to edit e Locate the DataSource property in the property grid and set it to Database e Go to the code behind the page and set the DatabaseConnectionString property to an appropriate value for your database For example to set up aspMENU net to connect to an MSAccess database the following connection string could be used Provider Microsoft Jet OLEDB 4 0 Data Source ASPMenu mdb 21 Why does my menu render incorrectly some of the time The demo version of asoMENU net has been designed to display an advertisement at regular intervals This has been done to make the demo version inappropriate to use on live websites The only way to stop this advertisement being displayed is by purchasing the full version 22 How do make a Menultem link to another page This task can be easily achieved by setting the Href p
5. Reference has been included For a complete listing of the Object Reference please view the ASPMenu chm file If your menu still doesn t work correctly after studying this section then please feel free to email our support team at info aspmenu net Page 3 of 12 aspMENU net User Manual FREQUENTLY ASKED QUESTIONS 1 How do I add aspMENU net to the Visual Studio toolbox Adding aspMENU net to Visual Studios control toolbox will make it available for use by all web applications that are created from this point onward e Open create a web form in design mode e Select Tools Add Remove Toolbox Items from the toolbar e Select the NET Framework Components tab e Click Browse e Select the assembly ASPMenu dll on the local machine and click Open aspMENU net should now be available on the toolbox and can simply be added to web forms 2 How dol add aspMENU net to my web form Please ensure asoMENU net has been added to the Visual Studio NET toolbox as outlined in question 1 before proceeding e Open create a web form in design mode e Locate aspMENU net in the control toolbox e Insert aspMENU net by either double clicking or clicking and dragging it onto the web form Visual studio will automatically add the assembly ASPMenu dll to your web applications bin directory 3 How do I specify the menu content aspMENU net provides three different data source options including XML Database and Progra
6. ixels The width can also be set in a similar way 12 How do I use multiple menus on a single page aspMENU net allows you to use multiple menus on a single page This can be achieved by adding two or more instances of asoMENU net to your web form as outlined in question 2 The only difficulty with multiple menus occurs when you Page 8 of 12 aspMENU net User Manual want each asoMENU net to use a difference CSS Theme If this is the case then you have to make sure each CSS Theme uses different Class names 13 What does the OffsetX and OffsetY do The offsetX and offsetY values effect how your MenuGroups will line up with the previous MenuGroup A negative value for offsetX moves the MenuGroup to the left and a negative value for offsetY moves the MenuGroup to the top These values let you customize where your MenuGroups are displayed to the user 14 My Hrefs don t work for Menultems in my root group why not The only reason why your Hrefs won t work in the root group is because you have enabled OpenOnClick So you can make the Hrefs work for Menultems in the root group by disabling OpenOnClick This is achieved by e Select the instance of the asoMENU net control you wish to edit e Locate the OpenOnClick property in the property grid and set it to false 15 What do the default values do The aspMENU net control provides all instances you create with default values for its various properties This ensures that the con
7. mmatic This data source can be set by selecting the Page 4 of 12 aspMENU net User Manual appropriate option from the DataSource property in the property grid For more information on defining menu content for each option please refer to the appropriate FAQ The remainder of this question assumes that you are using an XML file to define your content e Place the newly created XML file within the web applications directory This must be performed because aspMENU net only supports relative files e Highlight the instance of the asoMENU net control e Set the XmIFile property to the relative location of the XML file you created using the following format directory 1 directory2 myfile xml 4 Is there a maximum number of items can specify per group aspMENU net employs an internal naming system that uniquely identifies each particular Menultem and MenuGroup in the menu structure This naming system imposes a maximum of 100 items per group 5 How do I use IntelliSense when making my XML files Producing XML files for asoMENU net from a provided template or from scratch can be tricky due to the number of available configurations IntelliSense with our custom schema can greatly improve the speed and accuracy in which this task can be performed To add the schema perform the following actions e Open create a web application using Visual Studio NET e Right click on the web application in the solution explorer and select Add Add E
8. render a menu based on allocated privileges To achieve this assign a particular user to a user group by defining a session variable that has a name corresponding to the same name as the value of the SessionName property Open create a web form aspx in design mode Add the asoMENU net control to the web form Highlight the newly created control and set the EnableAccessControlList property to true using the property grid Set the value of the SessionName property to a value of your choice we ll assume you keep the default ASPMenuUser Select the point in your web forms logic where you want to set the user group this would be suited to a login page or similar Add an entry similar to Session ASPMenuUser Student where ASPMenuUser is the name of the session variable that corresponds to the SessionName value and Student is a user group defined in the UserList attribute of a particular Menultem or MenuGroup in the defined data source 9 How do I define my user group User groups explicitly define the users groups permitted to see various Menultems and MenuGroups If a user is not associated with a user group only default those without a UserGroup attribute menu items groups will be rendered The remainder of this question describes how to define user groups in an XML file but this task can also be easily accomplished using the other data Sources Open the XML file used to define
9. roperty of a Menultem For example the following XML will cause the file Menultem to link to http aspmenu net lt Menultem caption file Href http aspmenu net gt Page 11 of 12 aspMENU net User Manual 23 How do make a Menultem open a link in a new window This can be achieved by setting the Target property of a Menultem to _ blank For example the following XML will cause the file Menultem to open http aspmenu net in a new window lt Menultem caption file Href http aspmenu net Target _blank gt Page 12 of 12
10. trol will operate with relatively little configuration These values can be easily adjusted by using the data source of your choice and or property grid If in doubt please refer to question 17 16 How do I specify a value for a MenuGroup or Menultems that isn t a default By default each Menultem and MenuGroup has a set of properties that are set to the defaults specified in the control If you want to redefine these default values Page 9 of 12 aspMENU net User Manual for specific Menultems or MenuGroups you must specify it in your own data source the XML file For example in the XML you could have lt Menultem caption file ItemCss Item1 gt This will set the ItemCss for the particular Menultem to Item1 Other properties may be set in a similar fashion 17 What browser versions are supported by aspMENU net aspMENU net supports all the latest versions of the popular browsers The browsers supported include e Internet Explorer 5 and later versions e Netscape Navigator 6 and later versions e Mozilla 1 and later versions 18 What browsers do the effects work with The effects including Opacity and the Expand Effects will only work with Internet Explorer 5 5 and later When a browser that doesn t support effects accesses a page containing asoMENU net the menu will be rendered with the appropriate content but free of effects 19 Why don t effects work with scrollable menus
11. xisting Item e Locate ASPMenu xsd on the local machine and select Open Now when creating or editing XML for asoMENU net you can specify the targetSchema property in the property grid as ASPMenu xsd to reap the benefits of IntelliSense Page 5 of 12 aspMENU net User Manual 6 How do I modify the menu group style By using CSS aspMENU net permits you to adjust the CSS classes that are assigned to eed MenuGroupCss GroupCss Specifies the name of the CSS class to be used to render MenuGroups MenultemCss ltemCss Specifies the name of the CSS class to be used to render Menultems MenultemOverCss u ltemOverCss Specifies the name of the CSS class to be used to render Menultems when moused over You need to make sure the CSS file you register with the control through the CSSFile property defines the CSS classes you have registered with the values in the above table 7 How do I add files to the control aspMENU net only handles external files that are relative to the web application in which you are working with For example if your custom CSS file e g mycss css has been copied to the root directory of the web application the path for the CssFile property to this file would be mycss css no drive name backslashes and so on Page 6 of 12 aspMENU net User Manual 8 How can I provide varying access rights to particular menu groups items Use of access rights will enable asoMENU net to
Download Pdf Manuals
Related Search