RPutilities.ActiveDirectory 1.0.9

• .NETFramework 4.6.2

  • RPutilities.ExtractString (>= 1.0.11)
  • System.DirectoryServices (>= 10.0.3)

• .NETStandard 2.0

  • RPutilities.ExtractString (>= 1.0.11)
  • System.DirectoryServices (>= 10.0.3)

• net8.0

  • RPutilities.ExtractString (>= 1.0.11)
  • System.DirectoryServices (>= 10.0.3)

A lightweight Active Directory utility library for .NET that supports forest-wide searches across all domains, flexible LDAP filters, and DTO-based results with access to all Active Directory attributes.

     ✅ Async
     ✅ Forest-wide search
     ✅ DTO-based results (no SearchResult leakage)
     ✅ JSON-friendly
     ✅ NuGet-ready
     ✅ Windows-only (Active Directory)

     Search Active Directory across all domains in a forest.

     ✅ SearchAttribute
     - UserName
     - FullName
     - FirstName
     - LastName
     - All

     ✅ FilterType
     - Contains
     - StartWith
     - EndsWith
     - Is

     ✅ ObjectClassFilter
     - User
     - Group
     - Computer
     - Contact
     - OrganizationalUnit
     - Container
     - Domain
     - PrintQueue
     - ServiceConnectionPoint
     - PublicFolder
     - AllType

     ✅ Returns DTO objects instead of raw AD objects
     ✅ Access all AD attributes dynamically
     ✅ Easy JSON serialization

     🔍 Search users by LastName (using await in WinForms / desktop apps)

     using RPutilities.ActiveDirectory;
     using static RPutilities.ActiveDirectory.Options;

     var users = await ActiveDirectorySearch.Search(
     "Patel",
     ObjectClassFilter.User,
     SearchAttribute.LastName,
     FilterType.Is,
     CancellationToken.None);

     foreach (var user in users)
     {
     var s = user.Properties["mail"]?.ToString();
     }

     🔍 Search users across all supported search attributes (using await in WinForms / desktop apps)

     var users = await ActiveDirectorySearch.Search(
     "Patel",
     ObjectClassFilter.User,
     SearchAttribute.All,
     FilterType.Is,
     CancellationToken.None);

     🔍 Search users by UserName (for web apps / sync usage)

     using RPutilities.ActiveDirectory;
     using static RPutilities.ActiveDirectory.Options;

     var users = ActiveDirectorySearch.Search(
     Search,
     ObjectClassFilter.User,
     SearchAttribute.UserName,
     FilterType.Is);

     foreach (var user in users)
     {
     var s = user.Properties["mail"]?.ToString();
     }

     🔍 Search users across all supported search attributes (for web apps / sync usage)

     var users = ActiveDirectorySearch.Search(
     Search,
     ObjectClassFilter.User,
     SearchAttribute.All,
     FilterType.Is);

     ✅ Access common properties

     foreach (var user in users)
     {
     Console.WriteLine($"{user.DisplayName} ({user.SamAccountName}) - {user.Domain}");
     }

     ✅ Access any Active Directory property

     foreach (var user in users)
     {
     if (user.Properties.TryGetValue("mail", out var email))
     {
     Console.WriteLine($"Email: {email}");
     }
     }

     ✅ Handle multi-valued properties (example: memberOf)

     foreach (var user in users)
     {
     if (user.Properties.TryGetValue("memberOf", out var groups)  groups is object[] values)
     {
     foreach (var group in values)
     {
     Console.WriteLine(group);
     }
     }
     }

     ✅ Serialize to JSON

     using System.Text.Json;

     string json = JsonSerializer.Serialize(
     users,
     new JsonSerializerOptions { WriteIndented = true });

     Console.WriteLine(json);

     Common mapped DTO properties include:

     - Domain
     - DistinguishedName
     - Name
     - Cn
     - DisplayName
     - SamAccountName
     - UserPrincipalName
     - ObjectClass
     - ObjectClasses
     - ObjectCategory
     - ObjectGuid
     - ObjectSid
     - GivenName
     - Surname
     - Initials
     - Title
     - Description
     - Mail
     - MailNickname
     - TelephoneNumber
     - Mobile
     - City
     - State
     - PostalCode
     - Country
     - CountryName
     - CountryCode
     - PostOfficeBox
     - Company
     - Department
     - DepartmentNumber
     - Division
     - Manager
     - ManagedBy
     - PhysicalDeliveryOfficeName
     - EmployeeId
     - EmployeeNumber
     - EmployeeType
     - UserAccountControl
     - PrimaryGroupId
     - SamAccountType
     - InstanceType
     - LogonCount
     - BadPwdCount
     - CodePage
     - LastLogon
     - LastLogonTimestamp
     - LastLogoff
     - PasswordLastSet
     - AccountExpires
     - LockoutTime
     - BadPasswordTime
     - WhenCreated
     - WhenChanged
     - UsnCreated
     - UsnChanged
     - TargetAddress
     - LegacyExchangeDn
     - ThumbnailPhoto
     - MemberOf
     - DirectReports
     - ManagedObjects
     - Member
     - ProxyAddresses

     Dynamic access examples:

     user.Properties["objectClass"]
     user.Properties["cn"]
     user.Properties["displayName"]
     user.Properties["name"]
     user.Properties["distinguishedName"]
     user.Properties["userPrincipalName"]
     user.Properties["sAMAccountName"]
     user.Properties["mail"]
     user.Properties["telephoneNumber"]
     user.Properties["givenName"]
     user.Properties["sn"]
     user.Properties["initials"]
     user.Properties["l"]
     user.Properties["st"]
     user.Properties["postalCode"]
     user.Properties["c"]
     user.Properties["title"]
     user.Properties["description"]
     user.Properties["company"]
     user.Properties["department"]
     user.Properties["manager"]
     user.Properties["physicalDeliveryOfficeName"]
     user.Properties["employeeNumber"]
     user.Properties["employeeID"]
     user.Properties["lastLogon"]
     user.Properties["pwdLastSet"]
     user.Properties["userAccountControl"]
     user.Properties["accountExpires"]
     user.Properties["thumbnailPhoto"]
     user.Properties["whenCreated"]
     user.Properties["whenChanged"]
     user.Properties["memberOf"]
     user.Properties["directReports"]
     user.Properties["co"]
     user.Properties["mobile"]
     user.Properties["managedObjects"]
     user.Properties["departmentNumber"]
     user.Properties["member"]
     user.Properties["managedBy"]

     Access the above properties like this:

     foreach (var user in users)
     {
     richTextBox1.AppendText(
     $"FirstName: {user.Properties["givenName"]}\n" +
     $"LastName: {user.Properties["sn"]}\n" +
     $"Employee ID: {user.Properties["employeeID"]}\n");
     }

     Notes:
     - Common AD fields are mapped to strongly typed DTO properties.
     - All returned AD attributes are also available in the Properties dictionary.
     - Multi-valued attributes are returned as arrays.
     - Binary attributes such as thumbnailPhoto are preserved.
     - Common AD date/time fields are converted to DateTime where possible.
     - Domain is populated from the domain search context, with ADSPath parsing as fallback.