Export (0) Print
Expand All

RenderPartialExtensions.RenderPartial Method (HtmlHelper, String, ViewDataDictionary)

Renders the specified partial view, replacing its ViewData property with the specified ViewDataDictionary object.

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

public static void RenderPartial(
	this HtmlHelper htmlHelper,
	string partialViewName,
	ViewDataDictionary viewData
)

Parameters

htmlHelper
Type: System.Web.Mvc.HtmlHelper

The HTML helper.

partialViewName
Type: System.String

The name of the partial view.

viewData
Type: System.Web.Mvc.ViewDataDictionary

The view data.

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 http://msdn.microsoft.com/en-us/library/bb384936(v=vs.108).aspx or http://msdn.microsoft.com/en-us/library/bb383977(v=vs.108).aspx.

The RenderPartial method renders an ASP.NET user control (.ascx file) as a partial view.

When a partial view is instantiated, it gets its own copy of the ViewDataDictionary object that is available to the parent view. Therefore, the partial view has access to the data of the parent view. However, if the partial view updates the data, those updates affect only the partial view's ViewData object. The parent view's data is not changed.

Show:
© 2014 Microsoft