UpdatePanel.RenderMode Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets a value that indicates whether an UpdatePanel control's content is enclosed in an HTML <div> or <span> element.
public:
property System::Web::UI::UpdatePanelRenderMode RenderMode { System::Web::UI::UpdatePanelRenderMode get(); void set(System::Web::UI::UpdatePanelRenderMode value); };public System.Web.UI.UpdatePanelRenderMode RenderMode { get; set; }member this.RenderMode : System.Web.UI.UpdatePanelRenderMode with get, setPublic Property RenderMode As UpdatePanelRenderModeProperty Value
One of the UpdatePanelRenderMode values. The default is Block so that the content of the panel is enclosed in an HTML <div> element.
Examples
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="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
protected int PostBackCount
{
get
{
return (int)(ViewState["PostBackCount"] ?? 0);
}
set
{
ViewState["PostBackCount"] = value;
}
}
protected void Page_Load(object sender, EventArgs e)
{
if (IsPostBack)
{
PostBackCount++;
}
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanelRenderMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
The number of times you have clicked the button is
<asp:UpdatePanel ID="UpdatePanel1"
UpdateMode="Conditional"
RenderMode="Inline"
runat="server">
<ContentTemplate>
<%= 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"
Text="Increment"
runat="server" />
</ContentTemplate>
</asp:UpdatePanel>
</div>
</form>
</body>
</html>
<%@ 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
Get
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
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head id="Head1" runat="server">
<title>UpdatePanelRenderMode Example</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:ScriptManager ID="ScriptManager1"
runat="server" />
The number of times you have clicked the button is
<asp:UpdatePanel ID="UpdatePanel1"
RenderMode="Inline"
runat="server">
<ContentTemplate>
<%= 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"
Text="Increment"
runat="server" />
</ContentTemplate>
</asp:UpdatePanel>
</div>
</form>
</body>
</html>
Remarks
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.
Applies to
See also
.NET