Action Delegar

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Encapsula um método que não tem parâmetros e não retorna um valor.

C#

public delegate void Action();

Comentários

Você pode usar esse delegado para passar um método como um parâmetro sem declarar explicitamente um delegado personalizado. O método encapsulado deve corresponder à assinatura do método definida por esse delegado. Isso significa que o método encapsulado não deve ter parâmetros e nenhum valor retornado. (Em C#, o método deve retornar void. Em F#, a função ou o método deve retornar unit. No Visual Basic, ele deve ser definido pelo Subconstructo ...End Sub . Ele também pode ser um método que retorna um valor que é ignorado.) Normalmente, esse método é usado para executar uma operação.

Observação

Para fazer referência a um método que não tem parâmetros e retorna um valor, use o delegado genérico Func<TResult> .

Ao usar o Action delegado, você não precisa definir explicitamente um delegado que encapsula um procedimento sem parâmetros. Por exemplo, o código a seguir declara explicitamente um delegado chamado ShowValue e atribui uma referência ao Name.DisplayToWindow método de instância à sua instância delegada.

C#

using System;
using System.Windows.Forms;

public delegate void ShowValue();

public class Name
{
   private string instanceName;

   public Name(string name)
   {
      this.instanceName = name;
   }

   public void DisplayToConsole()
   {
      Console.WriteLine(this.instanceName);
   }

   public void DisplayToWindow()
   {
      MessageBox.Show(this.instanceName);
   }
}

public class testTestDelegate
{
   public static void Main()
   {
      Name testName = new Name("Koani");
      ShowValue showMethod = testName.DisplayToWindow;
      showMethod();
   }
}

O exemplo a seguir simplifica esse código instanciando o Action delegado em vez de definir explicitamente um novo delegado e atribuir um método nomeado a ele.

C#

using System;
using System.Windows.Forms;

public class Name
{
   private string instanceName;

   public Name(string name)
   {
      this.instanceName = name;
   }

   public void DisplayToConsole()
   {
      Console.WriteLine(this.instanceName);
   }

   public void DisplayToWindow()
   {
      MessageBox.Show(this.instanceName);
   }
}

public class testTestDelegate
{
   public static void Main()
   {
      Name testName = new Name("Koani");
      Action showMethod = testName.DisplayToWindow;
      showMethod();
   }
}

Você também pode usar o Action delegado com métodos anônimos em C#, como ilustra o exemplo a seguir. (Para obter uma introdução aos métodos anônimos, consulte Métodos anônimos.)

C#

using System;
using System.Windows.Forms;

public class Name
{
   private string instanceName;

   public Name(string name)
   {
      this.instanceName = name;
   }

   public void DisplayToConsole()
   {
      Console.WriteLine(this.instanceName);
   }

   public void DisplayToWindow()
   {
      MessageBox.Show(this.instanceName);
   }
}

public class Anonymous
{
   public static void Main()
   {
      Name testName = new Name("Koani");
      Action showMethod = delegate() { testName.DisplayToWindow();} ;
      showMethod();
   }
}

Você também pode atribuir uma expressão lambda a uma Action instância de delegado, como ilustra o exemplo a seguir. (Para obter uma introdução às expressões lambda, consulte Expressões Lambda (C#) ou Expressões Lambda (F#).)

C#

using System;
using System.Windows.Forms;

public class Name
{
   private string instanceName;

   public Name(string name)
   {
      this.instanceName = name;
   }

   public void DisplayToConsole()
   {
      Console.WriteLine(this.instanceName);
   }

   public void DisplayToWindow()
   {
      MessageBox.Show(this.instanceName);
   }
}

public class LambdaExpression
{
   public static void Main()
   {
      Name testName = new Name("Koani");
      Action showMethod = () => testName.DisplayToWindow();
      showMethod();
   }
}

Métodos de Extensão

GetMethodInfo(Delegate)

Obtém um objeto que representa o método representado pelo delegado especificado.

Aplica-se a

Confira também

• Func<TResult>