CompositeDataBoundControl.CreateChildControls 메서드

참조

정의

네임스페이스:: System.Web.UI.WebControls

어셈블리:: System.Web.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

데이터 바인딩된 합성 컨트롤을 렌더링하는 데 사용할 컨트롤 계층 구조를 만듭니다.

오버로드

CreateChildControls()	뷰 상태에 저장된 값에 따라 데이터 바인딩된 합성 컨트롤을 렌더링하는 데 사용할 컨트롤 계층 구조를 만듭니다.
CreateChildControls(IEnumerable, Boolean)	추상 클래스에서 재정의된 경우 지정된 데이터 소스의 값에 따라 데이터 바인딩된 합성 컨트롤을 렌더링하는 데 사용되는 컨트롤 계층 구조를 만듭니다.

CreateChildControls()

뷰 상태에 저장된 값에 따라 데이터 바인딩된 합성 컨트롤을 렌더링하는 데 사용할 컨트롤 계층 구조를 만듭니다.

protected public:
 override void CreateChildControls();

protected internal override void CreateChildControls ();

override this.CreateChildControls : unit -> unit

Protected Friend Overrides Sub CreateChildControls ()

설명

합니다 CreateChildControls() 에서 파생 된 클래스에서 사용 되는 도우미 메서드입니다는 CompositeDataBoundControl 복합 데이터 바인딩 컨트롤의 컨트롤 계층 구조를 만드는 클래스입니다. 메서드의이 오버 로드 대신 데이터 원본에서 직접 뷰 상태에서 값을 기준으로 컨트롤 계층 구조를 만듭니다.

추가 정보

CreateChildControls()

적용 대상

CreateChildControls(IEnumerable, Boolean)

추상 클래스에서 재정의된 경우 지정된 데이터 소스의 값에 따라 데이터 바인딩된 합성 컨트롤을 렌더링하는 데 사용되는 컨트롤 계층 구조를 만듭니다.

protected:
 abstract int CreateChildControls(System::Collections::IEnumerable ^ dataSource, bool dataBinding);

protected abstract int CreateChildControls (System.Collections.IEnumerable dataSource, bool dataBinding);

override this.CreateChildControls : System.Collections.IEnumerable * bool -> int

Protected MustOverride Function CreateChildControls (dataSource As IEnumerable, dataBinding As Boolean) As Integer

매개 변수

dataSource: IEnumerable

컨트롤에 바인딩할 값이 포함된 IEnumerable입니다.

dataBinding: Boolean

CreateChildControls(IEnumerable, Boolean)가 데이터 바인딩 동안 호출되면 true이고, 그렇지 않으면 false입니다.

반환

Int32

CreateChildControls(IEnumerable, Boolean)에 의해 만들어진 항목 수입니다.

예제

다음 코드 예제에는 재정의 하는 방법을 보여 줍니다.는 CreateChildControls(IEnumerable, Boolean) 컨트롤 계층 구조를 만들려면 사용자 지정 컨트롤의 메서드입니다.

using System;
using System.Collections;
using System.Data.Common;
using System.Web.UI;
using System.Web.UI.WebControls;

namespace Samples.AspNet.CS
{
    public class SimpleSpreadsheetControl : CompositeDataBoundControl
    {
        protected Table table = new Table();

        public virtual TableRowCollection Rows
        {
            get
            {
                return table.Rows;
            }
        }

        protected override int CreateChildControls(IEnumerable dataSource, bool dataBinding)
        {

            int count = 0;
            // If dataSource is not null, iterate through it and
            // extract each element from it as a row, then
            // create a SimpleSpreadsheetRow and add it to the
            // rows collection.
            if (dataSource != null)
            {

                SimpleSpreadsheetRow row;
                IEnumerator e = dataSource.GetEnumerator();

                while (e.MoveNext())
                {
                    object datarow = e.Current;
                    row = new SimpleSpreadsheetRow(count, datarow);
                    this.Rows.Add(row);
                    ++count;
                }

                Controls.Add(table);
            }
            return count;
        }
    }

    //
    //
    public class SimpleSpreadsheetRow : TableRow, IDataItemContainer
    {
        private object data;
        private int _itemIndex;

        public SimpleSpreadsheetRow(int itemIndex, object o)
        {
            data = o;
            _itemIndex = itemIndex;
        }

        public virtual object Data
        {
            get
            {
                return data;
            }
        }
        object IDataItemContainer.DataItem
        {
            get
            {
                return Data;
            }
        }
        int IDataItemContainer.DataItemIndex
        {
            get
            {
                return _itemIndex;
            }
        }
        int IDataItemContainer.DisplayIndex
        {
            get
            {
                return _itemIndex;
            }
        }
        protected override void RenderContents(HtmlTextWriter writer)
        {

            if (Data != null)
            {
                if (Data is System.Data.Common.DbDataRecord)
                {
                    DbDataRecord temp = (DbDataRecord)Data;
                    for (int i = 0; i < temp.FieldCount; ++i)
                    {
                        writer.Write("<TD>");
                        writer.Write(temp.GetValue(i).ToString());
                        writer.Write("</TD>");
                    }
                }
                else
                {
                    writer.Write("<TD>" + Data.ToString() + "</TD>");
                }
            }

            else
            {
                writer.Write("<TD>This is a test</TD>");
            }
        }
    }
}

Imports System.Collections
Imports System.Data.Common
Imports System.Web.UI
Imports System.Web.UI.WebControls

Namespace Samples.AspNet.VB

    Public Class SimpleSpreadsheetControl
        Inherits CompositeDataBoundControl

        Protected table As New Table()

        Public Overridable ReadOnly Property Rows() As TableRowCollection
            Get
                Return table.Rows
            End Get
        End Property


        Protected Overrides Function CreateChildControls(ByVal dataSource As IEnumerable, ByVal dataBinding As Boolean) As Integer

            Dim count As Integer = 0
            ' If dataSource is not Nothing, iterate through it and
            ' extract each element from it as a row, then
            ' create a SimpleSpreadsheetRow and add it to the
            ' rows collection.
            If Not (dataSource Is Nothing) Then

                Dim row As SimpleSpreadsheetRow
                Dim e As IEnumerator = dataSource.GetEnumerator()

                While e.MoveNext()
                    Dim datarow As Object = e.Current
                    row = New SimpleSpreadsheetRow(count, datarow)
                    Me.Rows.Add(row)
                    count += 1
                End While

                Controls.Add(table)
            End If
            Return count
        End Function 'CreateChildControls
    End Class


    Public Class SimpleSpreadsheetRow
        Inherits TableRow
        Implements IDataItemContainer

        Private dataObj As Object
        Private _itemIndex As Integer

        Public Sub New(ByVal itemIndex As Integer, ByVal o As Object)
            dataObj = o
            _itemIndex = itemIndex
        End Sub

        Public Overridable ReadOnly Property Data() As Object
            Get
                Return dataObj
            End Get
        End Property

        ReadOnly Property DataItem() As Object Implements IDataItemContainer.DataItem
            Get
                Return Data
            End Get
        End Property

        ReadOnly Property DataItemIndex() As Integer Implements IDataItemContainer.DataItemIndex
            Get
                Return _itemIndex
            End Get
        End Property

        ReadOnly Property DisplayIndex() As Integer Implements IDataItemContainer.DisplayIndex
            Get
                Return _itemIndex
            End Get
        End Property
        Protected Overrides Sub RenderContents(ByVal writer As HtmlTextWriter)

            If Not (Data Is Nothing) Then
                If TypeOf Data Is System.Data.Common.DbDataRecord Then
                    Dim temp As DbDataRecord = CType(Data, DbDataRecord)
                    Dim i As Integer

                    While i < temp.FieldCount
                        writer.Write("<TD>")
                        writer.Write(temp.GetValue(i).ToString())
                        writer.Write("</TD>")
                        i += 1
                    End While
                Else
                    writer.Write(("<TD>" + Data.ToString() + "</TD>"))
                End If

            Else
                writer.Write("<TD>This is a test</TD>")
            End If
        End Sub
    End Class
End Namespace

설명

합니다 CreateChildControls() 에서 파생 된 클래스에서 사용 되는 도우미 메서드입니다는 CompositeDataBoundControl 복합 데이터 바인딩 컨트롤의 컨트롤 계층 구조를 만드는 클래스입니다. 확장 하는 경우는 CompositeDataBoundControl 재정의 해야 클래스는 CreateChildControls() 메서드를 직접 만들 컨트롤 계층 구조입니다. 복합 컨트롤을 만드는 방법에 대 한 자세한 내용은 참조 하세요. 사용자 지정 ASP.NET 서버 컨트롤 개발합니다.

추가 정보

적용 대상

다음을 통해 공유

CompositeDataBoundControl.CreateChildControls 메서드

정의

오버로드

CreateChildControls()

설명

추가 정보

적용 대상

CreateChildControls(IEnumerable, Boolean)

매개 변수

반환

예제

설명

추가 정보

적용 대상

추가 리소스