NativeActivity<TResult> NativeActivity<TResult> NativeActivity<TResult> NativeActivity<TResult> Class

Определение

Абстрактный базовый класс для пользовательских действий, в которых логика выполнения реализуется с помощью метода Execute(NativeActivityContext), который имеет полный доступ к возможностям среды выполнения.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)

Параметры типа

TResult

Результат, возвращаемый действием.The result returned by the activity.

Наследование
Производный

Примеры

В следующем образце кода показано создание класса, который наследует от NativeActivity<TResult>.The following code sample demonstrates creating a class that inherits from NativeActivity<TResult>. Этот пример взят из как: Создание действия шаге Приступая к работе [.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 (name == string.Empty)
        {
            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

Конструкторы

NativeActivity<TResult>() NativeActivity<TResult>() NativeActivity<TResult>() NativeActivity<TResult>()

При реализации в производном классе создает новый экземпляр производного класса.When implemented in a derived class, creates a new instance of the derived class.

Свойства

CacheId CacheId CacheId CacheId

Возвращает идентификатор кэша, уникальный в пределах области определения рабочего процесса.Gets the identifier of the cache that is unique within the scope of the workflow definition.

(Inherited from Activity)
CanInduceIdle CanInduceIdle CanInduceIdle CanInduceIdle

Возвращает или задает значение, указывающее, может ли действие вызывать простой рабочего процесса.Gets or sets a value that indicates whether the activity can cause the workflow to become idle.

Constraints Constraints Constraints Constraints

Возвращает коллекцию действий Constraint, которые можно настроить для выполнения проверки the Activity.Gets a collection of Constraint activities that can be configured to provide validation for the Activity.

(Inherited from Activity)
DisplayName DisplayName DisplayName DisplayName

Возвращает или задает дополнительное понятное имя, используемое для отладки, проверки, обработки исключений и отслеживания.Gets or sets an optional friendly name that is used for debugging, validation, exception handling, and tracking.

(Inherited from Activity)
Id Id Id Id

Возвращает идентификатор, уникальный в пределах области определения рабочего процесса.Gets an identifier that is unique in the scope of the workflow definition.

(Inherited from Activity)
Implementation Implementation Implementation Implementation

Логика выполнения действия.The execution logic of the activity.

ImplementationVersion ImplementationVersion ImplementationVersion ImplementationVersion

Получает или задает версию реализации действия.Gets or sets the implementation version of the activity.

Result Result Result Result

Возвращает или задает результирующий аргумент для Activity<TResult>.Gets or sets the result argument for the Activity<TResult>.

(Inherited from Activity<TResult>)
ResultType ResultType ResultType ResultType

При реализации в производном классе возвращает тип аргумента OutArgument действия.When implemented in a derived class, gets the type of an activity OutArgument.

(Inherited from ActivityWithResult)

Методы

Abort(NativeActivityAbortContext) Abort(NativeActivityAbortContext) Abort(NativeActivityAbortContext) Abort(NativeActivityAbortContext)

При реализации в производном классе выполняет действия в ответ на прерывание действия.When implemented in a derived class, takes actions in response to the activity being aborted.

CacheMetadata(ActivityMetadata) CacheMetadata(ActivityMetadata) CacheMetadata(ActivityMetadata) CacheMetadata(ActivityMetadata)

Не реализовано.Not implemented. Взамен рекомендуется использовать CacheMetadata(NativeActivityMetadata).Use CacheMetadata(NativeActivityMetadata) instead.

CacheMetadata(NativeActivityMetadata) CacheMetadata(NativeActivityMetadata) CacheMetadata(NativeActivityMetadata) CacheMetadata(NativeActivityMetadata)

Создает и проверяет описание аргументов, переменных, дочерних действий и делегатов действия.Creates and validates a description of the activity's arguments, variables, child activities, and activity delegates.

Cancel(NativeActivityContext) Cancel(NativeActivityContext) Cancel(NativeActivityContext) Cancel(NativeActivityContext)

При реализации в производном классе выполняет логику, обеспечивающую изящное раннее завершение действия.When implemented in a derived class, runs logic to cause graceful early completion of the activity.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Execute(NativeActivityContext) Execute(NativeActivityContext) Execute(NativeActivityContext) Execute(NativeActivityContext)

При реализации в производном классе запускает логику выполнения действия.When implemented in a derived class, runs the activity's execution logic.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnCreateDynamicUpdateMap(NativeActivityUpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(NativeActivityUpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(NativeActivityUpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(NativeActivityUpdateMapMetadata, Activity)

Вызывает событие при создании сопоставления для динамического обновления.Raises an event when creating a map for the dynamic update.

OnCreateDynamicUpdateMap(UpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(UpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(UpdateMapMetadata, Activity) OnCreateDynamicUpdateMap(UpdateMapMetadata, Activity)

Вызывает событие при создании сопоставления для динамического обновления.Raises an event when creating a map for the dynamic update.

ShouldSerializeDisplayName() ShouldSerializeDisplayName() ShouldSerializeDisplayName() ShouldSerializeDisplayName()

Указывает, необходима ли сериализация свойства DisplayName.Indicates whether the DisplayName property should be serialized.

(Inherited from Activity)
ToString() ToString() ToString() ToString()

Возвращает значение типа String, которое содержит Id и DisplayName для Activity.Returns a String that contains the Id and DisplayName of the Activity.

(Inherited from Activity)
UpdateInstance(NativeActivityUpdateContext) UpdateInstance(NativeActivityUpdateContext) UpdateInstance(NativeActivityUpdateContext) UpdateInstance(NativeActivityUpdateContext)

Обновляет экземпляр NativeActivity<TResult>.Updates the instance of NativeActivity<TResult>.

Применяется к