ControlCollection.SyncRoot Vlastnost

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

Získá objekt, který lze použít k synchronizaci přístupu k kolekci ovládacích prvků.

public:
 property System::Object ^ SyncRoot { System::Object ^ get(); };

public object SyncRoot { get; }

member this.SyncRoot : obj

Public ReadOnly Property SyncRoot As Object

Hodnota vlastnosti

Object

Používá Object se k synchronizaci kolekce.

Implementuje

SyncRoot

Příklady

Následující příklad kódu vytvoří metodu, která vytvoří výčet prostřednictvím ControlCollection kolekce Button ovládacího prvku, myButton. Při vytvoření enumerátoru IsSynchronized je vlastnost kontrolována, aby se zjistilo, zda je operace bezpečná pro vlákno, a pokud není, SyncRoot vlastnost se používá k získání objektu k zajištění bezpečného provozního vlákna. Po dokončení výčtu je hodnota IsReadOnly vlastnosti zapsána jako Text vlastnost Label ovládacího prvku na obsahující stránce.

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

Viz také

• Controls