NativeActivity<TResult> Classe

Définition

Classe de base abstraite conçue pour les activités personnalisées implémentant la logique d’exécution à l’aide de la méthode Execute(NativeActivityContext), qui dispose d’un accès total aux fonctionnalités du runtime.Abstract base class for custom activities that implement execution logic using the Execute(NativeActivityContext) method, that has full access to the runtime's features.

generic <typename TResult>
public ref class NativeActivity abstract : System::Activities::Activity<TResult>
public abstract class NativeActivity<TResult> : System.Activities.Activity<TResult>
type NativeActivity<'Result> = class
    inherit Activity<'Result>
Public MustInherit Class NativeActivity(Of TResult)
Inherits Activity(Of TResult)

Paramètres de type

TResult

Résultat retourné par l'activité.The result returned by the activity.

Héritage
Dérivé

Exemples

L'exemple de code suivant montre comment créer une classe qui hérite de NativeActivity<TResult>.The following code sample demonstrates creating a class that inherits from NativeActivity<TResult>. Cet exemple est issu de la procédure: Créez une étape d’activité du didacticiel [prise en main .NET Framework 4,5].This example is from the How to: Create an Activity step of the Getting Started Tutorial [.NET Framework 4.5].

public sealed class ReadInt : NativeActivity<int>
{
    [RequiredArgument]
    public InArgument<string> BookmarkName { get; set; }

    protected override void Execute(NativeActivityContext context)
    {
        string name = BookmarkName.Get(context);

        if (string.IsNullOrEmpty(name))
        {
            throw new ArgumentException("BookmarkName cannot be an Empty string.",
                "BookmarkName");
        }

        context.CreateBookmark(name, new BookmarkCallback(OnReadComplete));
    }

    // NativeActivity derived activities that do asynchronous operations by calling 
    // one of the CreateBookmark overloads defined on System.Activities.NativeActivityContext 
    // must override the CanInduceIdle property and return true.
    protected override bool CanInduceIdle
    {
        get { return true; }
    }

    void OnReadComplete(NativeActivityContext context, Bookmark bookmark, object state)
    {
        this.Result.Set(context, Convert.ToInt32(state));
    }
}
Public NotInheritable Class ReadInt
    Inherits NativeActivity(Of Integer)
    
    <RequiredArgument()>
    Property BookmarkName() As InArgument(Of String)

    Protected Overrides Sub Execute(ByVal context As NativeActivityContext)
        Dim name As String
        name = BookmarkName.Get(context)

        If name = String.Empty Then
            Throw New ArgumentException("BookmarkName cannot be an Empty string.",
                "BookmarkName")
        End If

        context.CreateBookmark(name, New BookmarkCallback(AddressOf OnReadComplete))
    End Sub

    ' NativeActivity derived activities that do asynchronous operations by calling 
    ' one of the CreateBookmark overloads defined on System.Activities.NativeActivityContext 
    ' must override the CanInduceIdle property and return True.
    Protected Overrides ReadOnly Property CanInduceIdle As Boolean
        Get
            Return True
        End Get
    End Property

    Sub OnReadComplete(ByVal context As NativeActivityContext, ByVal bookmark As Bookmark, ByVal state As Object)
        Result.Set(context, Convert.ToInt32(state))
    End Sub

End Class

Constructeurs

NativeActivity<TResult>()

Lors de l'implémentation dans une classe dérivée, crée une instance de la classe dérivée.When implemented in a derived class, creates a new instance of the derived class.

Propriétés

CacheId

Obtient l'identificateur du cache qui est unique dans la portée de la définition de flux de travail.Gets the identifier of the cache that is unique within the scope of the workflow definition.

(Hérité de Activity)
CanInduceIdle

Obtient ou définit une valeur qui indique si l'activité peut faire passer le flux de travail à l'état inactif.Gets or sets a value that indicates whether the activity can cause the workflow to become idle.

Constraints

Obtient une collection d'activités Constraint qui peuvent être configurées afin de fournir la validation pour l'objet Activity.Gets a collection of Constraint activities that can be configured to provide validation for the Activity.

(Hérité de Activity)
DisplayName

Obtient ou définit un nom convivial utilisé pour le débogage, la validation, la gestion des exceptions et le suivi.Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.

(Hérité de Activity)
Id

Obtient l'identificateur qui est unique dans la portée de la définition de flux de travail.Gets an identifier that is unique in the scope of the workflow definition.

(Hérité de Activity)
Implementation

Logique d'exécution de l'activité.The execution logic of the activity.

ImplementationVersion

Obtient ou définit la version d'implémentation de l'activité.Gets or sets the implementation version of the activity.

Result

Obtient ou définit l’argument de résultat de l’objet Activity<TResult>.Gets or sets the result argument for the Activity<TResult>.

(Hérité de Activity<TResult>)
ResultType

Lors de l'implémentation dans une classe dérivée, obtient le type d'une activité OutArgument.When implemented in a derived class, gets the type of an activity OutArgument.

(Hérité de ActivityWithResult)

Méthodes

Abort(NativeActivityAbortContext)

Lors de l'implémentation dans une classe dérivée, entreprend des actions en réponse à l'activité qui est abandonnée.When implemented in a derived class, takes actions in response to the activity being aborted.

CacheMetadata(ActivityMetadata)

Non implémenté.Not implemented. Utilisez plutôt CacheMetadata(NativeActivityMetadata).Use CacheMetadata(NativeActivityMetadata) instead.

CacheMetadata(NativeActivityMetadata)

Crée et valide une description des arguments, variables, activités enfants et délégués de l’activité.Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.

Cancel(NativeActivityContext)

Lors de l'implémentation dans une classe dérivée, exécute la logique permettant de provoquer une fin anticipée appropriée de l'activité.When implemented in a derived class, runs logic to cause graceful early completion of the activity.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
Execute(NativeActivityContext)

Lors de l’implémentation dans une classe dérivée, exécute la logique d’exécution de l’activité.When implemented in a derived class, runs the activity's execution logic.

GetHashCode()

Sert de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnCreateDynamicUpdateMap(NativeActivityUpdateMapMetadata, Activity)

Déclenche un événement en créant une carte pour la mise à jour dynamique.Raises an event when creating a map for the dynamic update.

OnCreateDynamicUpdateMap(UpdateMapMetadata, Activity)

Déclenche un événement en créant une carte pour la mise à jour dynamique.Raises an event when creating a map for the dynamic update.

ShouldSerializeDisplayName()

Indique si la propriété DisplayName doit être sérialisée.Indicates whether the DisplayName property should be serialized.

(Hérité de Activity)
ToString()

Retourne un objet String qui contient les propriétés Id et DisplayName de l'objet Activity.Returns a String that contains the Id and DisplayName of the Activity.

(Hérité de Activity)
UpdateInstance(NativeActivityUpdateContext)

Met à jour l'instance de NativeActivity<TResult>.Updates the instance of NativeActivity<TResult>.

S’applique à