DirectorySearcher

[C#] DirectorySearcherのパフォーマンスを改善する方法

2025-01-18更新日: 2025-01-18

C#のDirectorySearcherのパフォーマンスを改善するためには、いくつかの方法があります。

まず、PageSizeプロパティを設定して、ページングを有効にすることで大量の結果を効率的に処理できます。

次に、PropertiesToLoadを使用して必要な属性のみを取得することで、データ転送量を削減します。

また、Filterプロパティを適切に設定して、検索範囲を絞り込むことも重要です。

SearchScopeをBaseやOneLevelに設定することで、検索範囲を限定し、パフォーマンスを向上させることができます。

最後に、ServerTimeLimitを設定して、サーバー側での検索時間を制限することも有効です。

これらの方法を組み合わせることで、DirectorySearcherのパフォーマンスを大幅に改善できます。

目次から探す

DirectorySearcherの設定
パフォーマンス改善の具体的手法
コードの最適化
応用例
まとめ

DirectorySearcherの設定

DirectorySearcherは、Active Directoryから情報を検索するためのクラスです。

パフォーマンスを向上させるためには、適切な設定が重要です。

ここでは、Filterプロパティ、PropertiesToLoad、SearchScopeの設定について詳しく解説します。

Filterプロパティの活用

Filterプロパティは、検索条件を指定するために使用します。

適切なフィルタを設定することで、検索結果を絞り込み、パフォーマンスを向上させることができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        
        // フィルタを設定
        searcher.Filter = "(objectClass=user)"; // ユーザーオブジェクトを検索
    }
}

この例では、ユーザーオブジェクトのみを検索するフィルタを設定しています。

フィルタを適切に設定することで、無駄なデータの取得を避け、検索速度を向上させることができます。

PropertiesToLoadの設定

PropertiesToLoadプロパティを使用すると、取得するプロパティを指定できます。

必要なプロパティのみを取得することで、データ転送量を減らし、パフォーマンスを改善できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        
        // 取得するプロパティを設定
        searcher.PropertiesToLoad.Add("cn"); // コモンネーム
        searcher.PropertiesToLoad.Add("mail"); // メールアドレス
    }
}

この例では、コモンネームとメールアドレスのみを取得するように設定しています。

必要な情報だけを取得することで、検索の効率が向上します。

SearchScopeの選択

SearchScopeプロパティは、検索の範囲を指定します。

適切なスコープを選択することで、検索のパフォーマンスを向上させることができます。

スコープ	説明
Base	指定したエントリのみを検索
OneLevel	指定したエントリの直下のエントリを検索
Subtree	指定したエントリ以下のすべてのエントリを検索

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        
        // 検索スコープを設定
        searcher.SearchScope = SearchScope.Subtree; // サブツリー全体を検索
    }
}

この例では、指定したエントリ以下のすべてのエントリを検索するように設定しています。

必要に応じてスコープを選択することで、検索の効率を高めることができます。

パフォーマンス改善の具体的手法

DirectorySearcherのパフォーマンスを改善するためには、いくつかの具体的な手法があります。

ここでは、PageSizeの設定、ServerTimeLimitの活用、Asynchronous検索の導入について詳しく解説します。

PageSizeの設定

PageSizeプロパティを設定することで、検索結果をページングし、メモリ使用量を抑えることができます。

特に、大量のデータを扱う場合に効果的です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        
        // ページサイズを設定
        searcher.PageSize = 1000; // 1ページあたり1000件の結果を取得
    }
}

この例では、1ページあたり1000件の結果を取得するように設定しています。

これにより、メモリの使用量を抑えつつ、効率的にデータを取得できます。

ServerTimeLimitの活用

ServerTimeLimitプロパティを使用すると、サーバーでの検索処理にかかる最大時間を設定できます。

これにより、長時間かかる検索を防ぎ、パフォーマンスを向上させることができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        
        // サーバーのタイムリミットを設定
        searcher.ServerTimeLimit = TimeSpan.FromSeconds(30); // 30秒に設定
    }
}

この例では、サーバーでの検索処理が30秒を超えた場合に、処理を中止するように設定しています。

これにより、無駄な待機時間を削減できます。

Asynchronous検索の導入

Asynchronous検索を導入することで、UIスレッドをブロックせずに検索を実行できます。

これにより、ユーザーエクスペリエンスが向上し、アプリケーションの応答性が改善されます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        // 非同期検索を実行
        Task.Run(() => PerformSearch());
    }
    private void PerformSearch()
    {
        DirectorySearcher searcher = new DirectorySearcher();
        searcher.Filter = "(objectClass=user)";
        
        // 検索を実行
        SearchResultCollection results = searcher.FindAll();
        
        // 結果の処理(UIスレッドでの更新はInvokeを使用)
        this.Invoke((MethodInvoker)delegate {
            // 結果をUIに表示する処理
        });
    }
}

この例では、Task.Runを使用して非同期に検索を実行しています。

検索結果の処理はUIスレッドで行うため、Invokeメソッドを使用してUIを更新しています。

これにより、アプリケーションの応答性が向上します。

コードの最適化

DirectorySearcherを使用する際のコードの最適化は、パフォーマンス向上に直結します。

ここでは、不要なオブジェクトの削除、メモリ管理の改善、エラーハンドリングの強化について詳しく解説します。

不要なオブジェクトの削除

不要なオブジェクトを削除することで、メモリの使用量を減らし、パフォーマンスを向上させることができます。

特に、検索結果を使用し終わった後は、適切にオブジェクトを解放することが重要です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        searcher.Filter = "(objectClass=user)";
        
        // 検索を実行
        using (SearchResultCollection results = searcher.FindAll())
        {
            // 結果の処理
        } // usingブロックを抜けると、resultsは自動的に解放される
    }
}

この例では、using文を使用してSearchResultCollectionオブジェクトを自動的に解放しています。

これにより、不要なオブジェクトがメモリに残ることを防ぎます。

メモリ管理の改善

メモリ管理を改善するためには、オブジェクトのスコープを適切に設定し、必要なときだけオブジェクトを生成することが重要です。

また、ガーベジコレクションを意識したコーディングを行うことも効果的です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void PerformSearch()
    {
        using (DirectorySearcher searcher = new DirectorySearcher())
        {
            searcher.Filter = "(objectClass=user)";
            using (SearchResultCollection results = searcher.FindAll())
            {
                // 結果の処理
            }
        } // すべてのオブジェクトが自動的に解放される
    }
}

この例では、DirectorySearcherオブジェクトもusing文で囲むことで、メモリ管理を徹底しています。

これにより、メモリリークを防ぎ、アプリケーションの安定性を向上させます。

エラーハンドリングの強化

エラーハンドリングを強化することで、予期しないエラーが発生した際の影響を最小限に抑えることができます。

特に、検索処理においては、例外処理を適切に行うことが重要です。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private void PerformSearch()
    {
        try
        {
            using (DirectorySearcher searcher = new DirectorySearcher())
            {
                searcher.Filter = "(objectClass=user)";
                using (SearchResultCollection results = searcher.FindAll())
                {
                    // 結果の処理
                }
            }
        }
        catch (DirectoryServicesCOMException ex)
        {
            // エラーメッセージを表示
            MessageBox.Show("検索中にエラーが発生しました: " + ex.Message);
        }
    }
}

この例では、try-catchブロックを使用してDirectoryServicesCOMExceptionをキャッチし、エラーメッセージを表示しています。

これにより、エラーが発生してもアプリケーションがクラッシュすることを防ぎ、ユーザーに適切なフィードバックを提供します。

応用例

DirectorySearcherを活用することで、さまざまな応用例が考えられます。

ここでは、大規模データベースでの検索、リアルタイム検索システムの構築、セキュリティ強化のための検索について詳しく解説します。

大規模データベースでの検索

大規模なActive Directory環境では、効率的な検索が求められます。

PageSizeやFilterプロパティを活用することで、必要なデータを迅速に取得できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        searcher.Filter = "(objectClass=user)";
        searcher.PageSize = 1000; // 1ページあたり1000件の結果を取得
        
        using (SearchResultCollection results = searcher.FindAll())
        {
            foreach (SearchResult result in results)
            {
                // 結果の処理
            }
        }
    }
}

この例では、ユーザーオブジェクトを対象にした検索を行い、ページングを利用して効率的にデータを取得しています。

これにより、大規模データベースでもスムーズに検索が可能です。

リアルタイム検索システムの構築

リアルタイムでの検索システムを構築する際には、非同期処理を活用することで、ユーザーインターフェースの応答性を保ちながら検索を行うことができます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
    }
    private async void SearchButton_Click(object sender, EventArgs e)
    {
        await Task.Run(() => PerformSearch());
    }
    private void PerformSearch()
    {
        using (DirectorySearcher searcher = new DirectorySearcher())
        {
            searcher.Filter = "(objectClass=user)";
            using (SearchResultCollection results = searcher.FindAll())
            {
                // 結果の処理(UIスレッドでの更新はInvokeを使用)
                this.Invoke((MethodInvoker)delegate {
                    // 結果をUIに表示する処理
                });
            }
        }
    }
}

この例では、ボタンをクリックすると非同期に検索を実行し、結果をUIに反映させています。

これにより、ユーザーは検索中もアプリケーションを操作できるため、快適な体験を提供できます。

セキュリティ強化のための検索

セキュリティ強化のために、特定の条件に基づいてユーザーやグループを検索することができます。

例えば、特定の権限を持つユーザーを検索することで、セキュリティポリシーの遵守を確認できます。

partial class MyForm : Form
{
    public MyForm()
    {
        InitializeComponent();
        
        DirectorySearcher searcher = new DirectorySearcher();
        searcher.Filter = "(&(objectClass=user)(memberOf=CN=AdminGroup,OU=Groups,DC=example,DC=com))"; // AdminGroupに属するユーザーを検索
        
        using (SearchResultCollection results = searcher.FindAll())
        {
            foreach (SearchResult result in results)
            {
                // 結果の処理
            }
        }
    }
}