WebPart.RegisterWorkItemCallback method
NOTE: This API is now obsolete.
Coloca em fila um item de trabalho do Web Part para o pool de threads, invoca o delegado especificado e especifica um objeto a serem passados para o delegado quando atendido do pool de threads.
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaração
<ObsoleteAttribute("Use Page.RegisterAsyncTask instead.")> _
Protected Function RegisterWorkItemCallback ( _
beginCallBack As WaitCallback, _
state As Object _
) As Boolean
'Uso
Dim beginCallBack As WaitCallback
Dim state As Object
Dim returnValue As Boolean
returnValue = Me.RegisterWorkItemCallback(beginCallBack, _
state)
[ObsoleteAttribute("Use Page.RegisterAsyncTask instead.")]
protected bool RegisterWorkItemCallback(
WaitCallback beginCallBack,
Object state
)
Parâmetros
beginCallBack
Type: System.Threading.WaitCallbackUm objeto de System.Threading.WaitCallback representando o delegado para invocar quando um thread no pool de segmentos seleciona o item de trabalho.
state
Type: System.ObjectO objeto que é passado para o delegado quando atendido do pool de threads.
Valor retornado
Type: System.Boolean
true se o método tiver êxito; Caso contrário, false.
Comentários
Uma Web Part deve usar um encadeamento assíncrono para qualquer operação que pode demorar um período de tempo significativo. Por exemplo, se um banco de dados ou HTTP solicitar precisa ser executada, executando este item de trabalho em um encadeamento assíncrono permitirá que outras partes continue o processamento sem estão sendo bloqueadas. A classe de base WebPart fornece métodos para criar um thread separado para buscas de dados de Web Part e gerenciar esses segmentos para garantir que eles não executar muito longos e bloquear a página da renderização. O método RegisterWorkItemCallback pode ser chamado a qualquer momento antes do RenderWebPart método for chamado. Esse método opera em uma maneira semelhante à System.Threading.ThreadPool.QueueUserWorkItem, mas é implementado para trabalhar com o modelo de evento dentro de uma página de Web Parts.
Se houver threads não concluídas quando o tempo limite ocorre, o método RenderWorkItemTimeout é chamado em vez do método RenderWebPart . A configuração de tempo limite é especificada pelo valor do atributo Timeout da marca < WebPartWorkItem > que está contida na marca < SharePoint > no arquivo Web. config XML.