ControlBuilder.OnAppendToParentBuilder メソッド

.NET Framework クラス ライブラリ リファレンス

ControlBuilder.OnAppendToParentBuilder メソッド

親コントロール ビルダに追加されることを ControlBuilder に通知します。

名前空間: System.Web.UI
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Overridable Sub OnAppendToParentBuilder
 ( _
    parentBuilder As ControlBuilder _
)

Visual Basic (使用法)

Dim instance As ControlBuilder
Dim parentBuilder As ControlBuilder

instance.OnAppendToParentBuilder(parentBuilder)

C#

public virtual void OnAppendToParentBuilder
 (
    ControlBuilder parentBuilder
)

C++

public:
virtual void OnAppendToParentBuilder (
    ControlBuilder^ parentBuilder
)

J#

public void OnAppendToParentBuilder (
    ControlBuilder parentBuilder
)

JScript

public function OnAppendToParentBuilder (
    parentBuilder : ControlBuilder
)

パラメータ

parentBuilder

現在のビルダの追加先の ControlBuilder オブジェクト。

使用例

この例では、ControlType プロパティをチェックして、このビルダが適用されるコントロールの型を判断するように OnAppendToParentBuilder メソッドがオーバーライドされています。このコントロールがCustomTextBox である場合、ビルダは HasAspCode プロパティの値をチェックし、そのコントロールにコード ブロックが含まれているかどうかを確認します。コード ブロックが含まれている場合、例外がスローされ、含まれていない場合、HasBody メソッドが呼び出されます。

Visual Basic

Imports System
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

C#

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();
            }
        }
    }
}

プラットフォーム

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 によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ControlBuilder クラス
ControlBuilder メンバ
System.Web.UI 名前空間