UpdatePanel.RenderMode Property


Gets or sets a value that indicates whether an UpdatePanel control's content is enclosed in an HTML <div> or <span> element.

Namespace:   System.Web.UI
Assembly:  System.Web.Extensions (in System.Web.Extensions.dll)

Public Property RenderMode As UpdatePanelRenderMode

Property Value

Type: System.Web.UI.UpdatePanelRenderMode

One of the UpdatePanelRenderMode values. The default is Block so that the content of the panel is enclosed in an HTML <div> element.

If the RenderMode property is set to Inline, the content of an UpdatePanel control is rendered inside an HTML <span> element. If the RenderMode property is set to Block, it is rendered inside an HTML <div> element.

The following example shows how to set the RenderMode property declaratively. The UpdatePanel control named UpdatePanel1 is rendered in an HTML <span> element. If the RenderMode property were set to Block, the resulting paragraph would appear disjointed because of the way in which the HTML <div> element is rendered.

<%@ Page Language="VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<script runat="server">
    Protected Property PostBackCount As Integer
            If Not ViewState("PostBackCount") Is Nothing Then
                Return ViewState("PostBackCount")
            Else : Return 0
            End If
        End Get
        Set(ByVal value As Integer)
            ViewState("PostBackCount") = Value
        End Set
    End Property

    Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        If IsPostBack Then
            PostBackCount += 1
        End If
    End Sub

<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
    <title>UpdatePanelRenderMode Example</title>
    <form id="form1" runat="server">
            <asp:ScriptManager ID="ScriptManager1"
                               runat="server" />
            The number of times you have clicked the button is
            <asp:UpdatePanel ID="UpdatePanel1"
                    <%= PostBackCount.ToString() %>
                    times. Every time you click the count is incremented. The panel
                    containing the number of times you clicked is rendered in-line.
                    <br />
                    <asp:Button ID="Button1"
                                runat="server" />

.NET Framework
Available since 3.5
Return to top