方法:宣言、インスタンス化、および使用依頼(C#プログラミングガイド)

8389 ワード

依頼の声明は次のとおりです.
C#
 
public delegate void Del<T>(T item);
public void Notify(int i) { }


C#
 
Del<int> d1 = new Del<int>(Notify);


C#2.0では、依頼を宣言するために、次の簡略化された構文を使用することもできます.
C#
 
Del<int> d2 = Notify;


次の例では、宣言、インスタンス化、および使用依頼について説明します.BookDB クラスは書店データベースをカプセル化し、書籍データベースを維持します.公開されています ProcessPaperbackBooks メソッド.データベース内のすべてのフラット・ブックを検索し、各フラット・ブックに対して依頼を呼び出します.使用する delegate タイプは ProcessBookDelegate.Test クラスはこのクラスを使用して平装書の本名と平均価格を出力します.
依頼の使用は、書店データベースと顧客コードの機能の良好な分離を促進します.お客様のコードは、書籍の保存方法と書店コードが平装書を検索する方法を知らない.書店のコードも平装書を見つけて平装書をどう処理するか分からない.

C#
 
// 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 ProcessBookDelegate(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(ProcessBookDelegate 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 TestBookDB
    {
        // Print the title of the book.
        static void PrintTitle(Book b)
        {
            System.Console.WriteLine("   {0}", 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:
            System.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);

            System.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);
        }
    }
}


しゅつりょく
Paperback Book Titles:
   The C Programming Language
   The Unicode Standard 2.0
   Dogbert's Clues for the Clueless
Average Paperback Book Price: $23.97

信頼性の高いプログラミング
  • 依頼を宣言します.次の文:
    C#
     
    public delegate void ProcessBookDelegate(Book book);
    
    

    新しい委任タイプを宣言します.各委任タイプには、パラメータの数とタイプ、およびカプセル化可能なメソッドの戻り値タイプが記述されます.新しいパラメータタイプまたは新しい戻り値タイプのセットが必要になるたびに、新しい委任タイプを宣言する必要があります.
  • インスタンス化依頼.委任タイプが宣言されたら、委任オブジェクトを作成し、特定のメソッドに関連付ける必要があります.上記の例では、 PrintTitle メソッドの伝達 ProcessPaperbackBooks 以下に示すように、メソッドが完了します.
    C#
     
    bookDB.ProcessPaperbackBooks(PrintTitle);
    
    

    これにより、静的メソッドが作成されます. Test.PrintTitle 関連する新しい委任オブジェクト.オブジェクト totaller の非静的方法 AddBookToTotal 次のように伝えられます.
    C#
     
    bookDB.ProcessPaperbackBooks(totaller.AddBookToTotal);
    
    

    両方の例では、 ProcessPaperbackBooks メソッドは新しい委任オブジェクトを渡します.依頼が作成されると、その関連方法は変更できません.委任先は可変ではありません.
  • 依頼を呼び出します.委任オブジェクトを作成すると、通常、委任オブジェクトは、その委任を呼び出す他のコードに渡されます.委任オブジェクトは、委任に渡すパラメータに従って括弧で囲まれた委任オブジェクトの名前で呼び出されます.次に、委任呼び出しの例を示します.
    C#
     
    processBook(b);
    
    

    本例と同様に、 BeginInvoke および EndInvoke メソッド同期または非同期呼び出し依頼.