ControlBuilder.OnAppendToParentBuilder(ControlBuilder) Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Notifica o ControlBuilder que está sendo adicionado a um construtor de controle pai.

public:
 virtual void OnAppendToParentBuilder(System::Web::UI::ControlBuilder ^ parentBuilder);

public virtual void OnAppendToParentBuilder (System.Web.UI.ControlBuilder parentBuilder);

abstract member OnAppendToParentBuilder : System.Web.UI.ControlBuilder -> unit
override this.OnAppendToParentBuilder : System.Web.UI.ControlBuilder -> unit

Public Overridable Sub OnAppendToParentBuilder (parentBuilder As ControlBuilder)

Parâmetros

parentBuilder

ControlBuilder

O objeto ControlBuilder ao qual o construtor atual é adicionado.

Exemplos

Este exemplo substitui o OnAppendToParentBuilder método para verificar a ControlType propriedade para determinar a qual tipo de controle esse construtor é aplicado. Se for um CustomTextBox, o construtor verificará se o valor da HasAspCode propriedade está incluído no controle. Nesse caso, uma exceção será gerada, se não o HasBody método for chamado.

using System;
using System.Web.UI;
using System.Web;
using System.Security.Permissions;

namespace ASPNET.Samples
{
    [
    AspNetHostingPermission(SecurityAction.Demand,
        Level=AspNetHostingPermissionLevel.Minimal)
    ]
    public class AppendControlBuilder : ControlBuilder
    {
        // Override the OnAppendToParentBuilder method.
        public override void OnAppendToParentBuilder(ControlBuilder parentBuilder)
        {
            // Check whether the type of the control this builder
            // is applied to is CustomTextBox. If so, check whether
            // ASP code blocks exist in the control. If so, call
            // throw an Exception, if not, call the HasBody method.        
            if (ControlType == Type.GetType("CustomTextBox"))
            {
                if (HasAspCode)
                    throw new Exception("This control cannot contain code blocks.");
                else
                    HasBody();
            }
        }
    }
}

Imports System.Web.UI
Imports System.Web
Imports System.Security.Permissions

Namespace ASPNET.Samples

   <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
   Public NotInheritable Class AppendControlBuilder
      Inherits ControlBuilder

      ' Override the OnAppendToParentBuilder method.
      Overrides Public Sub OnAppendToParentBuilder( _
         ByVal parentBuilder As ControlBuilder _
      )
            ' Check whether the type of the control this builder
            ' is applied to is CustomTextBox. If so, check whether
            ' ASP code blocks exist in the control. If so, call
            ' throw an Exception, if not, call the HasBody method.        
            If ControlType Is Type.GetType("CustomTextBox") Then
                If HasAspCode = True Then
                    Throw New Exception("This control cannot contain code blocks.")
                Else
                    HasBody()
                End If
            End If

        End Sub

   End Class

End Namespace