Action Délégué

Définition

Encapsule une méthode dépourvue de paramètre et ne retournant aucune valeur.Encapsulates a method that has no parameters and does not return a value.

public delegate void Action();
public delegate void Action();
type Action = delegate of unit -> unit
Public Delegate Sub Action()
Héritage
Action

Remarques

Vous pouvez utiliser ce délégué pour passer une méthode en tant que paramètre sans déclarer explicitement un délégué personnalisé.You can use this delegate to pass a method as a parameter without explicitly declaring a custom delegate. La méthode encapsulée doit correspondre à la signature de méthode définie par ce délégué.The encapsulated method must correspond to the method signature that is defined by this delegate. Cela signifie que la méthode encapsulée ne doit avoir aucun paramètre et aucune valeur de retour.This means that the encapsulated method must have no parameters and no return value. (Dans C#, la méthode doit retourner void.(In C#, the method must return void. Dans Visual Basic, elle doit être définie par Sub...End SubIn Visual Basic, it must be defined by the SubEnd Sub composer.construct. Il peut également s’agir d’une méthode qui retourne une valeur qui est ignorée.) En général, une telle méthode est utilisée pour effectuer une opération.It can also be a method that returns a value that is ignored.) Typically, such a method is used to perform an operation.

Notes

Pour référencer une méthode qui n’a aucun paramètre et retourne une valeur, utilisez Func<TResult> plutôt le délégué générique.To reference a method that has no parameters and returns a value, use the generic Func<TResult> delegate instead.

Lorsque vous utilisez le Action délégué, vous n’avez pas à définir explicitement un délégué qui encapsule une procédure sans paramètre.When you use the Action delegate, you do not have to explicitly define a delegate that encapsulates a parameterless procedure. Par exemple, le code suivant déclare explicitement un délégué nommé ShowValue et assigne une référence à la Name.DisplayToWindow méthode d’instance à son instance de délégué.For example, the following code explicitly declares a delegate named ShowValue and assigns a reference to the Name.DisplayToWindow instance method to its delegate instance.

using namespace System;
using namespace System::Windows::Forms;

public delegate void ShowValue();


public ref class Name
{
private:
   String^ instanceName;

public:
   Name(String^ name) 
   {
      instanceName = name;
   }

   void DisplayToConsole()
   {
      Console::WriteLine(this->instanceName);
   }

   void DisplayToWindow()
   {
      MessageBox::Show(this->instanceName);
   }
};

int main()
{
   Name^ testName = gcnew Name(L"Koani");
   ShowValue^ showMethod;
   showMethod = gcnew ShowValue(testName, &Name::DisplayToWindow);
   showMethod();
   return 0;
}
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();
   }
}
Public Delegate Sub ShowValue

Public Class Name
   Private instanceName As String
   
   Public Sub New(name As String)
      Me.instanceName = name
   End Sub
   
   Public Sub DisplayToConsole()
      Console.WriteLine(Me.instanceName)
   End Sub   
   
   Public Sub DisplayToWindow()
      MsgBox(Me.instanceName)
   End Sub   
End Class

Public Module testDelegate
   Public Sub Main()
      Dim testName As New Name("Koani")
      Dim showMethod As ShowValue = AddressOf testName.DisplayToWindow
      showMethod   
   End Sub
End Module

L’exemple suivant simplifie ce code en instanciant Action le délégué au lieu de définir explicitement un nouveau délégué et en lui assignant une méthode nommée.The following example simplifies this code by instantiating the Action delegate instead of explicitly defining a new delegate and assigning a named method to it.

#using <System.Windows.Forms.dll>

using namespace System;
using namespace System::Windows::Forms;

public ref class Name
{
private:
   String^ instanceName;
   
public:
   Name(String^ name)
   {
      instanceName = name;
   }

   void DisplayToConsole()
   {
      Console::WriteLine(this->instanceName);
   }

   void DisplayToWindow()
   {
      MessageBox::Show(this->instanceName);
   }
};


int main()
{
   Name^ testName = gcnew Name(L"Koani");
   System::Action^ showMethod;
   showMethod += gcnew Action(testName, &Name::DisplayToWindow);
   showMethod();
   return 0;
}
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();
   }
}
Public Class Name
   Private instanceName As String
   
   Public Sub New(name As String)
      Me.instanceName = name
   End Sub
   
   Public Sub DisplayToConsole()
      Console.WriteLine(Me.instanceName)
   End Sub   
   
   Public Sub DisplayToWindow()
      MsgBox(Me.instanceName)
   End Sub   
End Class

Public Module testDelegate
   Public Sub Main()
      Dim testName As New Name("Koani")
      Dim showMethod As Action = AddressOf testName.DisplayToWindow
      showMethod   
   End Sub
End Module

Vous pouvez également utiliser le Action délégué avec des méthodes anonymes dans C#, comme l’illustre l’exemple suivant.You can also use the Action delegate with anonymous methods in C#, as the following example illustrates. (Pour une introduction aux méthodes anonymes, consultez méthodes anonymes.)(For an introduction to anonymous methods, see Anonymous Methods.)

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();
   }
}

Vous pouvez également assigner une expression lambda Action à une instance de délégué, comme l’illustre l’exemple suivant.You can also assign a lambda expression to an Action delegate instance, as the following example illustrates. (Pour une présentation des expressions lambda, consultez expressions lambda.)(For an introduction to lambda expressions, see Lambda Expressions.)

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();
   }
}
Public Class Name
   Private instanceName As String
   
   Public Sub New(name As String)
      Me.instanceName = name
   End Sub
   
   Public Function DisplayToConsole() As Integer
      Console.WriteLine(Me.instanceName)
      Return 0
   End Function
   
   Public Function DisplayToWindow() As Integer
      Return MsgBox(Me.instanceName)
   End Function      
End Class

Module LambdaExpression
   Public Sub Main()
      Dim name1 As New Name("Koani")
      Dim methodCall As Action = Sub() name1.DisplayToWindow()
      methodCall()
   End Sub
End Module

Méthodes d’extension

GetMethodInfo(Delegate)

Obtient un objet qui représente la méthode représentée par le délégué spécifié.Gets an object that represents the method represented by the specified delegate.

S’applique à

Voir aussi