This example demonstrates how to find a city on a map using the Microsoft Bing Search data service.

Note that the built-in search panel is not applicable in this example, so the BingSearchDataProvider.ShowSearchPanel property is set to false.

To find a city on the map, type it in the custom search panel and click the Go button. A search location parameter is passed to the BingSearchDataProvider.Search method, and you can see a desired location on the map. Note that there are 5 overloads for the Searchmethod, depending on your search criteria.

If you run this sample as is, you will get a warning message stating that the specified Bing Maps key is invalid. To learn about how to register a Bing Maps account and create a key for it, refer to How to: Get a Bing Maps Key tutorial.

This example demonstrates how to calculate a route between several waypoints and change the appearance of a route path by means of the Microsoft Bing Route web service.

To calculate a route between waypoints, call the BingRouteDataProvider.CalculateRoute method and pass a list of waypoints as its argument.

To customize the route path appearance, do the following:

- Handle the BingRouteDataProvider.RouteCalculated event;
- Access the route path using the RouteCalculationResult object inside the BingRouteDataProvider.RouteCalculated event handler's BingRouteCalculatedEventArgs;
- Create a MapPolylinewith calculated route points. To access the route points collection, use the BingRouteResult.RoutePath property;
- Customize the stroke and stroke width of the map polyline using the MapItem.Stroke and MapItem.StrokeWidth properties.

The map pushpins are generated automatically at each route waypoint position because the InformationDataProviderBase.GenerateLayerItemsproperty is set to true by default. Note that the pushpins' text contains an empty string.
To number route waypoints (from start to finish) in the pushpin, handle the InformationDataProviderBase.LayerItemsGeneratingevent and modify the MapPointer.Text property.

Note that if you run this sample as is, you will get a warning message saying that the specified Bing Maps key is invalid. To learn more about Bing Map keys, please refer to the How to: Get a Bing Maps Keytutorial.

This example demonstrates how to provide search for location and keywords using the BingSearchDataProvider.Search method.

In this example, the built-in Search panel is disabled (the BingSearchDataProvider.ShowSearchPanel property is set to false), because a custom panel is used instead.

To start search, specify search parameters (location and a keyword) in the custom Search panel and click the Search button. All search parameters are passed to the Search method and you can see the result in the rich text box element.

The results contain a display name, and address associated with the search location. In addition, the SearchRequestResult.AlternateSearchRegions property returns results of searching for alternate regions.

Note that if you run this sample as is, you will get a warning message saying that the specified Bing Maps key is invalid. To learn how to register a Bing Maps account and create a key for it, refer to the How to: Get a Bing Maps Keytutorial.

Starting with version 13.2, the ASPxWebControl.EnableDefaultAppearance property is obsolete.

There are two ways to disable the default appearance: use the ASPxButton.RenderMode property or CSS.

See the corresponding pages in the example for more details.

This example demonstrates how to create an Action within a persistent class declaration (i.e. how to convert a persistent class method into a SimpleAction or PopupWindowShowAction). The complete description is available in the How to: Create an Action Using the Action Attribute topic.

This example demonstrates how to provide the capability for end-users to click on a map and get detailed information about this place in the pushpin's tooltip, thanks to the Bing Geocode web service.

Note that if you run this sample as is, you will get a warning message saying that the specified Bing Maps key is invalid. To learn more about Bing Maps key, please refer to the How to: Get a Bing Maps Key tutorial.

This example is created by following instructions of the DevExpress WinForms: Getting started with the Scheduler video.

This example demonstrates how to create a master-detail report bound to Object Relational Model in ASP.NET MVC applications.

This example uses the Entity Framework ORM model to provide a report with data, but you can use any object model instead.

Bind your XtraReport to your model master class by using the approach suggested in the Providing Data to a Web Report => Design-Time Data Binding Using BindingSource help topic. After your report is bound to the master class you can easily insert a detail report band by using the context menu in the report designer, as shown below:

See also:
How to bind a report displayed in the DocumentViewer extension to the model's data

This example demonstrates how to customize a Report Wizard for WPF by removing its Grouping and Summaries pages.

To provide a custom report wizard, do the following:

- Create a descendant class for each page to be included in the wizard. For each custom page class, override the ReportWizardPage.GetNextPageType method to define the order in which the pages will appear in the wizard.

- Create a descendant class for ReportWizardPageFactory<ReportModel> and override its ReportWizardPageFactory.RegisterDependencies method to register the custom wizard pages.

- Create a descendant class for ReportWizardLauncherService<ReportModel> and override its ReportWizardLauncherService.CreatePageFactory method so that it returns a new instance of the previously defined custom factory.

To register a custom wizard launcher service for the Report Designer, create a new instance of the custom wizard launcher service and pass it to the ReportDesigner.Model.DesignServices.RegisterInstance<IReportWizardLauncherService> method.

This example illustrates an approach described in the How to take advantage of map provider API features that were not implemented in the dxMap widget? Knowledge Base article.

See also:
dxMap - How to add the current location marker

This example describes how to use the dxMap widget with HTML5 Geolocation.

See also:
How to take advantage of map provider API features that were not implemented in the dxMap widget?
dxMap - How to add draggable markers

This example illustrates how to store user UI settings (so-called model differences) in the application database instead of the file system (in Windows Forms applications) and session (in ASP.NET appications).

By default, an XAF Windows Forms application stores user customizations of the Application Model in the Model.User.xafml file, located in the application's directory. The application's model difference storage is also file-based (Model.xafml file). These two layers are superimposed when running an application. All model-related changes made by the end-user (e.g., layout customizations) are saved to the Model.User.xafml. The potential disadvantages of this default approach are:

- The Model.xafml file is not shared (except when the application is deployed to the terminal server). So even if this file is modified by an administrator, it must be re-deployed to all users to take effect;

- Since model differences are stored in a plain XML format, anyone who has access to XAFML files can easily influence the work of the application. So, it is possible to affect a critical setting that will cause the application to stop functioning;

- Several users sharing the same copy of the application cannot have individual customizations. This can be resolved by changing the user differences file location to the user profile folder (by setting the UserModelDiffsLocation key value to the CurrentUserApplicationDataFolder in the application configuration file). However, the problem persists if users are working under the same system account.

By default, an XAF ASP.NET application stores user customizations of the Application Model in the session. The global application model difference storage is file-based (Model.xafml file located in the web application folder). These two layers are superimposed when running an application. All model-related changes (e.g., columns order and visibility in List Views, dashboard layouts, etc.) made by end-users are saved to cookies. If a user accesses the ASP.NET application via several different devices (desktop, laptop or tablet), settings are not synchronized.

Generally, you can use the default storage in most scenarios. However, the disadvantages listed above become critical if you wish to give more power to application administrators and enhance application security. This example provides a solution that eliminates all these disadvantages. The main idea is to store all model differences in the application's database. Follow the instructions below to use the database model difference storage in your XAF application.

Build the DatabaseUserSettings.dll Assembly

- Download the solution attached to this example.

- Upgrade the downloaded solution up to your currently installed version of DXperience. Use the Project Converter utility for this purpose.

- Open the converted solution in Visual Studio. Switch to the Release configuration and build the DatabaseUserSettings project (this project contains the module that we are going to use).

- Copy the DatabaseUserSettings.dll assembly to an appropriate location in your development workstation.

Add the DatabaseUserSettings Module to Your XAF Solution

- Open your XAF solution that will use the DatabaseUserSettings module.

- Add the DatabaseModelStrorage.dll reference to the platform-agnostic module project.

- Right-click the Module.cs file and choose View Code. Modify the module's constructor in the following manner.

[C#]
publicsealedpartialclassMySolutionModule:ModuleBase{publicMySolutionModule(){InitializeComponent();this.RequiredModuleTypes.Add(typeof(DatabaseUserSettings.DatabaseUserSettingsModule));}}

Note:Alternatively, you can add the DatabaseUserSettings in the Module Designer.But you should register the DatabaseUserSettingsModule toolbox item first (see How to: Add Items to the Toolbox).

Now you can logon using different credentials and apply different customizations for each user. For instance, you can change the active skin for each user. Different users will have different skins selected after the application is restarted. Users should have read/write access to the XPUserSettings and XPUserSettingsAspect persistent types (these types are provided by the DatabaseUserSettings module and are used to store model differences).

The Configurator Account

To manage default model settings applied to users, a special Configurator account can be used. All customizations made by Configurator in the Model Editor or directly in the UI will be stored to the shared Application Model layer. To create such an account, do the following.

- Add a Role named "Configurator" (this name is declared by the DatabaseUserSettingsModule.ConfiguratorRoleName constant).

- For the added Role, grant full access to the XPUserSettings and XPUserSettingsAspect persistent types and read access to the UserName member of the type that represent users in your application (SecuritySystemUser by default). Alternatively, you can simply mark this role as administrative (see SecuritySystemRoleBase.IsAdministrative).

- Add a User named "Configurator" (this name is declared by the DatabaseUserSettingsModule.ConfiguratorUserName constant), and associate this user with the "Configurator" role.

Refer to the Updater.cs file to see the code.

The ManageUserSettings Action

The Configurator user has access to the ManageUserSettings Action. This Action of the PopupWindowShowActiontype is provided by the ManageUserSettingsWindowController Controller implemented in the DatabaseUserSettings module. This Action is intended to import a user setting from one user to another.

See Also
Core - Provide an easy way to store administrator and user model differences in a custom store (e.g., in a database)
A reusable XAF module for storing model settings in the database (security system type insensitive!)

ImportantNotes
1. Be aware of the following issue with this example: User settings may be duplicated/overridden under certain circumstances after merging configurator and user settings applied to the same element
2. This example solution is not yet tested in the middle-tier and SecuredObjectSpaceProvider scenario and most likely, it will have to be modified to support its specifics.
3. This example solution is not yet tested with custom fields.

This example illustrates how to get started with conditional formatting that can be applied to cells that match a certain condition specified by a conditional formatting rule.
In particular, this sample demonstrates how to use the SpreadsheetControl API to create the following types of conditional formatting rules:
- a rule that formats cells whose values are above or below the average;
- a rule that highlights cells whose values are between or not between two specified values;
- a rule that formats top or bottom ranked values;
- a rule that highlights cells containing the given text;
- a rule that formats unique or duplicate values, blank cells and formula errors;
- a rule that highlights cells containing dates in the specified time period;
- a rule that formats cells whose values meet the condition expressed by the relational operator;
- a rule that uses a formula to determine which cells to format;
- a two-color scale conditional formatting rule;
- a three-color scale conditional formatting rule;
- a data bar conditional formatting rule;
- an icon set conditional formatting rule.

This example illustrates how to get started with conditional formatting that can be applied to cells that match a certain condition specified by a conditional formatting rule.

In particular, this sample demonstrates how to use the Spreadsheet Document Server API to create the following types of conditional formatting rules:

- a rule that formats cells whose values are above or below the average;

- a rule that highlights cells whose values are between or not between two specified values;

- a rule that formats top or bottom ranked values;

- a rule that highlights cells containing the given text;

- a rule that formats unique or duplicate values, blank cells and formula errors;

- a rule that highlights cells containing dates in the specified time period;

- a rule that formats cells whose values meet the condition expressed by the relational operator;

- a rule that uses a formula to determine which cells to format;

- a two-color scale conditional formatting rule;

- a three-color scale conditional formatting rule;

- a data bar conditional formatting rule;

- an icon set conditional formatting rule.

This example demonstrates how to implement navigation between views by using the NavBarControl control and NavigationFrame class.

Problem:
I have two columns in my ASPxGridView. The first column contains values. The second column should contain different controls/editors depending on the values in the first column.

Solution:
In this scenario you need to generate a template for the GridViewDataColumn.DataItemTemplate Property dynamically by implementing the ITemplate Interface. For instance:

[C#]
protectedvoidPage_Init(objectsender,EventArgse){((GridViewDataColumn)ASPxGridView1.Columns["UnitPrice"]).DataItemTemplate=newCustomTemplate();}

[C#]
publicclassCustomTemplate:ITemplate{publicvoidInstantiateIn(Controlcontainer){GridViewDataItemTemplateContainergcontainer=(GridViewDataItemTemplateContainer)container;intunits=Convert.ToInt32(DataBinder.Eval(gcontainer.DataItem,"UnitsOnOrder"));if(units== 0){ASPxLabellabel=newASPxLabel();label.ID="label1";gcontainer.Controls.Add(label);label.Text=DataBinder.Eval(gcontainer.DataItem,"UnitPrice").ToString();label.Width= 100;}else{ASPxSpinEditbutton=newASPxSpinEdit();button.ID="spinEdit1";gcontainer.Controls.Add(button);button.Value=DataBinder.Eval(gcontainer.DataItem,"UnitPrice").ToString();button.Width= 100;button.ClientSideEvents.LostFocus=string.Format("function(s, e) {{ grid.PerformCallback('{0}|' + s.GetValue()); }}",gcontainer.KeyValue);}}}

Here we display a simple label if the "UnitsOnOrder" field value is zero. Otherwise, we display a spin edit control with the editing capability.

See Also:
General information about Template containers

This example illustrates how to implement instant editing in ASPxGridView. It is divided in two independent samples:

- The first sample (the Default1 page) illustrates how to post modified data to the underlying database on demand. Note that starting with v2013 vol 2, we provide a similar feature out-of-the-box: Batch Edit Mode.
- The second sample (the Default2 page) illustrates how to post modified data to the underlying database immediately.

In both samples, we define a custom GridViewDataColumn.DataItemTemplate with ASPxCheckBox. We handle the ASPxCheckBox' Init event (see The general technique of using the Init/Load event handler) to generate client-side ASPxClientCheckBox.CheckedChanged Event handler dynamically based on the current filed name and row key:

[C#]
// Default1.aspx.csprotectedvoidcb_Init(objectsender,EventArgse){ASPxCheckBoxcheckBox=(ASPxCheckBox)sender;GridViewDataItemTemplateContainercontainer=(GridViewDataItemTemplateContainer)checkBox.NamingContainer;stringkey=string.Format("{0}_{1}",container.Column.FieldName,container.KeyValue);checkBox.ClientSideEvents.CheckedChanged=string.Format("function(s, e) {{ hf.Set('{0}', s.GetChecked()); }}",key);}// Default2.aspx.csprotectedvoidcb_Init(objectsender,EventArgse){ASPxCheckBoxcheckBox=(ASPxCheckBox)sender;GridViewDataItemTemplateContainercontainer=(GridViewDataItemTemplateContainer)checkBox.NamingContainer;stringkey=string.Format("{0}|{1}",container.Column.FieldName,container.KeyValue);checkBox.ClientSideEvents.CheckedChanged=string.Format("function(s, e) {{ grid.PerformCallback('{0}|' + s.GetChecked()); }}",key);}

As you can see, in the first case we just save the modified value to the hidden field via the ASPxClientHiddenField.Set Method. These values will be extracted from it and posted to the database later when the "Save Changes" button is clicked. In the second case, we immediately initiate a saving callback via the ASPxClientGridView.PerformCallback Method.

See Also:
How to perform ASPxGridView instant updating using different editors in the DataItem template
How to implement the multi-edit functionality with a multi-page grid that is bound dynamically

This solution is created to illustrate the steps described in the Creating a registration form using ASPxEditors. Introduction tutorial series.

The solution consists of the following projects:

ASPxEditorsTutorial.Part1 - The resulting project for the Creating a registration form using ASPxEditors. Part 1 - Create the registration form layout article

ASPxEditorsTutorial.Part2 - The resulting project for the Creating a registration form using ASPxEditors. Part 2 - Customizing editors and adding a build-in client-side validation article

ASPxEditorsTutorial.Part3 - The resulting project for the Creating a registration form using ASPxEditors. Part 3 - Adding a Cascading Combo Boxes feature article

ASPxEditorsTutorial.Part4 - The resulting project for the Creating a registration form using ASPxEditors. Part 4 - Saving data to database article

ASPxEditorsTutorial.Part5 - The resulting project for the Creating a registration form using ASPxEditors. Part 5 - Implementing the password verification mechanism article

ASPxEditorsTutorial.Part6 - The resulting project for the Creating a registration form using ASPxEditors. Part 6 - Checking the entered email address article

This example illustrates how to hide a particular Band and draw on its place column captions that belong to this Band.

This example demonstrates how to create a master-detail report bound to Object Relational Model in ASP.NET MVC applications.

This example uses the Entity Framework ORM model to provide a report with data, but you can use any object model instead.

Bind your XtraReport to your model master class by using the approach suggested in the Providing Data to a Web Report => Design-Time Data Binding Using BindingSource help topic. After your report is bound to the master class you can easily insert a detail report band by using the context menu in the report designer, as shown below:

See also:
How to bind a report displayed in the DocumentViewer extension to the model's data