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 _
)
'Usage
Dim htmlHelper As HtmlHelper 
Dim partialViewName As String 
Dim viewData As ViewDataDictionary 

htmlHelper.RenderPartial(partialViewName, _
    viewData)
public static void RenderPartial(
    this HtmlHelper htmlHelper,
    string partialViewName,
    ViewDataDictionary viewData
)
[ExtensionAttribute]
public:
static void RenderPartial(
    HtmlHelper^ htmlHelper, 
    String^ partialViewName, 
    ViewDataDictionary^ viewData
)
static member RenderPartial : 
        htmlHelper:HtmlHelper * 
        partialViewName:string * 
        viewData:ViewDataDictionary -> unit
public static function RenderPartial(
    htmlHelper : HtmlHelper, 
    partialViewName : String, 
    viewData : ViewDataDictionary
)

Parameters

  • partialViewName
    Type: System.String

    The name of the partial view.

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

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.

See Also

Reference

RenderPartialExtensions Class

RenderPartial Overload

System.Web.Mvc.Html Namespace