UpdatePanel.RenderMode Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define um valor que indica se o conteúdo do controle de um UpdatePanel é circunscrito em um elemento <div>
ou <span>
HTML.
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, set
Public Property RenderMode As UpdatePanelRenderMode
Valor da propriedade
Um dos valores de UpdatePanelRenderMode. O padrão é Block, para que o conteúdo do painel seja circunscrito em um elemento HTML <div>
.
Exemplos
O exemplo a seguir mostra como definir a RenderMode propriedade declarativamente. O UpdatePanel controle chamado UpdatePanel1
é renderizado em um elemento HTML <span>
. Se a RenderMode propriedade fosse definida como Block, o parágrafo resultante apareceria desarticulado devido à maneira como o elemento HTML <div>
é renderizado.
<%@ 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>
Comentários
Se a RenderMode propriedade for definida como Inline, o conteúdo de um UpdatePanel controle será renderizado dentro de um elemento HTML <span>
. Se a RenderMode propriedade estiver definida como Block, ela será renderizada dentro de um elemento HTML <div>
.