ControlCollection.GetEnumerator Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.dll

Ruft einen Enumerator ab, der das ControlCollection-Objekt durchlaufen kann.

public:
 virtual System::Collections::IEnumerator ^ GetEnumerator();

public virtual System.Collections.IEnumerator GetEnumerator ();

abstract member GetEnumerator : unit -> System.Collections.IEnumerator
override this.GetEnumerator : unit -> System.Collections.IEnumerator

Public Overridable Function GetEnumerator () As IEnumerator

Gibt zurück

IEnumerator

Der Enumerator, der die Auflistung durchlaufen kann.

Implementiert

GetEnumerator()

Beispiele

Im folgenden Codebeispiel wird eine Methode erstellt, die die ControlCollection Auflistung eines Button Steuerelements myButtonaufzählt. Wenn der Enumerator erstellt wird, wird die IsSynchronized -Eigenschaft überprüft, um festzustellen, ob der Vorgang threadsicher ist. Andernfalls wird die SyncRoot -Eigenschaft verwendet, um ein Objekt abzurufen, um den Vorgangsthread zu schützen. Wenn die Enumeration abgeschlossen ist, wird der Wert der IsReadOnly -Eigenschaft als Eigenschaft Text eines Label Steuerelements auf der enthaltenden Seite geschrieben.

// Create a method that enuberates through a 
// button//s ControlCollection in a thread-safe manner.  
public void ListControlCollection(object sender, EventArgs e)
{
   IEnumerator myEnumerator = myButton.Controls.GetEnumerator();

   // Check the IsSynchronized property. If False,
   // use the SyncRoot method to get an object that 
   // allows the enumeration of all controls to be 
   // thread safe.
   if (myButton.Controls.IsSynchronized == false)
   {
       lock (myButton.Controls.SyncRoot)
       {
           while (myEnumerator.MoveNext())
           {

               Object myObject = myEnumerator.Current;

               LiteralControl childControl = (LiteralControl)myEnumerator.Current;
               Response.Write("<b><br /> This is the  text of the child Control  </b>: " +
                              childControl.Text);
           }
           msgReadOnly.Text = myButton.Controls.IsReadOnly.ToString();
       }
   }       
}

' Create a method that enuberates through a 
' button's ControlCollection in a thread-safe manner.  
Public Sub ListControlCollection(sender As Object, e As EventArgs)
   Dim myEnumerator As IEnumerator = myButton.Controls.GetEnumerator()

   ' Check the IsSynchronized property. If False,
   ' use the SyncRoot method to get an object that 
   ' allows the enumeration of all controls to be 
   ' thread safe.
   If myButton.Controls.IsSynchronized = False Then
     SyncLock myButton.Controls.SyncRoot
       While (myEnumerator.MoveNext())

       Dim myObject As Object  = myEnumerator.Current
           
         Dim childControl As LiteralControl = CType(myEnumerator.Current, LiteralControl)
         Response.Write("<b><br /> This is the  text of the child Control  </b>: " & _
                        childControl.Text)
       End While
      msgReadOnly.Text = myButton.Controls.IsReadOnly.ToString()
      
      End SyncLock
   End If       
 End Sub

Weitere Informationen

• IEnumerator
• Controls