UserControlControlBuilder クラス

ユーザー コントロールとその子ユーザー コントロールを作成するときにページ パーサーをサポートします。

この型のすべてのメンバの一覧については、UserControlControlBuilder メンバ を参照してください。

System.Object
   System.Web.UI.ControlBuilder
      System.Web.UI.UserControlControlBuilder

Public Class UserControlControlBuilder
   Inherits ControlBuilder
[C#]
public class UserControlControlBuilder : ControlBuilder
[C++]
public __gc class UserControlControlBuilder : public ControlBuilder
[JScript]
public class UserControlControlBuilder extends ControlBuilder

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

既定では、ページ上のすべてのユーザー コントロールが既定の UserControlControlBuilder クラスに関連付けられます。このクラスは、カスタム コントロール タグ内にあるすべての入れ子のユーザー コントロールを格納する Controls プロパティに子コントロールを追加します。また、このクラスは、入れ子のコントロール タグの間にあるテキストのリテラル コントロールを作成します。このクラスを拡張することによって、カスタムのユーザー コントロール ビルダの機能を作成できます。

使用例

[Visual Basic] カスタムの UserControlControlBuilder クラスの作成例を次に示します。このクラスは、 ControlBuilder クラスから継承する AllowWhitespaceLiterals メソッドをオーバーライドします。 UserControl クラスに適用した場合、ユーザー コントロールに含まれている空白は無視されます。

 
' This is a Custom builder for user controls.
' It does not allow white space to be returned
' as instances of the LiteralControl class.
Public Class CustomUCBuilder
   Inherits UserControlControlBuilder
    Public Sub New()
    End Sub
  
  ' UserControlControlBuilder inherits this from
  ' ControlBuilder, but uses the base functionality
  ' of the method. You can override it to 
  ' create the custom behavior you want.  
  Public Overrides Function AllowWhitespaceLiterals() As Boolean
     Return False
  End Function
End Class

[C#, C++, JScript] C#、C++、および JScript のサンプルはありません。Visual Basic のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Web.UI

プラットフォーム: Windows 2000, Windows XP Professional, Windows Server 2003 ファミリ

アセンブリ: System.Web (System.Web.dll 内)

参照

UserControlControlBuilder メンバ | System.Web.UI 名前空間 | UserControl | ControlBuilder