UpdatePanel.RenderMode Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI

Assembly:: System.Web.Extensions.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft einen Wert ab, der angibt, ob der Inhalt eines UpdatePanel-Steuerelements in ein <div>- bzw. <span>-HTML-Element eingeschlossen wird, oder legt diesen fest.

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

Eigenschaftswert

UpdatePanelRenderMode

Einer der UpdatePanelRenderMode-Werte. Der Standardwert ist Block. Damit wird angegeben, dass der Inhalt eines Bereichs in ein <div>-HTML-Element eingeschlossen wird.

Beispiele

Im folgenden Beispiel wird gezeigt, wie die RenderMode Eigenschaft deklarativ festgelegt wird. Das UpdatePanel Steuerelement namens UpdatePanel1 wird in einem HTML-Element <span> gerendert. Wenn die RenderMode -Eigenschaft auf Blockfestgelegt wäre, würde der resultierende Absatz aufgrund der Art und Weise, wie das HTML-Element <div> gerendert wird, getrennt angezeigt.


<%@ 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>

Hinweise

Wenn die RenderMode -Eigenschaft auf Inlinefestgelegt ist, wird der Inhalt eines UpdatePanel Steuerelements in einem HTML-Element <span> gerendert. Wenn die RenderMode -Eigenschaft auf Blockfestgelegt ist, wird sie in einem HTML-Element <div> gerendert.

Gilt für:

Weitere Informationen

UpdatePanelRenderMode