Action<T> Delegate

来源：https://docs.microsoft.com/zh-cn/dotnet/api/system.action-1?view=netframework-4.7.2

Action<T> Delegate

定义

命名空间:

System

Assemblies:

System.Runtime.dll, mscorlib.dll, netstandard.dll

封装一个方法，该方法只有一个参数并且不返回值。

C#复制

public delegate void Action<in T>(T obj);

类型参数

T

此委托封装的方法的参数类型。

参数

obj

此委托封装的方法的参数。

继承

Object

Delegate

Action<T>

示例

下面的示例演示如何将Action<T>要打印的内容委托List<T>对象。 在此示例中，Print方法用于向控制台显示列表的内容。 此外，C# 示例还演示如何使用匿名方法来将内容显示到控制台。 请注意，该示例不显式声明Action<T>变量。 相反，它将传递到方法采用单个参数和与未返回到的值的引用List<T>.ForEach方法，其单个参数是Action<T>委托。 同样，在 C# 示例中，Action<T>委托不显式实例化，因为匿名方法的签名匹配的签名Action<T>委托所需的List<T>.ForEach方法。

C#复制

using System;
using System.Collections.Generic;

class Program
{
    static void Main()
    {
        List<String> names = new List<String>();
        names.Add("Bruce");
        names.Add("Alfred");
        names.Add("Tim");
        names.Add("Richard");

        // Display the contents of the list using the Print method.
        names.ForEach(Print);

        // The following demonstrates the anonymous method feature of C#
        // to display the contents of the list to the console.
        names.ForEach(delegate(String name)
        {
            Console.WriteLine(name);
        });
    }

    private static void Print(string s)
    {
        Console.WriteLine(s);
    }
}
/* This code will produce output similar to the following:
 * Bruce
 * Alfred
 * Tim
 * Richard
 * Bruce
 * Alfred
 * Tim
 * Richard
 */

注解

可以使用Action<T>委托作为参数传递方法，而无需显式声明自定义委托。 封装的方法必须对应于此委托定义的方法签名。 这意味着，封装的方法必须具有按值传递给它的一个参数，并且不能返回值。 (在 C# 中，该方法必须返回void。 在 Visual Basic 中，它必须由定义Sub...End Sub 构造。 它也可以是返回一个值，则忽略该值的方法。）通常情况下，这种方法用于执行操作。

 备注

若要引用的方法，具有一个参数并返回一个值，请使用泛型Func<T,TResult>改为委托。

当你使用Action<T>委托时，您无需显式定义用于封装具有单个参数的方法的委托。 例如，下面的代码显式声明名为的委托DisplayMessage，并将分配到的引用WriteLine方法或ShowWindowsMessage给其委托实例的方法。

C#复制

using System;
using System.Windows.Forms;

delegate void DisplayMessage(string message);

public class TestCustomDelegate
{
   public static void Main()
   {
      DisplayMessage messageTarget; 
      
      if (Environment.GetCommandLineArgs().Length > 1)
         messageTarget = ShowWindowsMessage;
      else
         messageTarget = Console.WriteLine;
      
      messageTarget("Hello, World!");   
   }      
      
   private static void ShowWindowsMessage(string message)
   {
      MessageBox.Show(message);      
   }
}

下面的示例简化了此代码实例化Action<T>而不是显式定义一个新委托，并为其赋值命名的方法的委托。

C#复制

using System;
using System.Windows.Forms;

public class TestAction1
{
   public static void Main()
   {
      Action<string> messageTarget; 
      
      if (Environment.GetCommandLineArgs().Length > 1)
         messageTarget = ShowWindowsMessage;
      else
         messageTarget = Console.WriteLine;
      
      messageTarget("Hello, World!");   
   }      
      
   private static void ShowWindowsMessage(string message)
   {
      MessageBox.Show(message);      
   }
}

此外可以使用Action<T>委托与匿名方法在 C# 中，如以下示例所示。 (有关匿名方法的介绍，请参阅匿名方法。)

C#复制

using System;
using System.Windows.Forms;

public class TestAnonMethod
{
   public static void Main()
   {
      Action<string> messageTarget; 
      
      if (Environment.GetCommandLineArgs().Length > 1)
         messageTarget = delegate(string s) { ShowWindowsMessage(s); };
      else
         messageTarget = delegate(string s) { Console.WriteLine(s); };
      
      messageTarget("Hello, World!");
   }
      
   private static void ShowWindowsMessage(string message)
   {
      MessageBox.Show(message);      
   }
}

你还可以分配一个 lambda 表达式到Action<T>委托实例，如以下示例所示。 (有关 lambda 表达式的简介，请参阅Lambda 表达式。)

C#复制

using System;
using System.Windows.Forms;

public class TestLambdaExpression
{
   public static void Main()
   {
      Action<string> messageTarget; 
      
      if (Environment.GetCommandLineArgs().Length > 1)
         messageTarget = s => ShowWindowsMessage(s); 
      else
         messageTarget = s => Console.WriteLine(s);
      
      messageTarget("Hello, World!");
   }
      
   private static void ShowWindowsMessage(string message)
   {
      MessageBox.Show(message);      
   }
}

ForEach并ForEach每个方法均采用Action<T>委托作为参数。 由委托封装的方法，可对数组或列表中的每个元素执行操作。 该示例使用ForEach方法来提供演示。

适用于

.NET Core

2.1 2.0 1.1 1.0

.NET Framework

4.7.2 4.7.1 4.7 4.6.2 4.6.1 4.6 4.5.2 4.5.1 4.5 4.0 3.5 3.0 2.0

.NET Standard

2.0 1.6 1.5 1.4 1.3 1.2 1.1 1.0

Xamarin.Android

7.1

Xamarin.iOS

10.8

Xamarin.Mac

3.0

另请参阅

• Func<T,TResult>