デリゲートを宣言し、インスタンス化して使用する方法 (C# プログラミングガイド)

[アーティクル]
04/07/2023

デリゲートは、次のいずれかのメソッドを使用して宣言できます。

デリゲート型を宣言し、一致するシグネチャを持つメソッドを宣言する

// Declare a delegate.
delegate void NotifyCallback(string str);

// Declare a method with the same signature as the delegate.
static void Notify(string name)
{
    Console.WriteLine($"Notification received for: {name}");
}

// Create an instance of the delegate.
NotifyCallback del1 = new NotifyCallback(Notify);

メソッドグループをデリゲート型に割り当てる

// C# 2.0 provides a simpler way to declare an instance of NotifyCallback.
NotifyCallback del2 = Notify;

匿名メソッドを宣言する

// Instantiate NotifyCallback by using an anonymous method.
NotifyCallback del3 = delegate(string name)
    { Console.WriteLine($"Notification received for: {name}"); };

ラムダ式を使用する

// Instantiate NotifyCallback by using a lambda expression.
NotifyCallback del4 = name =>  { Console.WriteLine($"Notification received for: {name}"); };

詳細については、「ラムダ式」を参照してください。

次の例で、デリゲートの宣言、インスタンス化、および使用の方法について説明します。 BookDB クラスにより、書籍のデータベースを保持する書店データベースをカプセル化します。これは、データベース内にあるすべてのペーパーバックを検索し、各ペーパーバックに対してデリゲートを呼び出す ProcessPaperbackBooks メソッドを公開します。使用する delegate 型には ProcessBookCallback という名前を付けます。 Test クラスでは、このクラスを使用してペーパーバックのタイトルと平均価格を出力します。

デリゲートを使用することで、書店データベースとクライアントコードの機能を適切に分離しやすくなります。クライアントコードからは、書籍の格納方法や書店コードでのペーパーバックの検索方法はわかりません。書店コードからは、検索後にペーパーバックに対して行われる処理はわかりません。

例

// A set of classes for handling a bookstore:
namespace Bookstore
{
    using System.Collections;

    // Describes a book in the book list:
    public struct Book
    {
        public string Title;        // Title of the book.
        public string Author;       // Author of the book.
        public decimal Price;       // Price of the book.
        public bool Paperback;      // Is it paperback?

        public Book(string title, string author, decimal price, bool paperBack)
        {
            Title = title;
            Author = author;
            Price = price;
            Paperback = paperBack;
        }
    }

    // Declare a delegate type for processing a book:
    public delegate void ProcessBookCallback(Book book);

    // Maintains a book database.
    public class BookDB
    {
        // List of all books in the database:
        ArrayList list = new ArrayList();

        // Add a book to the database:
        public void AddBook(string title, string author, decimal price, bool paperBack)
        {
            list.Add(new Book(title, author, price, paperBack));
        }

        // Call a passed-in delegate on each paperback book to process it:
        public void ProcessPaperbackBooks(ProcessBookCallback processBook)
        {
            foreach (Book b in list)
            {
                if (b.Paperback)
                    // Calling the delegate:
                    processBook(b);
            }
        }
    }
}

// Using the Bookstore classes:
namespace BookTestClient
{
    using Bookstore;

    // Class to total and average prices of books:
    class PriceTotaller
    {
        int countBooks = 0;
        decimal priceBooks = 0.0m;

        internal void AddBookToTotal(Book book)
        {
            countBooks += 1;
            priceBooks += book.Price;
        }

        internal decimal AveragePrice()
        {
            return priceBooks / countBooks;
        }
    }

    // Class to test the book database:
    class Test
    {
        // Print the title of the book.
        static void PrintTitle(Book b)
        {
            Console.WriteLine($"   {b.Title}");
        }

        // Execution starts here.
        static void Main()
        {
            BookDB bookDB = new BookDB();

            // Initialize the database with some books:
            AddBooks(bookDB);

            // Print all the titles of paperbacks:
            Console.WriteLine("Paperback Book Titles:");

            // Create a new delegate object associated with the static
            // method Test.PrintTitle:
            bookDB.ProcessPaperbackBooks(PrintTitle);

            // Get the average price of a paperback by using
            // a PriceTotaller object:
            PriceTotaller totaller = new PriceTotaller();

            // Create a new delegate object associated with the nonstatic
            // method AddBookToTotal on the object totaller:
            bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal);

            Console.WriteLine("Average Paperback Book Price: ${0:#.##}",
                    totaller.AveragePrice());
        }

        // Initialize the book database with some test books:
        static void AddBooks(BookDB bookDB)
        {
            bookDB.AddBook("The C Programming Language", "Brian W. Kernighan and Dennis M. Ritchie", 19.95m, true);
            bookDB.AddBook("The Unicode Standard 2.0", "The Unicode Consortium", 39.95m, true);
            bookDB.AddBook("The MS-DOS Encyclopedia", "Ray Duncan", 129.95m, false);
            bookDB.AddBook("Dogbert's Clues for the Clueless", "Scott Adams", 12.00m, true);
        }
    }
}
/* Output:
Paperback Book Titles:
   The C Programming Language
   The Unicode Standard 2.0
   Dogbert's Clues for the Clueless
Average Paperback Book Price: $23.97
*/

信頼性の高いプログラミング

デリゲートを宣言する。

次のステートメントで、新しいデリゲート型を宣言します。
```
public delegate void ProcessBookCallback(Book book);
```
各デリゲート型は、引数の数と型、およびデリゲートでカプセル化可能なメソッドの戻り値の型を示します。引数型または戻り値型のセットが新しく必要になった場合は、常に新しいデリゲート型を宣言する必要があります。
デリゲートをインスタンス化する。

デリゲート型の宣言後、デリゲートオブジェクトを作成して特定のメソッドに関連付ける必要があります。先の例では、次の例に示すように PrintTitle メソッドを ProcessPaperbackBooks メソッドに渡すことでこの操作を行っています。
```
bookDB.ProcessPaperbackBooks(PrintTitle);
```
これにより、静的メソッド Test.PrintTitle に関連付けられた新しいデリゲートオブジェクトが作成されます。同様に、次の例で示すようにオブジェクト totaller の非静的メソッド AddBookToTotal も渡しています。
```
bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal);
```
どちらの場合でも、新しいデリゲートオブジェクトが ProcessPaperbackBooks メソッドに渡されます。

デリゲートオブジェクトは不変であるため、関連付けられているメソッドを、デリゲートの作成後に変更することはできません。
デリゲートを呼び出す。

デリゲートオブジェクトを作成したら、通常は、そのデリゲートを呼び出す別のコードにデリゲートオブジェクトを渡します。デリゲートオブジェクトを呼び出すときには、デリゲートに渡す引数を、デリゲートオブジェクト名の後ろにかっこで囲んで付けます。デリゲートの呼び出しの例を次に示します。
```
processBook(b);
```
デリゲートは、この例に示すように同期的に呼び出すことも、BeginInvoke メソッドおよび EndInvoke メソッドを使用して非同期的に呼び出すこともできます。

デリゲートを宣言し、インスタンス化して使用する方法 (C# プログラミングガイド)

例

信頼性の高いプログラミング

関連項目

フィードバック

その他のリソース

デリゲートを宣言し、インスタンス化して使用する方法 (C# プログラミング ガイド)

例

信頼性の高いプログラミング

関連項目

フィードバック

その他のリソース

デリゲートを宣言し、インスタンス化して使用する方法 (C# プログラミングガイド)