C# Class CubicOrange.Windows.Forms.ActiveDirectory.DirectoryObjectPickerDialog

Represents a common dialog that allows a user to select directory objects.

The directory object picker dialog box enables a user to select one or more objects from either the global catalog, a Microsoft Windows 2000 domain or computer, a Microsoft Windows NT 4.0 domain or computer, or a workgroup. The object types from which a user can select include user, contact, group, and computer objects.

This managed class wraps the Directory Object Picker common dialog from the Active Directory UI.

It simplifies the scope (Locations) and filter (ObjectTypes) selection by allowing a single filter to be specified which applies to all scopes (translating to both up-level and down-level filter flags as necessary).

The object type filter is also simplified by combining different types of groups (local, global, etc) and not using individual well known types in down-level scopes (only all well known types can be specified).

The scope location is also simplified by combining down-level and up-level variations into a single locations flag, e.g. external domains.

Inheritance: System.Windows.Forms.CommonDialog
Exibir arquivo Open project: OPCFoundation/UA-.NET Class Usage Examples

Public Methods

Method Description
DirectoryObjectPickerDialog ( ) : System

Constructor. Sets all properties to their default values.

The default values for the DirectoryObjectPickerDialog properties are:

PropertyDefault value AllowedLocationsAll locations. AllowedObjectTypesAll object types. DefaultLocationsNone. (Will default to first location.) DefaultObjectTypesAll object types. MultiSelectfalse. SelectedObjectnull. SelectedObjectsEmpty array. ShowAdvancedViewfalse. TargetComputernull.

Reset ( ) : void

Resets all properties to their default values.

Protected Methods

Method Description
RunDialog ( IntPtr hwndOwner ) : bool

Displays the Directory Object Picker (Active Directory) common dialog, when called by ShowDialog.

Private Methods

Method Description
GetDefaultFilter ( ) : uint
GetDownLevelFilter ( ) : uint
GetOtherScope ( ) : uint
GetScope ( Locations locations ) : uint
GetStartingScope ( ) : uint
GetUpLevelFilter ( ) : uint
Initialize ( ) : IDsObjectPicker
ProcessSelections ( IDataObject dataObj ) : CubicOrange.Windows.Forms.ActiveDirectory.DirectoryObject[]

Method Details

DirectoryObjectPickerDialog() public method

Constructor. Sets all properties to their default values.

The default values for the DirectoryObjectPickerDialog properties are:

PropertyDefault value AllowedLocationsAll locations. AllowedObjectTypesAll object types. DefaultLocationsNone. (Will default to first location.) DefaultObjectTypesAll object types. MultiSelectfalse. SelectedObjectnull. SelectedObjectsEmpty array. ShowAdvancedViewfalse. TargetComputernull.

public DirectoryObjectPickerDialog ( ) : System
return System

Reset() public method

Resets all properties to their default values.
public Reset ( ) : void
return void

RunDialog() protected method

Displays the Directory Object Picker (Active Directory) common dialog, when called by ShowDialog.
protected RunDialog ( IntPtr hwndOwner ) : bool
hwndOwner IntPtr Handle to the window that owns the dialog.
return bool