UpdatePanelRenderMode Enum
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.
Represents the possible layout rendering options for the content of an UpdatePanel control on a page.
public enum class UpdatePanelRenderMode
public enum UpdatePanelRenderMode
type UpdatePanelRenderMode =
Public Enum UpdatePanelRenderMode
- Inheritance
Fields
Name | Value | Description |
---|---|---|
Block | 0 | Specifies that the content of the UpdatePanel control is rendered inside an HTML |
Inline | 1 | Specifies that the content of the UpdatePanel control is rendered inside an HTML |
Examples
The following example shows how to declaratively set the UpdatePanel.RenderMode property to Inline
. The UpdatePanel control contains a string that represents the number of postbacks from the page. The contents are rendered inline with the surrounding text.
<%@ 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
The UpdatePanelRenderMode
enumeration defines which HTML elements to use to enclose the content of the UpdatePanel control. The UpdatePanel.RenderMode property must be one of the values of the UpdatePanelRenderMode
enumeration. The content of an UpdatePanel control can be rendered inside either an HTML <div>
element or a <span>
element.
The default RenderMode property value is Block
.