VariablesCollection.IsSynchronized Property

Artikkeli
12/03/2008

Gets a value indicating whether access to the collection is synchronized (thread-safe).

Namespace: Microsoft.SqlServer.Dts.Tasks.Exec80PackageTask
Assembly: Microsoft.SqlServer.Exec80PackageTask (in microsoft.sqlserver.exec80packagetask.dll)

Syntax

'Declaration
Public Overridable ReadOnly Property IsSynchronized As Boolean

public virtual bool IsSynchronized { get; }

public:
virtual property bool IsSynchronized {
    bool get ();
}

/** @property */
public boolean get_IsSynchronized ()

public function get IsSynchronized () : boolean

Property Value

true if access to the collection is synchronized (thread-safe); otherwise, false. The default is false.

Remarks

Implements ICollection.IsSynchronized. If a collection is thread safe, the IsSynchronized property returns true, and the programmer does not have to do anything to keep the collection thread safe.

If the property returns false, then the SyncRoot property returns an object that can be used with the C# lock keyword. For more information, see ICollection.IsSynchronized.

Example

The ArrayList is a .NET Framework Class that inherits and implements the IsSynchronized property. The following code example shows how to synchronize an ArrayList, determine if an ArrayList is synchronized and use a synchronized ArrayList.

using System;
using System.Collections;
public class SamplesArrayList  
{
   public static void Main()  
   {
      // Creates and initializes a new ArrayList.
      ArrayList myAL = new ArrayList();
      myAL.Add( "The" );
      myAL.Add( "quick" );
      myAL.Add( "brown" );
      myAL.Add( "fox" );

      // Creates a synchronized wrapper around the ArrayList.
      ArrayList mySyncdAL = ArrayList.Synchronized( myAL );

      // Displays the sychronization status of both ArrayLists.
      Console.WriteLine( "myAL is {0}.", myAL.IsSynchronized ? "synchronized" : "not synchronized" );
      Console.WriteLine( "mySyncdAL is {0}.", mySyncdAL.IsSynchronized ? "synchronized" : "not synchronized" );
   }
}

Imports System
Imports System.Collections
Public Class SamplesArrayList
   Public Shared  Sub Main()
      ' Creates and initializes a new ArrayList.
      Dim myAL As ArrayList =  New ArrayList() 
      myAL.Add("The")
      myAL.Add("quick")
      myAL.Add("brown")
      myAL.Add("fox")
 
      ' Creates a synchronized wrapper around the ArrayList.
      Dim mySyncdAL As ArrayList =  ArrayList.Synchronized(myAL) 
 
      ' Displays the sychronization status of both ArrayLists.
      Console.WriteLine("myAL is {0}.", myAL.IsSynchronized ? "synchronized" : "not synchronized")
      Console.WriteLine("mySyncdAL is {0}.", mySyncdAL.IsSynchronized ? "synchronized" : "not synchronized")
   End Sub
End Class

Sample Output:

myAL is not synchronized.

mySyncdAL is synchronized.

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms