WorkflowRuntime.Dispose Methode

Definition

Namespace:

System.Workflow.Runtime

Assembly:

System.Workflow.Runtime.dll

Gibt die von der WorkflowRuntime verwendeten Ressourcen frei.

public:
 virtual void Dispose();

public void Dispose ();

abstract member Dispose : unit -> unit
override this.Dispose : unit -> unit

Public Sub Dispose ()

Implementiert

Dispose()

Beispiele

Das folgende Codebeispiel zeigt, wie Sie Dispose für ein WorkflowRuntime-Objekt aufrufen. 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. Dieses Beispiel stammt aus dem Beispiel für die Sprachanwendung.

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. Der Grund hierfür ist, dass der alleinige Aufruf der Dispose-Methode WorkflowRuntime in einem nicht verwendbaren Zustand belässt. 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 sollte nur aufgerufen werden, wenn die Hostanwendung die Ressourcen freigeben muss, die von WorkflowRuntime verwendet werden, bevor sie vom Garbage Collector automatisch freigegeben werden. Allgemeine Informationen zu Dispose, finden Sie unter Bereinigen nicht verwalteter Ressourcen und Implementieren einer Dispose-Methode.