FileLoggingSession.CloseAndSaveToFileAsync 方法

定义

命名空间:

Windows.Foundation.Diagnostics

结束当前日志记录会话并将其保存到文件中。

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)

返回

IAsyncOperation<StorageFile>

此方法完成后，它将新文件作为 StorageFile 返回。 如果会话中没有事件，或者如果日志记录刚刚滚动到尚不包含事件的新文件中，则返回 NULL 。

实现

CloseAndSaveToFileAsync()

属性

RemoteAsyncAttribute

注解

FileLoggingSession.CloseAndSaveToFileAsync 关闭当前日志记录会话。 如果 LogFileGenerated 方法有处理程序，并且它已被调用但未返回，则函数将等待处理程序返回。 如果当前日志文件中存在尚未使用 LogFileGenerated 事件报告的任何数据，则函数将返回表示该文件的 StorageFile 。

否则，函数将返回 NULL。 如果当前日志文件为空，或者已通过 LogFileGenerated 事件报告了所有日志文件，则可能会发生这种情况。 请注意，即使记录了数据并且没有 LogFileGenerated 事件，CloseAndSaveToFileAsync 也可能返回 NULL。 如果日志文件已满且已关闭，并在调用 CloseAndSaveToFileAsync 之前立即打开了新的日志文件，则可能会发生这种情况。

此函数等效于 FileLoggingSession.Close。