ActionUrl Class
An Action which is used to redirect a browser to a specified page.
Namespace: DevExpress.ExpressApp.Actions
Assembly: DevExpress.ExpressApp.v24.1.dll
NuGet Package: DevExpress.ExpressApp
Declaration
Remarks
The ActionUrl class inherits the basic functionality of Actions from the ActionBase class. XAF supports URL Actions in ASP.NET Web Forms applications only.
Use ActionUrl to invoke a browser and pass an URL to it.
To specify the text of this link, use the ActionUrl.TextFormatString property.
To specify the URL, use the ActionUrl.UrlFormatString property.
To insert a value from the specified property to an URL or to an Action caption, use ActionUrl.UrlFieldName and ActionUrl.TextFieldName properties. See property descriptions for a list of associated restrictions.
ActionContainerHolder and ASPxGridViewContextMenu Action Containers create visual controls for ActionUrl. Other containers do not support this functionality.
XAF processes UrlFieldName and TextFieldName properties only when an Action is displayed in a separate grid column. The following example demonstrates how to configure ActionUrl for this scenario:
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
// ...
public class ActionUrlController : ViewController {
ActionUrl urlAction;
public ActionUrlController() {
urlAction = new ActionUrl(this, "ShowUrlAction", "ListView");
urlAction.SelectionDependencyType = SelectionDependencyType.RequireSingleObject;
urlAction.UrlFieldName = "Text";
urlAction.UrlFormatString = "http://www.google.com/?q={0}";
urlAction.TextFormatString = "Caption for {0}";
urlAction.TextFieldName = "Text";
}
}
Alternatively, you can use the ActionUrl Action to show a static URL that is independent from selected objects:
using DevExpress.ExpressApp;
using DevExpress.ExpressApp.Actions;
// ...
public class ActionUrlController : ViewController {
ActionUrl urlAction;
public ActionUrlController() {
urlAction = new ActionUrl(this, "ShowUrlAction", "RecordEdit");
urlAction.SelectionDependencyType = SelectionDependencyType.Independent;
urlAction.UrlFormatString = "http://www.google.com/";
}
}
The ActionUrl class is not designed for other scenarios.