WorkflowRuntime.Dispose WorkflowRuntime.Dispose WorkflowRuntime.Dispose WorkflowRuntime.Dispose Method

Definition

Gibt die von der WorkflowRuntime verwendeten Ressourcen frei.Releases the resources used by the WorkflowRuntime.

public:
 virtual void Dispose();
public void Dispose ();
abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit
Public Sub Dispose ()

Implementiert

Beispiele

Das folgende Codebeispiel zeigt, wie Sie Dispose für ein WorkflowRuntime-Objekt aufrufen.The following example demonstrates how to call Dispose on a WorkflowRuntime object. In diesem Beispiel wird die Dispose-Methode über den FormClosing-Ereignishandler für das Hauptformular der Anwendung aufgerufen. Auf diese Weise wird sichergestellt, dass die von der Laufzeit erstellten Objekte richtig bereinigt werden, wenn die Anwendung beendet wird.In this sample, the Dispose method is called from the FormClosing event handler for the main form of the application; this ensures that the objects created by the runtime are properly cleaned up when the application shuts down. Dieses Beispiel basiert auf dem Beispiel für eine Sprachanwendung.This sample is from the Speech Application Sample.

private void Form1_FormClosing(object sender, FormClosingEventArgs e)
{
    this.workflowRuntime.Dispose();
}
Private Sub Form1_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
    Me.workflowRuntime.Dispose()
End Sub

Hinweise

Um die WorkflowRuntime ordnungsgemäß herunterzufahren, sollten Sie Dispose aufrufen, nachdem Sie StopRuntime aufgerufen haben.To shut down the WorkflowRuntime gracefully, you should only call Dispose after you have called StopRuntime. Der Grund hierfür ist, dass der alleinige Aufruf der Dispose-Methode WorkflowRuntime in einem nicht verwendbaren Zustand belässt.This is because calling the Dispose method alone leaves the WorkflowRuntime in an unusable state. Dispose gibt die von der Laufzeit verwendeten Ressourcen frei, indem sie geöffnete Dateihandle, Datenbankverbindungen usw. schließt, aber sie entlädt keine Workflowinstanzen, stoppt Dienste oder führt andere Aktionen aus, die von StopRuntime ausgeführt werden.Dispose frees the resources used by the runtime by closing open file handles, database connections, and so on, but it does not unload workflow instances, stop services, or do any of the other actions that StopRuntime does.

Dispose sollte nur aufgerufen werden, wenn die Hostanwendung die Ressourcen freigeben muss, die von WorkflowRuntime verwendet werden, bevor sie vom Garbage Collector automatisch freigegeben werden.Dispose should be called only when the host application must free the resources used by the WorkflowRuntime before they are automatically freed by the garbage collector. Allgemeine Informationen zu finden DisposeSie unter Bereinigen von nicht verwalteten Ressourcen und Implementieren einerverwerfen-Methode.For general information about Dispose, see Cleaning Up Unmanaged Resources and Implementing a Dispose Method.

Gilt für: