This topic has not yet been rated - Rate this topic

LinkExtensions.ActionLink Method (HtmlHelper, String, String, String, String, String, String, Object, Object)

.NET Framework 3.5

Other Versions

.NET Framework 4

Returns an anchor element (a element) that contains the virtual path of the specified action.

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

Syntax

C++

public static string ActionLink(
	this HtmlHelper htmlHelper,
	string linkText,
	string actionName,
	string controllerName,
	string protocol,
	string hostName,
	string fragment,
	Object routeValues,
	Object htmlAttributes
)

Parameters

htmlHelper: Type: System.Web.Mvc.HtmlHelper
The HTML helper instance that this method extends.

linkText: Type: System.String
The inner text of the anchor element.

actionName: Type: System.String
The name of the action.

controllerName: Type: System.String
The name of the controller.

protocol: Type: System.String
The protocol for the URL, such as "http" or "https".

hostName: Type: System.String
The host name for the URL.

fragment: Type: System.String
The URL fragment name (the anchor name).

routeValues: Type: System.Object
An object that contains the parameters for a route. The parameters are retrieved through reflection by examining the properties of the object. The object is typically created by using object initializer syntax.

htmlAttributes: Type: System.Object
An object that contains the HTML attributes for the element. The attributes are retrieved through reflection by examining the properties of the object. The object is typically created by using object initializer syntax.

Return Value

Type: System.String
An anchor element (a element).

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type HtmlHelper. 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).

Exceptions

Exception	Condition
ArgumentException	Thrown if the linkText parameter is null or empty.

Remarks

The ActionLink method renders an element that links to an action method. The RouteLink method renders an element that links to a URL, which could resolve to an action method, a file, a folder, or some other resource.

Reference

LinkExtensions Class

LinkExtensions Members

ActionLink Overload

System.Web.Mvc.Html Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD