Action Action Action Action Delegate

Definition

Kapselt eine Methode, die über keine Parameter verfügt und keinen Wert zurückgibt.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()
Vererbung

Hinweise

Sie können diesen Delegaten verwenden, um eine Methode als Parameter zu übergeben, ohne explizit einen benutzerdefinierten Delegaten zu deklarieren.You can use this delegate to pass a method as a parameter without explicitly declaring a custom delegate. Die gekapselte Methode muss der Methoden Signatur entsprechen, die von diesem Delegaten definiert wird.The encapsulated method must correspond to the method signature that is defined by this delegate. Dies bedeutet, dass die gekapselte Methode keine Parameter und keinen Rückgabewert aufweisen darf.This means that the encapsulated method must have no parameters and no return value. (In C#muss die-Methode zurück voidgeben.(In C#, the method must return void. In Visual Basic muss Sie von der Sub...End SubIn Visual Basic, it must be defined by the SubEnd Sub Erstellen.construct. Es kann auch eine Methode sein, die einen Wert zurückgibt, der ignoriert wird.) In der Regel wird eine solche Methode verwendet, um einen Vorgang auszuführen.It can also be a method that returns a value that is ignored.) Typically, such a method is used to perform an operation.

Hinweis

Um auf eine Methode zu verweisen, die über keine Parameter verfügt und einen Wert zurück Func<TResult> gibt, verwenden Sie stattdessen den generischen Delegaten.To reference a method that has no parameters and returns a value, use the generic Func<TResult> delegate instead.

Wenn Sie den Action -Delegaten verwenden, müssen Sie nicht explizit einen Delegaten definieren, der eine parameterlose Prozedur kapselt.When you use the Action delegate, you do not have to explicitly define a delegate that encapsulates a parameterless procedure. Der folgende Code deklariert z. b. explizit einen Delegaten mit dem Namen ShowValue und weist seiner Delegatinstanz einen Verweis auf die Name.DisplayToWindow Instanzmethode zu.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

Im folgenden Beispiel wird dieser Code vereinfacht, indem der Action Delegat instanziiert wird, anstatt explizit einen neuen Delegaten zu definieren und ihm eine benannte Methode zuzuweisen.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

Sie können den Action Delegaten auch mit anonymen Methoden in C#verwenden, wie im folgenden Beispiel veranschaulicht.You can also use the Action delegate with anonymous methods in C#, as the following example illustrates. (Eine Einführung zu anonymen Methoden finden Sie unter Anonyme Methoden.)(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();
   }
}

Sie können einem Delegatinstanz auch einen Lambda Action -Ausdruck zuweisen, wie im folgenden Beispiel veranschaulicht.You can also assign a lambda expression to an Action delegate instance, as the following example illustrates. (Eine Einführung in Lambda-Ausdrücke finden Sie unter Lambda-Ausdrücke.)(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

Erweiterungsmethoden

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

Ruft ein Objekt ab, das die Methode darstellt, die vom angegebenen Delegaten dargestellt wird.Gets an object that represents the method represented by the specified delegate.

Gilt für:

Siehe auch