SearchResultCollection.ICollection.SyncRoot 属性

定义

命名空间:

System.DirectoryServices

程序集:

System.DirectoryServices.dll

包:

System.DirectoryServices v8.0.0

Source:

SearchResultCollection.cs

获取可用于同步对 ICollection 的访问的对象。

C#

object System.Collections.ICollection.SyncRoot { get; }

属性值

Object

用于同步对 ICollection 的访问的对象。

实现

SyncRoot

注解

对于其基础存储区不公用的集合，预期的实现是返回当前实例。 请注意，对于包装其他集合的集合，指向当前实例的指针可能不够;这些应返回基础集合的 SyncRoot 属性。

System.Collections 命名空间中的大多数集合类也实现 Synchronized 方法，该方法对基础集合提供同步的包装。 不过，派生类可使用 SyncRoot 属性来提供各自的同步版本的集合。 同步代码必须对 SyncRoot 集合的 执行操作，而不是直接对集合执行操作。 这样可确保对从其他对象派生的集合正确地执行操作。 具体地说，这样可与可能同时对集合实例进行修改的其他线程保持正确的同步。

在集合中 Synchronized 缺少方法时， 的预期用法 SyncRoot 如下所示：

C#

ICollection MyCollection =...  
 lock(MyCollection.SyncRoot) {  
  // Some operation on the collection, which is now thread safe.  
 }  

通过集合枚举本质上不是线程安全的过程。 即使某个集合已同步，其他线程仍可以修改该集合，这会导致枚举数引发异常。 若要确保枚举过程中的线程安全性，可以在整个枚举期间锁定集合，或者捕获由其他线程进行的更改所导致的异常。

下面的代码示例演示如何在整个枚举期间使用 SyncRoot 锁定集合：

C#

ICollection myCollection = new ICollection();  
 lock(myCollection.SyncRoot) {  
  foreach (Object item in myCollection) {  
  // Insert your code here.  
  }  
 }  

适用于

另请参阅

• IsSynchronized