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)
Syntax
'Declaration
<ExtensionAttribute> _
Public Shared Sub RenderPartial ( _
htmlHelper As HtmlHelper, _
partialViewName As String, _
viewData As ViewDataDictionary _
)
public static void RenderPartial(
this HtmlHelper htmlHelper,
string partialViewName,
ViewDataDictionary viewData
)
[ExtensionAttribute]
public:
static void RenderPartial(
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 Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).
Remarks
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.