WorkflowRuntime.Dispose Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt die von der WorkflowRuntime verwendeten Ressourcen frei.
public:
virtual void Dispose();public void Dispose ();abstract member Dispose : unit -> unit
override this.Dispose : unit -> unitPublic Sub Dispose ()Implementiert
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.