UpdatePanel.CreateContentTemplateContainer 메서드

정의

네임스페이스:

System.Web.UI

어셈블리:

System.Web.Extensions.dll

Control 컨트롤의 내용을 정의하는 자식 컨트롤의 컨테이너 역할을 하는 UpdatePanel 개체를 만듭니다.

protected:
 virtual System::Web::UI::Control ^ CreateContentTemplateContainer();

protected virtual System.Web.UI.Control CreateContentTemplateContainer ();

abstract member CreateContentTemplateContainer : unit -> System.Web.UI.Control
override this.CreateContentTemplateContainer : unit -> System.Web.UI.Control

Protected Overridable Function CreateContentTemplateContainer () As Control

반환

Control

Control 컨트롤 내용의 UpdatePanel 컨테이너입니다.

예제

다음 예제에서는 항상 <legend> <fieldset> 렌더링 하 고 패널의 콘텐츠에 대 한 요소를 사용자 지정 UpdatePanel 컨트롤에서 메서드를 재정 CreateContentTemplateContainer 의 하는 방법을 보여 옵니다. 사용자 지정 UpdatePanel 컨트롤은 요소 내 <legend> 의 문자열 리터럴인 public GroupingText 속성을 정의합니다.

명명된 사용자 지정 UpdatePanel 컨트롤은 메서드에서 UpdatePanel 파생되고 재정의 CreateContentTemplateContainer CustomUpdatePanel 됩니다. CustomUpdatePanel 웹 사이트의 App_Code 폴더에 클래스 소스 코드를 배치합니다.

using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace SamplesCS
{
    public class CustomUpdatePanel : System.Web.UI.UpdatePanel
    {
        public CustomUpdatePanel()
        {
        }

        private String _groupingText;
        public String GroupingText
        {
            get { return _groupingText; }
            set { _groupingText = value; }
        }

        protected override Control CreateContentTemplateContainer()
        {
            MyContentTemplateContainer myContentTemplateContainer =
                new MyContentTemplateContainer(_groupingText);
            return myContentTemplateContainer;
        }
        private sealed class MyContentTemplateContainer : Control
        {
            private String _displayText;
            public MyContentTemplateContainer(string groupingText)
            {
                _displayText = groupingText;
            }
            protected override void Render(HtmlTextWriter writer)
            {
                writer.RenderBeginTag(HtmlTextWriterTag.Fieldset);
                writer.RenderBeginTag(HtmlTextWriterTag.Legend);
                writer.Write(_displayText);
                writer.RenderEndTag();
                base.Render(writer);
                writer.RenderEndTag();
            }
        }
    }
}

Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace SamplesVB
    Public Class CustomUpdatePanel : Inherits System.Web.UI.UpdatePanel

        Public CustomUpdatePanel()

        Private _groupingText As String

        Public Property GroupingText() As String
            Get
                Return _groupingText
            End Get
            Set(ByVal value As String)
                _groupingText = value
            End Set
        End Property

        Protected Overrides Function CreateContentTemplateContainer() As Control
            Dim myContentTemplateContainer As MyContentTemplateContainer
            myContentTemplateContainer = New MyContentTemplateContainer(_groupingText)
            Dim myControl As Control
            myControl = myContentTemplateContainer
            Return myControl
        End Function

        Private NotInheritable Class MyContentTemplateContainer : Inherits Control

            Private _displayText As String
            Public Sub New(ByVal groupingText As String)
                _displayText = groupingText
            End Sub

            Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

                writer.RenderBeginTag(HtmlTextWriterTag.Fieldset)
                writer.RenderBeginTag(HtmlTextWriterTag.Legend)
                writer.Write(_displayText)
                writer.RenderEndTag()
                MyBase.Render(writer)
                writer.RenderEndTag()
            End Sub

        End Class
    End Class
End Namespace

사용자 지정 UpdatePanel 컨트롤은 컨트롤과 마찬가지로 UpdatePanel 페이지에서 사용됩니다. 다음 예제에서는 사용자 지정 UpdatePanel 컨트롤을 포함 하는 페이지를 보여 줍니다.

<%@ Page Language="C#" %>
<%@ Register Namespace="SamplesCS" TagPrefix="Samples" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CreateContentTemplateContainer Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:ScriptManager ID="ScriptManager1"
                           runat="server" />
        <Samples:CustomUpdatePanel ID="UpdatePanel1"
                                   UpdateMode="Conditional"
                                   GroupingText="This is an UpdatePanel."
                                   runat="server">
            <ContentTemplate>
                <asp:Calendar ID="Calendar1"
                              runat="server" />
            </ContentTemplate>
        </Samples:CustomUpdatePanel>
    </div>
    </form>
</body>
</html>

<%@ Page Language="VB" %>
<%@ Register Namespace="SamplesCS" TagPrefix="Samples" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>CreateContentTemplateContainer Example</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:ScriptManager ID="ScriptManager1"
                           runat="server" />
        <Samples:CustomUpdatePanel ID="UpdatePanel1"
                                   UpdateMode="Conditional"
                                   GroupingText="This is an UpdatePanel."
                                   runat="server">
            <ContentTemplate>
                <asp:Calendar ID="Calendar1"
                              runat="server" />
            </ContentTemplate>
        </Samples:CustomUpdatePanel>
    </div>
    </form>
</body>
</html>

설명

이 메서드는 컨트롤을 확장 UpdatePanel 하려는 컨트롤 개발자가 사용하기 위한 것입니다. 예를 들어 파생 클래스에서 컨트롤의 콘텐츠에 대한 컨테이너 역할을 하는 다른 루트 컨트롤을 제공할 수 있습니다 UpdatePanel . 기본 구현은 개체를 Control 반환합니다.

추가 정보

• ContentTemplateContainer
• ContentTemplate