DirectorySynchronization Class

 

Specifies how to synchronize a directory within a domain.

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

System.Object
  System.DirectoryServices.DirectorySynchronization

public class DirectorySynchronization

NameDescription
System_CAPS_pubmethodDirectorySynchronization()

Initializes a new instance of the DirectorySynchronization object.

System_CAPS_pubmethodDirectorySynchronization(Byte[])

Initializes a new instance of the DirectorySynchronization object with a cookie.

System_CAPS_pubmethodDirectorySynchronization(DirectorySynchronization)

Initializes a new instance of the DirectorySynchronization object with a directory synchronization object.

System_CAPS_pubmethodDirectorySynchronization(DirectorySynchronizationOptions)

Initializes a new instance of the DirectorySynchronization object with a directory synchronization option.

System_CAPS_pubmethodDirectorySynchronization(DirectorySynchronizationOptions, Byte[])

Initializes a new instance of the DirectorySynchronization object with a directory synchronization option and cookie.

NameDescription
System_CAPS_pubpropertyOption

Gets or sets the options for the directory synchronization search.

NameDescription
System_CAPS_pubmethodCopy()

Returns a copy of the current DirectorySynchronization instance.

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetDirectorySynchronizationCookie()

Gets the directory synchronization search cookie.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodResetDirectorySynchronizationCookie()

Resetss the directory synchronization search cookie.

System_CAPS_pubmethodResetDirectorySynchronizationCookie(Byte[])

Resets the directory synchronization search cookie.

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

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
Available since 2.0

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

Return to top
Show: