FileLoggingSession.CloseAndSaveToFileAsync Methode

Definition

Namespace:

Windows.Foundation.Diagnostics

Beendet die aktuelle Protokollierungssitzung und speichert sie in einer Datei.

public:
 virtual IAsyncOperation<StorageFile ^> ^ CloseAndSaveToFileAsync() = CloseAndSaveToFileAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageFile> CloseAndSaveToFileAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageFile> CloseAndSaveToFileAsync();

function closeAndSaveToFileAsync()

Public Function CloseAndSaveToFileAsync () As IAsyncOperation(Of StorageFile)

Gibt zurück

IAsyncOperation<StorageFile>

Wenn diese Methode abgeschlossen ist, wird die neue Datei als StorageFile zurückgegeben. Gibt NULL zurück, wenn keine Ereignisse in der Sitzung vorhanden sind oder wenn für die Protokollierung gerade ein Rollover in eine neue Datei erfolgt ist, die noch keine Ereignisse enthält.

Implementiert

CloseAndSaveToFileAsync()

Attribute

RemoteAsyncAttribute

Hinweise

FileLoggingSession.CloseAndSaveToFileAsync schließt die aktuelle Protokollierungssitzung. Wenn es einen Handler für die LogFileGenerated-Methode gibt, der aufgerufen, aber nicht zurückgegeben wurde, wartet die Funktion auf die Rückgabe des Handlers. Wenn in der aktuellen Protokolldatei Daten vorhanden sind, die noch nicht mit dem LogFileGenerated-Ereignis gemeldet wurden, gibt die Funktion eine StorageFile zurück, die diese Datei darstellt.

Andernfalls gibt die Funktion NULL zurück. Dies kann passieren, wenn die aktuelle Protokolldatei leer ist oder alle Protokolldateien bereits über das LogFileGenerated-Ereignis gemeldet wurden. Beachten Sie, dass CloseAndSaveToFileAsync möglicherweise NULL zurückgibt, auch wenn Daten aufgezeichnet wurden und selbst wenn kein LogFileGenerated-Ereignis vorhanden ist. Dies kann passieren, wenn die Protokolldatei voll und geschlossen wurde und unmittelbar vor dem Aufruf von CloseAndSaveToFileAsync eine neue Protokolldatei geöffnet wurde.

Diese Funktion entspricht FileLoggingSession.Close.