Action<T> Delegera

Definition

generic <typename T>
public delegate void Action(T obj);

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

public delegate void Action<in T>(T obj) where T : allows ref struct;

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

type Action<'T> = delegate of 'T -> unit

Public Delegate Sub Action(Of In T)(obj As T)

Public Delegate Sub Action(Of T)(obj As T)

Typparametrar

Parametrar

Exempel

I följande exempel visas hur ombudet Action<T> används för att skriva ut innehållet i ett List<T> objekt. I det här exemplet Print används metoden för att visa innehållet i listan i konsolen. Dessutom visar C#-exemplet också användningen av anonyma metoder för att visa innehållet i konsolen. Observera att exemplet inte uttryckligen deklarerar en Action<T> variabel. I stället skickas en referens till en metod som tar en enskild parameter och som inte returnerar ett värde till List<T>.ForEach metoden, vars enda parameter är ett Action<T> ombud. På samma sätt instansieras inte ett Action<T> ombud uttryckligen i C#-exemplet eftersom signaturen för den anonyma metoden matchar signaturen för det Action<T> ombud som förväntas av List<T>.ForEach metoden.

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

void Print(string s)
{
    Console.WriteLine(s);
}

/* This code will produce output similar to the following:
* Bruce
* Alfred
* Tim
* Richard
* Bruce
* Alfred
* Tim
* Richard
*/

// F# provides a type alias for System.Collections.List<'T> as ResizeArray<'T>.
let names = ResizeArray<string>()
names.Add "Bruce"
names.Add "Alfred"
names.Add "Tim"
names.Add "Richard"

let print s = printfn "%s" s

// Display the contents of the list using the print function.
names.ForEach(Action<string> print)

// The following demonstrates the lambda expression feature of F#
// to display the contents of the list to the console.
names.ForEach(fun s -> printfn "%s" s)

(* This code will produce output similar to the following:
* Bruce
* Alfred
* Tim
* Richard
* Bruce
* Alfred
* Tim
* Richard
*)

Imports System.Collections.Generic

Class Program
    Shared Sub Main()
        Dim names As New List(Of 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(AddressOf Print)
    End Sub

    Shared Sub Print(ByVal s As String)
        Console.WriteLine(s)
    End Sub
End Class

' This code will produce output similar to the following:
' Bruce
' Alfred
' Tim
' Richard

Kommentarer

Du kan använda ombudet Action<T> för att skicka en metod som en parameter utan att uttryckligen deklarera ett anpassat ombud. Den inkapslade metoden måste motsvara den metodsignatur som definieras av det här ombudet. Det innebär att den inkapslade metoden måste ha en parameter som skickas till den med ett värde, och den får inte returnera ett värde. (I C#måste metoden returnera void. I Visual Basic måste den definieras av Sub... End Sub konstruktion. Det kan också vara en metod som returnerar ett värde som ignoreras.) Vanligtvis används en sådan metod för att utföra en åtgärd.

När du använder ombudet Action<T> behöver du inte uttryckligen definiera ett ombud som kapslar in en metod med en enda parameter. Följande kod deklarerar till exempel uttryckligen ett ombud med namnet DisplayMessage och tilldelar en referens till antingen WriteLine metoden eller ShowWindowsMessage metoden till dess ombudsinstans.

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

open System
open System.Windows.Forms

type DisplayMessage = delegate of message: string -> unit

let showWindowsMessage message = 
    MessageBox.Show message |> ignore

let messageTarget =
    DisplayMessage(
        if Environment.GetCommandLineArgs().Length > 1 then
            showWindowsMessage
        else
            printfn "%s"
    )

messageTarget.Invoke "Hello, World!"

Delegate Sub DisplayMessage(message As String) 

Module TestCustomDelegate
   Public Sub Main
      Dim messageTarget As DisplayMessage 

      If Environment.GetCommandLineArgs().Length > 1 Then
         messageTarget = AddressOf ShowWindowsMessage
      Else
         messageTarget = AddressOf Console.WriteLine
      End If
      messageTarget("Hello, World!")
   End Sub
   
   Private Sub ShowWindowsMessage(message As String)
      MsgBox(message)
   End Sub   
End Module

Följande exempel förenklar den här koden genom att instansiera ombudet i stället för att uttryckligen definiera ett nytt ombud och tilldela en namngiven Action<T> metod till den.

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

open System
open System.Windows.Forms

let showWindowsMessage message = 
    MessageBox.Show message |> ignore

let messageTarget =
    Action<string>(
        if Environment.GetCommandLineArgs().Length > 1 then
            showWindowsMessage
        else
            printfn "%s"
    )

messageTarget.Invoke "Hello, World!"

Module TestAction1
   Public Sub Main
      Dim messageTarget As Action(Of String) 

      If Environment.GetCommandLineArgs().Length > 1 Then
         messageTarget = AddressOf ShowWindowsMessage
      Else
         messageTarget = AddressOf Console.WriteLine
      End If
      messageTarget("Hello, World!")
   End Sub
   
   Private Sub ShowWindowsMessage(message As String)
      MsgBox(message)
   End Sub   
End Module

Du kan också använda ombudet Action<T> med anonyma metoder i C#, vilket visas i följande exempel. (En introduktion till anonyma metoder finns i Anonyma metoder.)

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

Du kan också tilldela ett lambda-uttryck till en Action<T> delegatinstans, vilket visas i följande exempel. (En introduktion till lambda-uttryck finns i Lambda-uttryck.)

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

open System
open System.Windows.Forms

let showWindowsMessage message = 
    MessageBox.Show message |> ignore

let messageTarget =
    Action<string>(
        if Environment.GetCommandLineArgs().Length > 1 then
            fun s -> showWindowsMessage s
        else
            fun s -> printfn "%s" s
    )

messageTarget.Invoke "Hello, World!"

Imports System.Windows.Forms

Public Module TestLambdaExpression
   Public Sub Main()
      Dim messageTarget As Action(Of String) 
      
      If Environment.GetCommandLineArgs().Length > 1 Then
         messageTarget = Sub(s) ShowWindowsMessage(s) 
      Else
         messageTarget = Sub(s) ShowConsoleMessage(s)
      End If
      messageTarget("Hello, World!")
   End Sub
      
   Private Function ShowWindowsMessage(message As String) As Integer
      Return MessageBox.Show(message)      
   End Function
   
   Private Function ShowConsoleMessage(message As String) As Integer
      Console.WriteLine(message)
      Return 0
   End Function
End Module

Metoderna ForEach och ForEach tar var och en ett Action<T> ombud som en parameter. Med metoden som inkapslas av ombudet kan du utföra en åtgärd på varje element i matrisen eller listan. I exemplet används ForEach metoden för att tillhandahålla en bild.

Se även

• Func<T,TResult>