AjaxExtensions.ActionLink Method (AjaxHelper, String, String, String, RouteValueDictionary, AjaxOptions)

Returns an anchor tag that contains the URL to the specified action method; when the action link is clicked, the action method is invoked asynchronously by using JavaScript.

Namespace:  System.Web.Mvc.Ajax
Assembly:  System.Web.Mvc (in System.Web.Mvc.dll)

public static string ActionLink(
	this AjaxHelper ajaxHelper,
	string linkText,
	string actionName,
	string controllerName,
	RouteValueDictionary routeValues,
	AjaxOptions ajaxOptions
)

Parameters

ajaxHelper
Type: System.Web.Mvc.AjaxHelper
The AJAX helper.
linkText
Type: System.String
The inner text of the anchor tag.
actionName
Type: System.String
The name of the action method.
controllerName
Type: System.String
The name of the controller.
routeValues
Type: System.Web.Routing.RouteValueDictionary
An object that contains the parameters for a route.
ajaxOptions
Type: System.Web.Mvc.Ajax.AjaxOptions
An object that provides options for the asynchronous request.

Return Value

Type: System.String
An anchor tag.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type AjaxHelper. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

ExceptionCondition
ArgumentException

The linkText parameter is null or empty.

This method renders an anchor tag. When the user clicks the link, MVC asynchronously invokes the specified action method via an HTTP POST request. The response of that action method can be used to update a DOM element by id depending on which AjaxOptions are specified.

Community Additions

Show: