Control.AddParsedSubObject(Object) 方法

定义

命名空间:

System.Web.UI

程序集:

System.Web.dll

通知服务器控件，分析了一个元素（XML 或 HTML），并将该元素添加到服务器控件的 ControlCollection 对象中。

protected:
 virtual void AddParsedSubObject(System::Object ^ obj);

protected virtual void AddParsedSubObject (object obj);

abstract member AddParsedSubObject : obj -> unit
override this.AddParsedSubObject : obj -> unit

Protected Overridable Sub AddParsedSubObject (obj As Object)

参数

obj

Object

一个 Object，表示已经过分析的元素。

示例

以下示例是一个自定义服务器控件，该 AddParsedSubObject 控件使用该方法来确定此控件的开始标记和结束标记之间声明的元素是否为 TextBox Web 服务器控件。 如果是，则会将其添加到对象ArrayListitems中。 调用重写 CreateChildControls 的方法时，它会循环访问 ArrayList 其中的每个对象并将其添加到 ControlCollection 自定义服务器控件中。

重要

此示例具有一个接受用户输入的文本框，这是一个潜在的安全威胁。 默认情况下，ASP.NET 网页验证用户输入是否不包含脚本或 HTML 元素。 有关详细信息，请参阅脚本侵入概述。

// 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
   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

注解

除非重写它，否则此方法会自动将对象添加到 LiteralControl 服务器控件 ControlCollection 的对象。 可通过属性访问 Control.Controls 此集合。

另请参阅

• ControlCollection