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: