Export (0) Print
Expand All

DirectorySynchronization Class

Specifies how to synchronize a directory within a domain.

System.Object
  System.DirectoryServices.DirectorySynchronization

Namespace:  System.DirectoryServices
Assembly:  System.DirectoryServices (in System.DirectoryServices.dll)

public class DirectorySynchronization

The DirectorySynchronization type exposes the following members.

  NameDescription
Public methodDirectorySynchronization()Initializes a new instance of the DirectorySynchronization object.
Public methodDirectorySynchronization(Byte[])Initializes a new instance of the DirectorySynchronization object with a cookie.
Public methodDirectorySynchronization(DirectorySynchronization)Initializes a new instance of the DirectorySynchronization object with a directory synchronization object.
Public methodDirectorySynchronization(DirectorySynchronizationOptions)Initializes a new instance of the DirectorySynchronization object with a directory synchronization option.
Public methodDirectorySynchronization(DirectorySynchronizationOptions, Byte[])Initializes a new instance of the DirectorySynchronization object with a directory synchronization option and cookie.
Top

  NameDescription
Public propertyOptionGets or sets the options for the directory synchronization search.
Top

  NameDescription
Public methodCopyReturns a copy of the current DirectorySynchronization instance.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetDirectorySynchronizationCookieGets the directory synchronization search cookie.
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodResetDirectorySynchronizationCookie()Resetss the directory synchronization search cookie.
Public methodResetDirectorySynchronizationCookie(Byte[])Resets the directory synchronization search cookie.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Top

The following C# example shows how to synchronize a directory.

DirectorySearcher src = new DirectorySearcher("…"); 
src.DirectorySynchornization= new DirectorySynchronization(); // Initiate dirsync, 
                                                              // this means a full synch

foreach(SearchResult res in src.FindAll() )
{
    Console.WriteLine(…");
}

// Restart the dirsync 
foreach(SearchResult res in src.FindAll() )
{
    Console.WriteLine(…");
}

The following C# example shows how to synchronize a directory by persisting it to a file.

DirectorySearcher src = new DirectorySearcher("…"); 
src.DirectorySynchornization= new DirectorySynchronization(); // Initiate dirsync, 
                                                              // this means a full synch

foreach(SearchResult res in src.FindAll() )
{
    Console.WriteLine(…");
}

// Now they should be able to persist the dirSync cookie, by serializing to a file. 
FileStream myStream = File.Create("dirsync.data");
BinaryFormatter fmt = new BinaryFormatter();
fmt.Serialize(myStream, src.DirectorySynchronization);
myStream.Close();
… …. 



// At some point in time, we wake up and read by de-serializing the dirSync cookie, 
// and resume the  dirSync 
FileStream myStream = FileCreate("dirsync.data");
BinaryFormatter fmt = new BinaryFormatter();
DirectorySynchronization dirSync = fmt.Deserialize(myStream);

DirectorySearcher src = new DirectorySearcher(…);
src.DirectorySynchronization = dirSync;

foreach(SearchResult res in src.FindAll() )
{
    Console.WriteLine(…");
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

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