System.Action 委托

方法描述

封装一个方法,该方法具有两个参数并且不返回值。

语法定义(C# System.Action 委托 的用法)

public delegate void Action(
	T1 arg1,
	T2 arg2
)

构造函数

构造函数名称 构造函数描述

成员/方法

方法名称 方法描述

提示和注释

可以使用 Action 委托以参数形式传递方法,而不用显式声明自定义的委托。 封装的方法必须与此委托定义的方法签名相对应。 也就是说,封装的方法必须具有两个均通过值传递给它的参数,并且不能返回值。 (在 C# 中,该方法必须返回 void。 在 Visual Basic 中,必须通过 Sub…End Sub 结构来定义它。 它也可以是返回已忽略的值的方法。)通常,这种方法用于执行某个操作。

注意

若要引用具有两个参数并返回值的方法,请改用泛型 Func 委托。

在使用 Action 委托时,不必显式定义一个封装具有两个参数的方法的委托。 例如,以下代码显式声明了一个名为 ConcatStrings 的委托。 然后,它将对两个方法中的任何一个方法的引用分配给其委托实例。 其中一个方法将两个字符串写入控制台;另一个方法将两个字符串写入文件。

C#

VB

复制

using System;

using System.IO;

delegate void ConcatStrings(string string1, string string2);

public class TestDelegate

{

public static void Main()

{

string message1 = "The first line of a message.";

string message2 = "The second line of a message.";

ConcatStrings concat;

if (Environment.GetCommandLineArgs().Length > 1)

concat = WriteToFile;

else

concat = WriteToConsole;

concat(message1, message2);

}

private static void WriteToConsole(string string1, string string2)

{

Console.WriteLine("{0}\n{1}", string1, string2);

}

private static void WriteToFile(string string1, string string2)

{

StreamWriter writer = null;

try

{

writer = new StreamWriter(Environment.GetCommandLineArgs()[1], false);

writer.WriteLine("{0}\n{1}", string1, string2);

}

catch

{

Console.WriteLine("File write operation failed...");

}

finally

{

if (writer != null) writer.Close();

}

}

}

以下示例简化了此代码,它所用的方法是实例化 Action 委托,而不是显式定义一个新委托并将命名方法分配给该委托。

C#

VB

复制

using System;

using System.IO;

public class TestAction2

{

public static void Main()

{

string message1 = "The first line of a message.";

string message2 = "The second line of a message.";

Action concat;

if (Environment.GetCommandLineArgs().Length > 1)

concat = WriteToFile;

else

concat = WriteToConsole;

concat(message1, message2);

}

private static void WriteToConsole(string string1, string string2)

{

Console.WriteLine("{0}\n{1}", string1, string2);

}

private static void WriteToFile(string string1, string string2)

{

StreamWriter writer = null;

try

{

writer = new StreamWriter(Environment.GetCommandLineArgs()[1], false);

writer.WriteLine("{0}\n{1}", string1, string2);

}

catch

{

Console.WriteLine("File write operation failed...");

}

finally

{

if (writer != null) writer.Close();

}

}

}

您也可以按照以下示例所演示的那样在 C# 中将 Action 委托与匿名方法一起使用。 (有关匿名方法的简介,请参见匿名方法(C# 编程指南)。)

C#

复制

using System;

using System.IO;

public class TestAnonymousMethod

{

public static void Main()

{

string message1 = "The first line of a message.";

string message2 = "The second line of a message.";

Action concat;

if (Environment.GetCommandLineArgs().Length > 1)

concat = delegate(string s1, string s2) { WriteToFile(s1, s2); };

else

concat = delegate(string s1, string s2) { WriteToConsole(s1, s2);} ;

concat(message1, message2);

}

private static void WriteToConsole(string string1, string string2)

{

Console.WriteLine("{0}\n{1}", string1, string2);

}

private static void WriteToFile(string string1, string string2)

{

StreamWriter writer = null;

try

{

writer = new StreamWriter(Environment.GetCommandLineArgs()[1], false);

writer.WriteLine("{0}\n{1}", string1, string2);

}

catch

{

Console.WriteLine("File write operation failed...");

}

finally

{

if (writer != null) writer.Close();

}

}

}

您也可以按照以下示例所演示的那样将 lambda 表达式分配给 Action 委托实例。 (有关 lambda 表达式的简介,请参见 Lambda 表达式(C# 编程指南)。)

C#

VB

复制

using System;

using System.IO;

public class TestLambdaExpression

{

public static void Main()

{

string message1 = "The first line of a message.";

string message2 = "The second line of a message.";

Action concat;

if (Environment.GetCommandLineArgs().Length > 1)

concat = (s1, s2) => WriteToFile(s1, s2);

else

concat = (s1, s2) => WriteToConsole(s1, s2);

concat(message1, message2);

}

private static void WriteToConsole(string string1, string string2)

{

Console.WriteLine("{0}\n{1}", string1, string2);

}

private static void WriteToFile(string string1, string string2)

{

StreamWriter writer = null;

try

{

writer = new StreamWriter(Environment.GetCommandLineArgs()[1], false);

writer.WriteLine("{0}\n{1}", string1, string2);

}

catch

{

Console.WriteLine("File write operation failed...");

}

finally

{

if (writer != null) writer.Close();

}

}

}

System.Action 委托例子


继承层次结构

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

线程安全

版本信息

.NET Framework 受以下版本支持:4、3.5 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。