类 RealmLogger

记录源自 Realm 的消息的记录器。 可以通过设置Default来替换默认记录器。
Console 、 Null和Function(操作<string>)提供了一些内置实现，但您也可以实现自己的实现。

继承

对象

RealmLogger

记录器

命名空间： Realm 。日志记录

程序集：Realm.dll

语法

public abstract class RealmLogger

构造函数

RealmLogger()

初始化RealmLogger类的新实例。

声明

protected RealmLogger()

属性

console

获取将消息输出到默认控制台的RealmLogger.ConsoleLogger 。 对于大多数项目类型，将使用WriteLine() ，但某些平台可能会使用不同的实现。

声明

public static RealmLogger Console { get; }

属性值

类型	说明
RealmLogger	输出到平台控制台的RealmLogger实例。

默认

获取或设置自定义RealmLogger实施，每当必须记录信息时， Realm将使用该实现。

声明

public static RealmLogger Default { get; set; }

属性值

类型	说明
RealmLogger	用于源自 Realm 的消息的记录器。

日志级别

通过Realm获取或设置所有日志类别的日志消息的详细程度。

声明

[Obsolete("Use GetLogLevel() and SetLogLevel().")]
public static LogLevel LogLevel { get; set; }

属性值

类型	说明
日志级别	源自 Realm 的消息的日志级别。

null

获取忽略所有消息的RealmLogger.NullLogger 。

声明

public static RealmLogger Null { get; }

属性值

类型	说明
RealmLogger	不输出任何消息的RealmLogger 。

方法

文件（字符串，编码？）

获取将日志消息保存到文件的RealmLogger.FileLogger 。

声明

public static RealmLogger File(string filePath, Encoding? encoding = null)

参数

类型	名称	说明
字符串	filePath	保存消息的文件路径。 如果文件尚不存在，则会创建该文件。
编码	编码	要使用的字符编码。 如果未指定，则默认为UTF8 。

返回：

类型	说明
RealmLogger	一个RealmLogger实例，用于将日志消息保存到文件中。

备注

请注意，此记录器未针对性能进行优化，更详细的日志级别可能会导致整体同步性能下降。

Function(Action<LogLevel, LogCategory, string>)

获取一个RealmLogger.FunctionLogger ，它将 Log 调用代理为所提供的函数。

声明

public static RealmLogger Function(Action<LogLevel, LogCategory, string> logFunction)

参数

类型	名称	说明
操作< LogLevel , LogCategory , string >	logFunction	代理日志调用的函数。

返回：

类型	说明
RealmLogger	将为每条消息调用logFunction的RealmLogger实例。

Function(操作<LogLevel, string>)

获取一个RealmLogger.FunctionLogger ，它将 Log 调用代理为所提供的函数。

声明

[Obsolete("Use Function(Action<LogLevel, LogCategory, string> logFunction).")]
public static RealmLogger Function(Action<LogLevel, string> logFunction)

参数

类型	名称	说明
操作< LogLevel , string >	logFunction	代理日志调用的函数。

返回：

类型	说明
RealmLogger	将为每条消息调用logFunction的RealmLogger实例。

Function(操作<string>)

获取一个RealmLogger.FunctionLogger ，它将 Log 调用代理为所提供的函数。 该消息已使用包含时间戳的默认消息格式进行格式化。

声明

public static RealmLogger Function(Action<string> logFunction)

参数

类型	名称	说明
操作< string >	logFunction	代理日志调用的函数。

返回：

类型	说明
RealmLogger	将为每条消息调用logFunction的RealmLogger实例。

GetLogLevel(LogCategory?)

获取给定类别的日志消息的详细程度。

声明

public static LogLevel GetLogLevel(LogCategory? category = null)

参数

类型	名称	说明
LogCategory	category	要获取级别的类别。 如果未指定，则默认为Realm 。

返回：

类型	说明
日志级别	用于给定类别的日志级别。

Log(LogLevel, LogCategory, string)

在提供的级别和类别记录消息。

声明

public void Log(LogLevel level, LogCategory category, string message)

参数

类型	名称	说明
日志级别	等级	消息的严重性级别。
LogCategory	category	消息的类别。
字符串	message	要记录的消息。

Log(LogLevel, string)

在提供的级别和默认类别SDK中记录消息。

声明

public void Log(LogLevel level, string message)

参数

类型	名称	说明
日志级别	等级	消息的严重性级别。
字符串	message	要记录的消息。

LogImpl(LogLevel, LogCategory, string)

从Log(LogLevel, LogCategory, string)调用的内部实施。

声明

protected abstract void LogImpl(LogLevel level, LogCategory category, string message)

参数

类型	名称	说明
日志级别	等级	消息的严重性级别。
LogCategory	category	消息的类别。
字符串	message	要记录的消息。

SetLogLevel(LogLevel, LogCategory?)

设置给定类别的日志消息的详细程度。

声明

public static void SetLogLevel(LogLevel level, LogCategory? category = null)

参数

类型	名称	说明
日志级别	等级	用于消息的日志级别。
LogCategory	category	要为其设立级别的类别。 如果未指定，则默认为Realm 。