WebPart.RegisterWorkItemCallback-Methode
HINWEIS: Diese API ist veraltet.
Stellt eine Arbeitsaufgabe-Webpart auf den Pool, ruft den angegebenen Delegaten und gibt ein Objekt an die delegieren, wenn die Threadpools bedient übergeben werden sollen.
Namespace: Microsoft.SharePoint.WebPartPages
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<ObsoleteAttribute("Use Page.RegisterAsyncTask instead.")> _
Protected Function RegisterWorkItemCallback ( _
beginCallBack As WaitCallback, _
state As Object _
) As Boolean
'Usage
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
)
Parameter
beginCallBack
Typ: System.Threading.WaitCallbackDie Arbeitsaufgabe aufnimmt ein System.Threading.WaitCallback -Objekt für den Delegaten, wenn ein Thread im Threadpool aufgerufen werden soll.
state
Typ: System.ObjectDas Objekt, das an dem Delegaten bei aus dem Threadpool übergeben wird.
Rückgabewert
Typ: System.Boolean
true , wenn die Methode erfolgreich ist; andernfalls false.
Hinweise
Ein Webpart sollte asynchronen Thread für alle Vorgänge verwenden, die ein signifikanter zeitlicher konnte. Beispielsweise wenn eine Datenbank oder einen HTTP-Anforderungen ausgeführt werden, anfordern, kann diese Arbeitsaufgabe auf asynchronen Thread ausgeführt andere Teile, die Verarbeitung fortzusetzen, ohne dass Sie blockiert, nämlich. Die WebPart -Basisklasse stellt Methoden für einen separaten Thread zum Webpart Daten Abrufe erstellen und Verwalten von diese Threads, um sicherzustellen, nicht zu lang ausgeführt werden und blockieren beim Rendern die Seite bereit. Jedes Mal, wenn vor der RenderWebPart -Methode aufgerufen wird, kann die RegisterWorkItemCallback -Methode aufgerufen werden. Diese Methode arbeitet im System.Threading.ThreadPool.QueueUserWorkItemähnlich, jedoch wird implementiert, um das Ereignismodell innerhalb einer Webpartseite entwickelt.
Wenn es nicht fertig gestellte Threads Timeout auftritt, wird die RenderWorkItemTimeout -Methode statt der RenderWebPart -Methode aufgerufen. Die Timeout-Einstellung wird durch den Wert des Attributs Timeout des Tags < WebPartWorkItem > angegeben, der innerhalb des < SharePoint >-Tags in der Datei web.config enthalten ist.