Control.AddParsedSubObject(Object) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Hiermee wordt het serverbesturingselement aangegeven dat een element, XML of HTML, is geparseerd en wordt het element toegevoegd aan het object van ControlCollection het serverbesturingselement.

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)

Parameters

obj
Object

Een Object die het geparseerde element vertegenwoordigt.

Voorbeelden

Het volgende voorbeeld is een aangepast serverbesturingselement dat gebruikmaakt van de AddParsedSubObject methode om te bepalen of elementen die zijn gedeclareerd tussen de openings- en afsluittags van dit besturingselement webserverbesturingselementen zijn TextBox . Als dat zo is, worden ze toegevoegd aan een ArrayList object, items. Wanneer de overschreven CreateChildControls methode wordt aangeroepen, wordt de ArrayList methode herhaald en wordt elk object erin toegevoegd aan het ControlCollection aangepaste serverbeheer.

Important

Dit voorbeeld heeft een tekstvak dat gebruikersinvoer accepteert. Dit is een mogelijke beveiligingsrisico. Standaard valideren ASP.NET webpagina's dat gebruikersinvoer geen script- of HTML-elementen bevat. Zie Overzicht van Script Exploits voor meer informatie.

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

Opmerkingen

Tenzij u deze overschrijft, worden met deze methode automatisch objecten toegevoegd LiteralControl aan het object van ControlCollection het serverbeheer. Deze verzameling is toegankelijk via Control.Controls de eigenschap.

Van toepassing op

Zie ook