WorkflowApplication.ResumeBookmark Método

Definição

Espaço de Nomes:: System.Activities

Assemblagem:: System.Activities.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Inicia uma operação para retomar um marcador.

Sobrecargas

Name	Description
ResumeBookmark(String, Object, TimeSpan)	Inicia uma operação para retomar o marcador com o nome especificado, usando o valor e intervalo de tempo especificados. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.
ResumeBookmark(Bookmark, Object, TimeSpan)	Inicia uma operação para retomar o marcador especificado, usando o valor e intervalo de tempo especificados. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.
ResumeBookmark(Bookmark, Object)	Inicia uma operação para retomar o marcador especificado, usando o valor especificado. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.
ResumeBookmark(String, Object)	Inicia uma operação para retomar o marcador com o nome especificado, usando o valor especificado. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.

ResumeBookmark(String, Object, TimeSpan)

Inicia uma operação para retomar o marcador com o nome especificado, usando o valor e intervalo de tempo especificados. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.

public:
 System::Activities::BookmarkResumptionResult ResumeBookmark(System::String ^ bookmarkName, System::Object ^ value, TimeSpan timeout);

public System.Activities.BookmarkResumptionResult ResumeBookmark(string bookmarkName, object value, TimeSpan timeout);

member this.ResumeBookmark : string * obj * TimeSpan -> System.Activities.BookmarkResumptionResult

Public Function ResumeBookmark (bookmarkName As String, value As Object, timeout As TimeSpan) As BookmarkResumptionResult

Parâmetros

bookmarkName: String

O nome do marcador para ser retomado.

value: Object

Um objeto passado como parâmetro para o método que é invocado quando o marcador recomeça.

timeout: TimeSpan

O intervalo de tempo durante o qual o marcador deve ser retomado.

Devoluções

BookmarkResumptionResult

Resultado da operação de retoma dos marcadores.

Exemplos

O exemplo seguinte cria um fluxo de trabalho que utiliza uma ReadLine atividade que cria um Bookmark. O fluxo de trabalho é iniciado e, uma vez Bookmark criado e o fluxo de trabalho fica inativo, a entrada do utilizador é recolhida e o marcador é retomado.

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

    protected override void Execute(NativeActivityContext context)
    {
        // Create a Bookmark and wait for it to be resumed.
        context.CreateBookmark(BookmarkName.Get(context),
            new BookmarkCallback(OnResumeBookmark));
    }

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

    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        // When the Bookmark is resumed, assign its value to
        // the Result argument.
        Result.Set(context, (string)obj);
    }

Variable<string> name = new Variable<string>();

Activity wf = new Sequence
{
    Variables = { name },
    Activities =
     {
         new WriteLine
         {
             Text = "What is your name?"
         },
         new ReadLine
         {
             BookmarkName = "UserName",
             Result = new OutArgument<string>(name)
         },
         new WriteLine
         {
             Text = new InArgument<string>((env) =>
                 ("Hello, " + name.Get(env)))
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);

wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
    idleEvent.Set();
};

// Run the workflow.
wfApp.Run();

// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();

// Gather the user's input and resume the bookmark.
// Bookmark resumption only occurs when the workflow
// is idle. If a call to ResumeBookmark is made and the workflow
// is not idle, ResumeBookmark blocks until the workflow becomes
// idle before resuming the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark("UserName",
    Console.ReadLine());

// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);

Observações

O resultado do marcador indica se a operação de retoma foi bem-sucedida ou falhou.

Aplica-se a

ResumeBookmark(Bookmark, Object, TimeSpan)

Inicia uma operação para retomar o marcador especificado, usando o valor e intervalo de tempo especificados. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.

public:
 System::Activities::BookmarkResumptionResult ResumeBookmark(System::Activities::Bookmark ^ bookmark, System::Object ^ value, TimeSpan timeout);

public System.Activities.BookmarkResumptionResult ResumeBookmark(System.Activities.Bookmark bookmark, object value, TimeSpan timeout);

member this.ResumeBookmark : System.Activities.Bookmark * obj * TimeSpan -> System.Activities.BookmarkResumptionResult

Public Function ResumeBookmark (bookmark As Bookmark, value As Object, timeout As TimeSpan) As BookmarkResumptionResult

Parâmetros

bookmark: Bookmark

O marcador para recomeçar.

value: Object

Um objeto passado como parâmetro para o método que é invocado quando o marcador recomeça.

timeout: TimeSpan

O intervalo de tempo durante o qual o marcador deve ser retomado.

Devoluções

BookmarkResumptionResult

Resultado da operação de retoma dos marcadores.

Exemplos

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

    protected override void Execute(NativeActivityContext context)
    {
        // Create a Bookmark and wait for it to be resumed.
        context.CreateBookmark(BookmarkName.Get(context),
            new BookmarkCallback(OnResumeBookmark));
    }

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

    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        // When the Bookmark is resumed, assign its value to
        // the Result argument.
        Result.Set(context, (string)obj);
    }

Variable<string> name = new Variable<string>();

Activity wf = new Sequence
{
    Variables = { name },
    Activities =
     {
         new WriteLine
         {
             Text = "What is your name?"
         },
         new ReadLine
         {
             BookmarkName = "UserName",
             Result = new OutArgument<string>(name)
         },
         new WriteLine
         {
             Text = new InArgument<string>((env) =>
                 ("Hello, " + name.Get(env)))
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);

wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
    idleEvent.Set();
};

// Run the workflow.
wfApp.Run();

// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();

// Gather the user's input and resume the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark(new Bookmark("UserName"),
    Console.ReadLine(), TimeSpan.FromSeconds(15));

// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);

Observações

O resultado do marcador indica se a operação de retoma foi bem-sucedida ou falhou.

Aplica-se a

ResumeBookmark(Bookmark, Object)

Inicia uma operação para retomar o marcador especificado, usando o valor especificado. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.

public:
 System::Activities::BookmarkResumptionResult ResumeBookmark(System::Activities::Bookmark ^ bookmark, System::Object ^ value);

public System.Activities.BookmarkResumptionResult ResumeBookmark(System.Activities.Bookmark bookmark, object value);

member this.ResumeBookmark : System.Activities.Bookmark * obj -> System.Activities.BookmarkResumptionResult

Public Function ResumeBookmark (bookmark As Bookmark, value As Object) As BookmarkResumptionResult

Parâmetros

bookmark: Bookmark

O marcador para recomeçar.

value: Object

Um objeto passado como parâmetro para o método que é invocado quando o marcador recomeça.

Devoluções

BookmarkResumptionResult

Resultado da operação de retoma dos marcadores.

Exemplos

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

    protected override void Execute(NativeActivityContext context)
    {
        // Create a Bookmark and wait for it to be resumed.
        context.CreateBookmark(BookmarkName.Get(context),
            new BookmarkCallback(OnResumeBookmark));
    }

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

    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        // When the Bookmark is resumed, assign its value to
        // the Result argument.
        Result.Set(context, (string)obj);
    }

Variable<string> name = new Variable<string>();

Activity wf = new Sequence
{
    Variables = { name },
    Activities =
     {
         new WriteLine
         {
             Text = "What is your name?"
         },
         new ReadLine
         {
             BookmarkName = "UserName",
             Result = new OutArgument<string>(name)
         },
         new WriteLine
         {
             Text = new InArgument<string>((env) =>
                 ("Hello, " + name.Get(env)))
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);

wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
    idleEvent.Set();
};

// Run the workflow.
wfApp.Run();

// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();

// Gather the user's input and resume the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark(new Bookmark("UserName"),
    Console.ReadLine());

// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);

Observações

O resultado do marcador indica se a operação de retoma foi bem-sucedida ou falhou.

Aplica-se a

ResumeBookmark(String, Object)

Inicia uma operação para retomar o marcador com o nome especificado, usando o valor especificado. O marcador a ser retomado é previamente criado por uma atividade dentro da instância do workflow.

public:
 System::Activities::BookmarkResumptionResult ResumeBookmark(System::String ^ bookmarkName, System::Object ^ value);

public System.Activities.BookmarkResumptionResult ResumeBookmark(string bookmarkName, object value);

member this.ResumeBookmark : string * obj -> System.Activities.BookmarkResumptionResult

Public Function ResumeBookmark (bookmarkName As String, value As Object) As BookmarkResumptionResult

Parâmetros

bookmarkName: String

O nome do marcador para ser retomado.

value: Object

Um objeto passado como parâmetro para o método que é invocado quando o marcador recomeça.

Devoluções

BookmarkResumptionResult

Resultado da operação de retoma dos marcadores.

Exemplos

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

    protected override void Execute(NativeActivityContext context)
    {
        // Create a Bookmark and wait for it to be resumed.
        context.CreateBookmark(BookmarkName.Get(context),
            new BookmarkCallback(OnResumeBookmark));
    }

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

    public void OnResumeBookmark(NativeActivityContext context, Bookmark bookmark, object obj)
    {
        // When the Bookmark is resumed, assign its value to
        // the Result argument.
        Result.Set(context, (string)obj);
    }

Variable<string> name = new Variable<string>();

Activity wf = new Sequence
{
    Variables = { name },
    Activities =
     {
         new WriteLine
         {
             Text = "What is your name?"
         },
         new ReadLine
         {
             BookmarkName = "UserName",
             Result = new OutArgument<string>(name)
         },
         new WriteLine
         {
             Text = new InArgument<string>((env) =>
                 ("Hello, " + name.Get(env)))
         }
     }
};

// Create a WorkflowApplication instance.
WorkflowApplication wfApp = new WorkflowApplication(wf);

// Workflow lifecycle events omitted except idle.
AutoResetEvent idleEvent = new AutoResetEvent(false);

wfApp.Idle = delegate(WorkflowApplicationIdleEventArgs e)
{
    idleEvent.Set();
};

// Run the workflow.
wfApp.Run();

// Wait for the workflow to go idle before gathering
// the user's input.
idleEvent.WaitOne();

// Gather the user's input and resume the bookmark.
// Bookmark resumption only occurs when the workflow
// is idle. If a call to ResumeBookmark is made and the workflow
// is not idle, ResumeBookmark blocks until the workflow becomes
// idle before resuming the bookmark.
BookmarkResumptionResult result = wfApp.ResumeBookmark("UserName",
    Console.ReadLine());

// Possible BookmarkResumptionResult values:
// Success, NotFound, or NotReady
Console.WriteLine("BookmarkResumptionResult: {0}", result);

Observações

O resultado do marcador indica se a operação de retoma foi bem-sucedida ou falhou.

Aplica-se a

Comentários

Esta página foi útil?