MulticastDelegate クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
マルチキャスト デリゲートを表します。つまり、呼び出しリストに複数の要素を含めることができるデリゲートです。
public ref class MulticastDelegate abstract : Delegate
public abstract class MulticastDelegate : Delegate
[System.Serializable]
public abstract class MulticastDelegate : Delegate
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class MulticastDelegate : Delegate
type MulticastDelegate = class
inherit Delegate
[<System.Serializable>]
type MulticastDelegate = class
inherit Delegate
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type MulticastDelegate = class
inherit Delegate
Public MustInherit Class MulticastDelegate
Inherits Delegate
- 継承
- 属性
例
次の例では、文字列のコレクションを含むクラス StringContainer
を定義します。 そのメンバーの 1 つは CheckAndDisplayDelegate
デリゲートです。これは、特定の条件を満たす StringContainer
オブジェクトに格納されている文字列を表示するために使用されます。 デリゲートは、パラメーターとして 1 つの文字列を受け取り、void
を返します (または、Visual Basic では、Sub
プロシージャです)。 また、1 つのパラメーターである CheckAndDisplayDelegate
デリゲートを持つメソッド DisplayAllQualified
も含まれます。 これにより、メソッドを呼び出し、デリゲートに含まれるメソッドに基づいてフィルター処理された文字列のセットを表示できます。
この例では、次の 2 つのメソッドを持つユーティリティ クラス StringExtensions
も定義します。
ConStart
:子音で始まる文字列を表示します。VowelStart
母音で始まる文字列を表示します。
両方のメソッドに 1 つの文字列パラメーターが含まれており、void
返されることに注意してください。 つまり、両方のメソッドを CheckAndDisplayDelegate
デリゲートに割り当てることができます。
Test.Main
メソッドは、アプリケーションのエントリ ポイントです。
StringContainer
オブジェクトをインスタンス化し、文字列を設定し、1 つのメソッドを呼び出す 2 つの CheckAndDisplayDelegate
デリゲート (conStart
と vowelStart
) を作成します。 次に、Delegate.Combine メソッドを呼び出して multipleDelegates
デリゲートを作成します。このデリゲートには、最初は ConStart
と VowelStart
デリゲートが含まれています。
multipleDelegates
デリゲートが呼び出されると、コレクション内のすべての文字列が元の順序で表示されることに注意してください。 これは、各レターが各デリゲートに個別に渡され、各レターが 2 つのデリゲートのうちの 1 つのみフィルター条件を満たしているためです。 最後に、Delegate.Remove と Delegate.Combineの呼び出しの後、multipleDelegates
には 2 つの conStart
デリゲートが含まれます。 呼び出されると、StringContainer
オブジェクト内の各文字列が 2 回表示されます。
using namespace System;
using namespace System::Collections::Generic;
ref class StringContainer
{
private:
// A generic list object that holds the strings.
List<String^>^ container = gcnew List<String^>;
public:
// Define a delegate to handle string display.
delegate void CheckAndDisplayDelegate(String^ str);
// A method that adds more strings to the collection.
void AddString(String^ str)
{
container->Add(str);
}
// Iterate through the strings and invoke the method(s) that the delegate points to.
void DisplayAllQualified(CheckAndDisplayDelegate^ displayDelegate)
{
for each (String^ str in container)
displayDelegate(str);
// System::Collections::IEnumerator^ myEnum = container->GetEnumerator();
// while ( myEnum->MoveNext() )
// {
// String^ str = safe_cast<String^>(myEnum->Current);
// displayDelegate(str);
// }
}
};
//end of class StringContainer
// This class contains a few sample methods
ref class StringFuncs
{
public:
// This method prints a String* that it is passed if the String* starts with a vowel
static void ConStart(String^ str)
{
if ( !(str[ 0 ] == 'a' || str[ 0 ] == 'e' || str[ 0 ] == 'i' || str[ 0 ] == 'o' || str[ 0 ] == 'u') )
Console::WriteLine( str );
}
// This method prints a String* that it is passed if the String* starts with a consonant
static void VowelStart( String^ str )
{
if ( (str[ 0 ] == 'a' || str[ 0 ] == 'e' || str[ 0 ] == 'i' || str[ 0 ] == 'o' || str[ 0 ] == 'u') )
Console::WriteLine( str );
}
};
// This function demonstrates using Delegates, including using the Remove and
// Combine methods to create and modify delegate combinations.
int main()
{
// Declare the StringContainer class and add some strings
StringContainer^ container = gcnew StringContainer;
container->AddString( "This" );
container->AddString( "is" );
container->AddString( "a" );
container->AddString( "multicast" );
container->AddString( "delegate" );
container->AddString( "example" );
// RETURN HERE.
// Create two delegates individually using different methods
StringContainer::CheckAndDisplayDelegate^ conStart = gcnew StringContainer::CheckAndDisplayDelegate( StringFuncs::ConStart );
StringContainer::CheckAndDisplayDelegate^ vowelStart = gcnew StringContainer::CheckAndDisplayDelegate( StringFuncs::VowelStart );
// Get the list of all delegates assigned to this MulticastDelegate instance.
array<Delegate^>^ delegateList = conStart->GetInvocationList();
Console::WriteLine("conStart contains {0} delegate(s).", delegateList->Length);
delegateList = vowelStart->GetInvocationList();
Console::WriteLine("vowelStart contains {0} delegate(s).\n", delegateList->Length );
// Determine whether the delegates are System::Multicast delegates
if ( dynamic_cast<System::MulticastDelegate^>(conStart) && dynamic_cast<System::MulticastDelegate^>(vowelStart) )
{
Console::WriteLine("conStart and vowelStart are derived from MulticastDelegate.\n");
}
// Execute the two delegates.
Console::WriteLine("Executing the conStart delegate:" );
container->DisplayAllQualified(conStart);
Console::WriteLine();
Console::WriteLine("Executing the vowelStart delegate:" );
container->DisplayAllQualified(vowelStart);
// Create a new MulticastDelegate and call Combine to add two delegates.
StringContainer::CheckAndDisplayDelegate^ multipleDelegates =
dynamic_cast<StringContainer::CheckAndDisplayDelegate^>(Delegate::Combine(conStart, vowelStart));
// How many delegates does multipleDelegates contain?
delegateList = multipleDelegates->GetInvocationList();
Console::WriteLine("\nmultipleDelegates contains {0} delegates.\n",
delegateList->Length );
// // Pass this multicast delegate to DisplayAllQualified.
Console::WriteLine("Executing the multipleDelegate delegate.");
container->DisplayAllQualified(multipleDelegates);
// Call remove and combine to change the contained delegates.
multipleDelegates = dynamic_cast<StringContainer::CheckAndDisplayDelegate^>
(Delegate::Remove(multipleDelegates, vowelStart));
multipleDelegates = dynamic_cast<StringContainer::CheckAndDisplayDelegate^>
(Delegate::Combine(multipleDelegates, conStart));
// Pass multipleDelegates to DisplayAllQualified again.
Console::WriteLine("\nExecuting the multipleDelegate delegate with two conStart delegates:");
container->DisplayAllQualified(multipleDelegates);
}
// The example displays the following output:
// conStart contains 1 delegate(s).
// vowelStart contains 1 delegate(s).
//
// conStart and vowelStart are derived from MulticastDelegate.
//
// Executing the conStart delegate:
// This
// multicast
// delegate
//
// Executing the vowelStart delegate:
// is
// a
// example
//
//
// multipleDelegates contains 2 delegates.
//
// Executing the multipleDelegate delegate.
// This
// is
// a
// multicast
// delegate
// example
//
// Executing the multipleDelegate delegate with two conStart delegates:
// This
// This
// multicast
// multicast
// delegate
// delegate
using System;
using System.Collections.Generic;
class StringContainer
{
// Define a delegate to handle string display.
public delegate void CheckAndDisplayDelegate(string str);
// A generic list object that holds the strings.
private List<String> container = new List<String>();
// A method that adds strings to the collection.
public void AddString(string str)
{
container.Add(str);
}
// Iterate through the strings and invoke the method(s) that the delegate points to.
public void DisplayAllQualified(CheckAndDisplayDelegate displayDelegate)
{
foreach (var str in container) {
displayDelegate(str);
}
}
}
// This class defines some methods to display strings.
class StringExtensions
{
// Display a string if it starts with a consonant.
public static void ConStart(string str)
{
if (!(str[0]=='a'||str[0]=='e'||str[0]=='i'||str[0]=='o'||str[0]=='u'))
Console.WriteLine(str);
}
// Display a string if it starts with a vowel.
public static void VowelStart(string str)
{
if ((str[0]=='a'||str[0]=='e'||str[0]=='i'||str[0]=='o'||str[0]=='u'))
Console.WriteLine(str);
}
}
// Demonstrate the use of delegates, including the Remove and
// Combine methods to create and modify delegate combinations.
class Test
{
static public void Main()
{
// Declare the StringContainer class and add some strings
StringContainer container = new StringContainer();
container.AddString("This");
container.AddString("is");
container.AddString("a");
container.AddString("multicast");
container.AddString("delegate");
container.AddString("example");
// Create two delegates individually using different methods.
StringContainer.CheckAndDisplayDelegate conStart = StringExtensions.ConStart;
StringContainer.CheckAndDisplayDelegate vowelStart = StringExtensions.VowelStart;
// Get the list of all delegates assigned to this MulticastDelegate instance.
Delegate[] delegateList = conStart.GetInvocationList();
Console.WriteLine("conStart contains {0} delegate(s).", delegateList.Length);
delegateList = vowelStart.GetInvocationList();
Console.WriteLine("vowelStart contains {0} delegate(s).\n", delegateList.Length);
// Determine whether the delegates are System.Multicast delegates.
if (conStart is System.MulticastDelegate && vowelStart is System.MulticastDelegate)
Console.WriteLine("conStart and vowelStart are derived from MulticastDelegate.\n");
// Execute the two delegates.
Console.WriteLine("Executing the conStart delegate:");
container.DisplayAllQualified(conStart);
Console.WriteLine();
Console.WriteLine("Executing the vowelStart delegate:");
container.DisplayAllQualified(vowelStart);
Console.WriteLine();
// Create a new MulticastDelegate and call Combine to add two delegates.
StringContainer.CheckAndDisplayDelegate multipleDelegates =
(StringContainer.CheckAndDisplayDelegate) Delegate.Combine(conStart, vowelStart);
// How many delegates does multipleDelegates contain?
delegateList = multipleDelegates.GetInvocationList();
Console.WriteLine("\nmultipleDelegates contains {0} delegates.\n",
delegateList.Length);
// Pass this multicast delegate to DisplayAllQualified.
Console.WriteLine("Executing the multipleDelegate delegate.");
container.DisplayAllQualified(multipleDelegates);
// Call remove and combine to change the contained delegates.
multipleDelegates = (StringContainer.CheckAndDisplayDelegate) Delegate.Remove(multipleDelegates, vowelStart);
multipleDelegates = (StringContainer.CheckAndDisplayDelegate) Delegate.Combine(multipleDelegates, conStart);
// Pass multipleDelegates to DisplayAllQualified again.
Console.WriteLine("\nExecuting the multipleDelegate delegate with two conStart delegates:");
container.DisplayAllQualified(multipleDelegates);
}
}
// The example displays the following output:
// conStart contains 1 delegate(s).
// vowelStart contains 1 delegate(s).
//
// conStart and vowelStart are derived from MulticastDelegate.
//
// Executing the conStart delegate:
// This
// multicast
// delegate
//
// Executing the vowelStart delegate:
// is
// a
// example
//
//
// multipleDelegates contains 2 delegates.
//
// Executing the multipleDelegate delegate.
// This
// is
// a
// multicast
// delegate
// example
//
// Executing the multipleDelegate delegate with two conStart delegates:
// This
// This
// multicast
// multicast
// delegate
// delegate
module Test
open System
// Define a delegate to handle string display.
type CheckAndDisplayDelegate = delegate of string -> unit
type StringContainer() =
// A generic ResizeArray object that holds the strings.
let container = ResizeArray()
// A method that adds strings to the collection.
member _.AddString(str) =
container.Add str
// Iterate through the strings and invoke the method(s) that the delegate points to.
member _.DisplayAllQualified(displayDelegate: CheckAndDisplayDelegate) =
for str in container do
displayDelegate.Invoke str
// This module defines some functions to display strings.
module StringExtensions =
// Display a string if it starts with a consonant.
let conStart (str: string) =
match str[0] with
| 'a' | 'e' | 'i' | 'o' | 'u' -> ()
| _ -> printfn $"{str}"
// Display a string if it starts with a vowel.
let vowelStart (str: string) =
match str[0] with
| 'a' | 'e' | 'i' | 'o' | 'u' -> printfn $"{str}"
| _ -> ()
// Demonstrate the use of delegates, including the Remove and
// Combine methods to create and modify delegate combinations.
[<EntryPoint>]
let main _ =
// Declare the StringContainer class and add some strings
let container = StringContainer()
container.AddString "This"
container.AddString "is"
container.AddString "a"
container.AddString "multicast"
container.AddString "delegate"
container.AddString "example"
// Create two delegates individually using different methods.
let conStart = CheckAndDisplayDelegate StringExtensions.conStart
let vowelStart = CheckAndDisplayDelegate StringExtensions.vowelStart
// Get the list of all delegates assigned to this MulticastDelegate instance.
let delegateList = conStart.GetInvocationList()
printfn $"conStart contains {delegateList.Length} delegate(s)."
let delegateList = vowelStart.GetInvocationList()
printfn $"vowelStart contains {delegateList.Length} delegate(s).\n"
// Determine whether the delegates are System.Multicast delegates.
if box conStart :? System.MulticastDelegate && box vowelStart :? System.MulticastDelegate then
printfn "conStart and vowelStart are derived from MulticastDelegate.\n"
// Execute the two delegates.
printfn "Executing the conStart delegate:"
container.DisplayAllQualified conStart
printfn "\nExecuting the vowelStart delegate:"
container.DisplayAllQualified vowelStart
printfn ""
// Create a new MulticastDelegate and call Combine to add two delegates.
let multipleDelegates =
Delegate.Combine(conStart, vowelStart) :?> CheckAndDisplayDelegate
// How many delegates does multipleDelegates contain?
let delegateList = multipleDelegates.GetInvocationList()
printfn $"\nmultipleDelegates contains {delegateList.Length} delegates.\n"
// Pass this multicast delegate to DisplayAllQualified.
printfn "Executing the multipleDelegate delegate."
container.DisplayAllQualified multipleDelegates
// Call remove and combine to change the contained delegates.
let multipleDelegates = Delegate.Remove(multipleDelegates, vowelStart) :?> CheckAndDisplayDelegate
let multipleDelegates = Delegate.Combine(multipleDelegates, conStart) :?> CheckAndDisplayDelegate
// Pass multipleDelegates to DisplayAllQualified again.
printfn "\nExecuting the multipleDelegate delegate with two conStart delegates:"
printfn $"{multipleDelegates}"
0
// The example displays the following output:
// conStart contains 1 delegate(s).
// vowelStart contains 1 delegate(s).
//
// conStart and vowelStart are derived from MulticastDelegate.
//
// Executing the conStart delegate:
// This
// multicast
// delegate
//
// Executing the vowelStart delegate:
// is
// a
// example
//
//
// multipleDelegates contains 2 delegates.
//
// Executing the multipleDelegate delegate.
// This
// is
// a
// multicast
// delegate
// example
//
// Executing the multipleDelegate delegate with two conStart delegates:
// This
// This
// multicast
// multicast
// delegate
// delegate
Imports System.Collections.Generic
Class StringContainer
' Define a delegate to handle string display.
Delegate Sub CheckAndPrintDelegate(ByVal str As String)
' A generic list object that holds the strings.
Private container As New List(Of String)()
' A method that adds strings to the collection.
Public Sub AddString(ByVal s As String)
container.Add(s)
End Sub
' Iterate through the strings and invoke the method(s) that the delegate points to.
Public Sub DisplayAllQualified(ByVal displayDelegate As CheckAndPrintDelegate)
For Each s In container
displayDelegate(s)
Next
End Sub
End Class
' This class defines some methods to display strings.
Class StringExtensions
' Display a string if it starts with a consonant.
Public Shared Sub ConStart(ByVal str As String)
If Not (str.Chars(0) = "a"c Or str.Chars(0) = "e"c Or str.Chars(0) = "i"c _
Or str.Chars(0) = "o"c Or str.Chars(0) = "u"c) Then
Console.WriteLine(str)
End If
End Sub
' Display a string if it starts with a vowel.
Public Shared Sub VowelStart(ByVal str As String)
If (str.Chars(0) = "a"c Or str.Chars(0) = "e"c Or str.Chars(0) = "i"c _
Or str.Chars(0) = "o"c Or str.Chars(0) = "u"c) Then
Console.WriteLine(str)
End If
End Sub
End Class
' Demonstrate the use of delegates, including the Remove and
' Combine methods to create and modify delegate combinations.
Class Test
Public Shared Sub Main()
' Declare the StringContainer class and add some strings
Dim container As New StringContainer()
container.AddString("this")
container.AddString("is")
container.AddString("a")
container.AddString("multicast")
container.AddString("delegate")
container.AddString("example")
' Create two delegates individually using different methods.
Dim constart As StringContainer.CheckAndPrintDelegate = AddressOf StringExtensions.ConStart
Dim vowelStart As StringContainer.CheckAndPrintDelegate = AddressOf StringExtensions.VowelStart
' Get the list of all delegates assigned to this MulticastDelegate instance.
Dim delegateList() As [Delegate] = conStart.GetInvocationList()
Console.WriteLine("conStart contains {0} delegate(s).", delegateList.Length)
delegateList = vowelStart.GetInvocationList()
Console.WriteLine("vowelStart contains {0} delegate(s).", delegateList.Length)
Console.WriteLine()
' Determine whether the delegates are System.Multicast delegates
If TypeOf conStart Is System.MulticastDelegate And TypeOf vowelStart Is System.MulticastDelegate Then
Console.WriteLine("conStart and vowelStart are derived from MulticastDelegate.")
Console.WriteLine()
End If
' Run the two single delegates one after the other.
Console.WriteLine("Executing the conStart delegate:")
container.DisplayAllQualified(conStart)
Console.WriteLine("Executing the vowelStart delegate:")
container.DisplayAllQualified(vowelStart)
Console.WriteLine()
' Create a new MulticastDelegate and call Combine to add two delegates.
Dim multipleDelegates As StringContainer.CheckAndPrintDelegate =
CType([Delegate].Combine(conStart, vowelStart),
StringContainer.CheckAndPrintDelegate)
' How many delegates does multipleDelegates contain?
delegateList = multipleDelegates.GetInvocationList()
Console.WriteLine("{1}multipleDelegates contains {0} delegates.{1}",
delegateList.Length, vbCrLf)
' Pass this mulitcast delegate to DisplayAllQualified.
Console.WriteLine("Executing the multipleDelegate delegate.")
container.DisplayAllQualified(multipleDelegates)
' Call remove and combine to change the contained delegates.
multipleDelegates = CType([Delegate].Remove(multipleDelegates, vowelStart),
StringContainer.CheckAndPrintDelegate)
multipleDelegates = CType([Delegate].Combine(multipleDelegates, conStart),
StringContainer.CheckAndPrintDelegate)
' Pass multipleDelegates to DisplayAllQualified again.
Console.WriteLine()
Console.WriteLine("Executing the multipleDelegate delegate with two conStart delegates:")
container.DisplayAllQualified(multipleDelegates)
End Sub
End Class
' The example displays the following output:
' conStart contains 1 delegate(s).
' vowelStart contains 1 delegate(s).
'
' conStart and vowelStart are derived from MulticastDelegate.
'
' Executing the conStart delegate:
' This
' multicast
' delegate
'
' Executing the vowelStart delegate:
' is
' a
' example
'
'
' multipleDelegates contains 2 delegates.
'
' Executing the multipleDelegate delegate.
' This
' is
' a
' multicast
' delegate
' example
'
' Executing the multipleDelegate delegate with two conStart delegates:
' This
' This
' multicast
' multicast
' delegate
' delegate
注釈
MulticastDelegate は特別なクラスです。 コンパイラやその他のツールは、このクラスから派生できますが、明示的に派生することはできません。 同じことが、Delegate クラスにも当てはまります。
型をデリゲートするメソッドが MulticastDelegateから継承されるだけでなく、共通言語ランタイムには、BeginInvoke
と EndInvoke
の 2 つの特別なメソッドが用意されています。 これらのメソッドの詳細については、「同期メソッドの非同期呼び出し」を参照してください。
MulticastDelegate には、1 つ以上の要素で構成される呼び出しリストと呼ばれるデリゲートのリンク されたリストがあります。 マルチキャスト デリゲートが呼び出されると、呼び出しリスト内のデリゲートは、表示される順序で同期的に呼び出されます。 リストの実行中にエラーが発生した場合は、例外がスローされます。
コンストラクター
MulticastDelegate(Object, String) |
MulticastDelegate クラスの新しいインスタンスを初期化します。 |
MulticastDelegate(Type, String) |
MulticastDelegate クラスの新しいインスタンスを初期化します。 |
プロパティ
HasSingleTarget |
Delegate に単一の呼び出しターゲットがあるかどうかを示す値を取得します。 (継承元 Delegate) |
Method |
デリゲートによって表されるメソッドを取得します。 (継承元 Delegate) |
Target |
現在のデリゲートがインスタンス メソッドを呼び出すクラス インスタンスを取得します。 (継承元 Delegate) |
メソッド
Clone() |
デリゲートの簡易コピーを作成します。 (継承元 Delegate) |
CombineImpl(Delegate) | |
CombineImpl(Delegate) |
指定されたマルチキャスト (結合可能) デリゲートと現在のマルチキャスト (結合可能) デリゲートの呼び出しリストを連結します。 (継承元 Delegate) |
DynamicInvoke(Object[]) |
現在のデリゲートによって表されるメソッドを動的に呼び出します (遅延バインド)。 (継承元 Delegate) |
DynamicInvokeImpl(Object[]) |
完全な呼び出しリストを処理します。 |
DynamicInvokeImpl(Object[]) |
現在のデリゲートによって表されるメソッドを動的に呼び出します (遅延バインド)。 (継承元 Delegate) |
Equals(Object) |
このマルチキャスト デリゲートと指定したオブジェクトが等しいかどうかを判断します。 |
GetHashCode() |
このインスタンスのハッシュ コードを返します。 |
GetInvocationList() |
このマルチキャスト デリゲートの呼び出しリストを呼び出し順に返します。 |
GetMethodImpl() |
現在の MulticastDelegateで表されるメソッドを返します。 |
GetMethodImpl() |
現在のデリゲートによって表されるメソッドを取得します。 (継承元 Delegate) |
GetObjectData(SerializationInfo, StreamingContext) |
古い.
SerializationInfo オブジェクトに、このインスタンスをシリアル化するために必要なすべてのデータを設定します。 |
GetObjectData(SerializationInfo, StreamingContext) |
古い.
サポートされていません。 (継承元 Delegate) |
GetType() |
現在のインスタンスの Type を取得します。 (継承元 Object) |
MemberwiseClone() |
現在の Objectの簡易コピーを作成します。 (継承元 Object) |
RemoveImpl(Delegate) |
この MulticastDelegate の呼び出しリストから、指定したデリゲートと等しい要素を削除します。 |
RemoveImpl(Delegate) |
別のデリゲートの呼び出しリストからデリゲートの呼び出しリストを削除します。 (継承元 Delegate) |
ToString() |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
演算子
Equality(MulticastDelegate, MulticastDelegate) |
2 つの MulticastDelegate オブジェクトが等しいかどうかを判断します。 |
Inequality(MulticastDelegate, MulticastDelegate) |
2 つの MulticastDelegate オブジェクトが等しくないかどうかを判断します。 |
拡張メソッド
GetMethodInfo(Delegate) |
指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。 |
適用対象
.NET