Control.AddParsedSubObject メソッドとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

Control.AddParsedSubObject メソッド

サーバーコントロールに、XML または HTML の要素が解析されたことを通知し、その要素をサーバーコントロールの ControlCollection オブジェクトに追加します。

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

Visual Basic (宣言)

Protected Overridable Sub
 AddParsedSubObject ( _
    obj As Object _
)

Visual Basic (使用法)

Dim obj As Object

Me.AddParsedSubObject(obj)

protected virtual void AddParsedSubObject (
    Object obj
)

C++

protected:
virtual void AddParsedSubObject (
    Object^ obj
)

protected void AddParsedSubObject (
    Object obj
)

JScript

protected function AddParsedSubObject (
    obj : Object
)

パラメータ

obj: 解析された要素を表す Object。

解説

オーバーライドしない限り、このメソッドはサーバーコントロールの ControlCollection オブジェクトに LiteralControl オブジェクトを自動的に追加します。このコレクションは、Control.Controls プロパティによってアクセスできます。

使用例

カスタムサーバーコントロールの例を次に示します。このコントロールは、AddParsedSubObject メソッドを使用して、このコントロールの開始タグと終了タグの間で宣言されている要素が TextBox Web サーバーコントロールかどうかを確認します。Web サーバーコントロールの場合、これらの要素は ArrayList オブジェクト items に追加されます。オーバーライドされた CreateChildControls メソッドが呼び出されると、ArrayList が反復処理され、その中の各オブジェクトがカスタムサーバーコントロールの ControlCollection に追加されます。

Visual Basic

' Custom ControlBuilder class. Interprets nested tag name "myitem"
 as a textbox.
Public Class MyControlBuilder
   Inherits ControlBuilder

   Public Overrides Function
 GetChildControlType(tagName As String, _
                             attributes As IDictionary) As
 Type
      If String.Compare(tagName, "myitem",
 True) = 0 Then
         Return GetType(TextBox)
      End If
      Return Nothing
   End Function
End Class

<ControlBuilderAttribute(GetType(MyControlBuilder))> Public
 Class MyControl
   Inherits Control
   ' Stores all the controls specified as nested tags.
   Private items As New
 ArrayList()

   ' This function is internally invoked by IParserAccessor.AddParsedSubObject(Object).
   Protected Overrides Sub
 AddParsedSubObject(obj As Object)
      If TypeOf obj Is TextBox
 Then
         items.Add(obj)
      End If
   End Sub

  ' Override 'CreateChildControls'.
   Protected Overrides Sub
 CreateChildControls()
      Dim myEnumerator As System.Collections.IEnumerator
 = items.GetEnumerator()
      While myEnumerator.MoveNext()
         Me.Controls.Add(CType(myEnumerator.Current, TextBox))
      End While
   End Sub
End Class

// Custom ControlBuilder class. Interprets nested tag name "myitem"
 as a textbox. 
public class MyControlBuilder : ControlBuilder
 
{
   public override Type GetChildControlType(String tagName,
                                       IDictionary attributes)
   {
      if (String.Compare(tagName, "myitem", true)
 == 0) 
      {
         return typeof(TextBox);
      }
      return null;
   }
}

[ 
ControlBuilderAttribute(typeof(MyControlBuilder)) 
]
public class MyControl : Control
{
   // Store all the controls specified as nested tags.
   private ArrayList items = new ArrayList();
   
   // This function is internally invoked by IParserAccessor.AddParsedSubObject(Object).
   protected override void AddParsedSubObject(Object
 obj) 
   {
      if (obj is TextBox) 
      {
         items.Add(obj);
      }
   }

   // Override 'CreateChildControls'. 
   protected override void CreateChildControls()
   {
      System.Collections.IEnumerator myEnumerator = items.GetEnumerator();
      while(myEnumerator.MoveNext())
          this.Controls.Add((TextBox)myEnumerator.Current);
   }
}

// Custom ControlBuilder class. Interprets nested tag name "myitem"
 as 
// a textbox. 
public class MyControlBuilder extends ControlBuilder
{
    public Type GetChildControlType(String tagName, IDictionary
 attributes)
    {
        if (String.Compare(tagName, "myitem", true)
 == 0) {
            return TextBox.class.ToType();
        }
        return null;
    } //GetChildControlType
} //MyControlBuilder

/** @attribute ControlBuilderAttribute(MyControlBuilder.class)
 */
public class MyControl extends Control
{
    // Store all the controls specified as nested tags.
    private ArrayList items = new ArrayList();

    // This function is internally invoked by 
    // IParserAccessor.AddParsedSubObject(Object).
    protected void AddParsedSubObject(Object
 obj)
    {
        if (obj instanceof TextBox) {
            items.Add(obj);
        }
    } //AddParsedSubObject

    // Override 'CreateChildControls'. 
    protected void CreateChildControls()
    {
        System.Collections.IEnumerator myEnumerator = items.GetEnumerator();
        while (myEnumerator.MoveNext()) {
            this.get_Controls().Add((TextBox)myEnumerator.get_Current());
        }
    } //CreateChildControls
} //MyControl