Control.ChildControlsCreated-Eigenschaft

Ruft einen Wert ab, der angibt, ob die untergeordneten Steuerelemente des Serversteuerelements erstellt wurden.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Protected Property ChildControlsCreated As Boolean
'Usage
Dim value As Boolean

value = Me.ChildControlsCreated

Me.ChildControlsCreated = value

protected bool ChildControlsCreated { get; set; }

protected:
property bool ChildControlsCreated {
    bool get ();
    void set (bool value);
}

/** @property */
protected boolean get_ChildControlsCreated ()

/** @property */
protected void set_ChildControlsCreated (boolean value)

protected function get ChildControlsCreated () : boolean

protected function set ChildControlsCreated (value : boolean)

Eigenschaftenwert

true, wenn die untergeordneten Steuerelemente erstellt wurden, andernfalls false.

Beispiel

Im folgenden Beispiel wird eine Überschreibung der OnDataBinding-Methode veranschaulicht. Um sicherzustellen, dass vor der nächsten Datenbindung keine untergeordneten Steuerelemente erstellt werden, wird die ChildControlsCreated-Eigenschaft auf true festgelegt, sobald die RepeaterItem-Objekte erstellt und dem ControlCollection-Objekt des Steuerelements hinzugefügt wurden.

' Override to create the repeated items from the DataSource.
Protected Overrides Sub OnDataBinding(E As EventArgs)
    MyBase.OnDataBinding(e)

    If Not DataSource Is Nothing
        ' Clear any existing child controls.
        Controls.Clear()
        ' Clear any previous view state for the existing child controls.
        ClearChildViewState()

        ' Iterate over the DataSource, creating a new item for each data item.
        Dim DataEnum As IEnumerator = DataSource.GetEnumerator()
        Dim I As Integer = 0
        Do While (DataEnum.MoveNext())

            ' Create an item.
            Dim Item As RepeaterItemVB = New RepeaterItemVB(I, DataEnum.Current)
            ' Initialize the item from the template.
            ItemTemplate.InstantiateIn(Item)
            ' Add the item to the ControlCollection.
            Controls.Add(Item)

            I = I + 1
        Loop

        ' Prevent child controls from being created again.
        ChildControlsCreated = true
        ' Store the number of items created in view state for postback scenarios.
        ViewState("NumItems") = I
    End If
End Sub

// Override to create the repeated items from the DataSource.
protected override void OnDataBinding(EventArgs e) {
    base.OnDataBinding(e);

    if (DataSource != null) {
        // Clear any existing child controls.
        Controls.Clear();
        // Clear any previous view state for the existing child controls.
        ClearChildViewState();

        // Iterate over the DataSource, creating a new item for each data item.
        IEnumerator dataEnum = DataSource.GetEnumerator();
        int i = 0;
        while(dataEnum.MoveNext()) {

            // Create an item.
            RepeaterItem item = new RepeaterItem(i, dataEnum.Current);
            // Initialize the item from the template.
            ItemTemplate.InstantiateIn(item);
            // Add the item to the ControlCollection.
            Controls.Add(item);

            i++;
        }

        // Prevent child controls from being created again.
        ChildControlsCreated = true;
        // Store the number of items created in view state for postback scenarios.
        ViewState["NumItems"] = i;
    }
}

// Override to create the repeated items from the DataSource.
protected void OnDataBinding(EventArgs e)
{
    super.OnDataBinding(e);

    if (get_DataSource() != null) {
        // Clear any existing child controls.
        get_Controls().Clear();
        // Clear any previous view state for the existing child controls.
        ClearChildViewState();
        // Iterate over the DataSource, creating a new item for each
        // data item.
        IEnumerator dataEnum = get_DataSource().GetEnumerator();
        int i = 0;
        while (dataEnum.MoveNext()) {
            // Create an item.
            RepeaterItem item = new RepeaterItem(i, dataEnum.get_Current());
            // Initialize the item from the template.
            get_ItemTemplate().InstantiateIn(item);
            // Add the item to the ControlCollection.
            get_Controls().Add(item);
            i++;
        }
        // Prevent child controls from being created again.
        set_ChildControlsCreated(true);
        // Store the number of items created in view state for postback
        // scenarios.
        get_ViewState().set_Item("NumItems", (Int32)i);
    }
} //OnDataBinding

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Control-Klasse
Control-Member
System.Web.UI-Namespace
CreateChildControls