点击或拖拽改变大小

LogNetDateTime 类

一个日志组件,可以根据时间来区分不同的文件存储
A log component that can distinguish different file storages based on time
继承层次
SystemObject
  HslCommunication.LogNetLogNetBase
    HslCommunication.LogNetLogPathBase
      HslCommunication.LogNetLogNetDateTime

命名空间:  HslCommunication.LogNet
程序集:  HslCommunication (在 HslCommunication.dll 中) 版本:12.1.2.0 (12.1.2.0)
语法
public class LogNetDateTime : LogPathBase, 
	ILogNet, IDisposable

LogNetDateTime 类型公开以下成员。

构造函数
  名称说明
公共方法LogNetDateTime
实例化一个根据时间存储的日志组件,需要指定每个文件的存储时间范围
Instantiate a log component based on time, you need to specify the storage time range for each file
Top
属性
  名称说明
公共属性ConsoleOutput
获取或设置当前的日志信息在存储的时候是否在控制台进行输出,默认不输出。
Gets or sets whether the current log information is output on the console when it is stored. It is not output by default.
(继承自 LogNetBase。)
公共属性HourDeviation
获取或设置当前日志时间的小时偏差信息,用来解决某些情况下时区设置异常导致记录时间一直不正确的问题,默认为 0,也就是不处理。可以为正数,也可以为负数。
Obtain or set the hourly deviation information of the current log time to solve the problem that the recording time has been incorrect due to abnormal time zone setting in some cases, and the default is 0, that is, it is not processed. Can be positive or negative.
(继承自 LogNetBase。)
公共属性LogNetStatistics
获取或设置当前的日志记录统计信息,如果你需要统计最近30天的日志,就需要对其实例化,详细参照LogStatistics
Get or set the current log record statistics. If you need to count the logs of the last 30 days, you need to instantiate it. For details, please refer to LogStatistics
(继承自 LogNetBase。)
公共属性LogSaveMode
日志存储模式,1:单文件,2:按大小存储,3:按时间存储
Log storage mode, 1: single file, 2: storage by size, 3: storage by time
(继承自 LogNetBase。)
公共属性LogStxAsciiCode
获取或设置在记录文件日志的时候,是否记录不可见字符STX(也即是ASCII字符集的0x02)。默认为 True, 也即是记录这个字符,在日志分析的时候,可以更加方便的分析。
Gets or sets whether to record the invisible character STX (that is, 0x02 of the ASCII character set) when recording the file log. The default is True, that is, this character is recorded, which can be analyzed more conveniently during log analysis.
(继承自 LogNetBase。)
公共属性LogThreadID
获取或设置是否记录线程ID的数据信息,默认为 True,表示记录,否则,需要设置为 False
Get or set whether to record the data information of the thread ID, the default is True, which means record, otherwise, it needs to be set to False
(继承自 LogNetBase。)
Top
方法
  名称说明
公共方法Dispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(继承自 LogNetBase。)
受保护的方法Dispose(Boolean)
释放资源
(继承自 LogNetBase。)
公共方法Equals
Determines whether the specified object is equal to the current object.
(继承自 Object。)
公共方法FiltrateKeyword
过滤掉指定的关键字的日志,该信息不存储,但仍然触发BeforeSaveToFile事件
Filter out the logs of the specified keywords, the information is not stored, but the BeforeSaveToFile event is still triggered
(继承自 LogNetBase。)
受保护的方法Finalize
Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(继承自 Object。)
公共方法GetExistLogFileNames
返回所有的日志文件名称,返回一个列表
Returns all log file names, returns a list
(继承自 LogPathBase。)
受保护的方法GetFileSaveName (重写 LogNetBaseGetFileSaveName.)
公共方法GetHashCode
Serves as the default hash function.
(继承自 Object。)
公共方法GetType
Gets the Type of the current instance.
(继承自 Object。)
受保护的方法HslMessageFormat
根据需要存储的日志消息,获取实际存储的字符串,重写本方法就可以自定义输出内容
According to the log message that needs to be stored, get the actual stored string, and the rewrite method can customize the output content
(继承自 LogNetBase。)
受保护的方法MemberwiseClone
Creates a shallow copy of the current Object.
(继承自 Object。)
受保护的方法OnWriteCompleted
当写入文件完成的时候触发,这时候已经释放了文件的句柄了。
Triggered when writing to the file is complete, and the file handle has been released.
(继承自 LogPathBase。)
公共方法RecordMessage
通过指定消息等级,关键字,日志信息进行消息记录
Record messages by specifying message level, keywords, and log information
(继承自 LogNetBase。)
公共方法RemoveFiltrate
移除过滤的关键字存储
Remove filtered keyword storage
(继承自 LogNetBase。)
公共方法SetMessageDegree
设置日志的存储等级,高于该等级的才会被存储
Set the storage level of the logs. Only the logs above this level will be stored.
(继承自 LogNetBase。)
公共方法ToString
Returns a string that represents the current object.
(重写 LogPathBaseToString.)
公共方法WriteAnyString
写入任意字符串
Write arbitrary string
(继承自 LogNetBase。)
公共方法WriteDebug(String)
写入一条调试日志
Write a debug log
(继承自 LogNetBase。)
公共方法WriteDebug(String, String)
写入一条带关键字的调试日志
Write a debug log with keywords
(继承自 LogNetBase。)
公共方法WriteDescrition
写入一条解释性的信息,不属于消息等级控制的范畴
Write an explanatory message that is not part of message level control
(继承自 LogNetBase。)
公共方法WriteError(String)
写入一条错误日志
Write an error log
(继承自 LogNetBase。)
公共方法WriteError(String, String)
写入一条带关键字的错误日志
Write an error log with keywords
(继承自 LogNetBase。)
公共方法WriteException(String, Exception)
写入一条带关键字的异常信息
Write an exception log with keywords
(继承自 LogNetBase。)
公共方法WriteException(String, String, Exception)
写入一条带关键字和描述信息的异常信息
Write an exception log with keywords and text
(继承自 LogNetBase。)
公共方法WriteFatal(String)
写入一条致命日志
Write an fatal log
(继承自 LogNetBase。)
公共方法WriteFatal(String, String)
写入一条带关键字的致命日志
Write an fatal log with keywords
(继承自 LogNetBase。)
公共方法WriteInfo(String)
写入一条普通日志
Write an infomation log
(继承自 LogNetBase。)
公共方法WriteInfo(String, String)
写入一条带关键字的普通日志
Write an information log with keywords
(继承自 LogNetBase。)
公共方法WriteNewLine
写入一行换行符
Write a newline
(继承自 LogNetBase。)
公共方法WriteWarn(String)
写入一条警告日志
Write an warn log
(继承自 LogNetBase。)
公共方法WriteWarn(String, String)
写入一条带关键字的警告日志
Write an warn log with keywords
(继承自 LogNetBase。)
Top
事件
  名称说明
公共事件BeforeSaveToFile
存储之前引发的事件,允许额外的操作,比如打印控制台,存储数据库等等
Store previously raised events, allowing additional operations, such as print console, store database, etc.
(继承自 LogNetBase。)
Top
字段
  名称说明
受保护的字段controlFileQuantity
控制文件的数量,小于1则不进行任何操作,当设置为10的时候,就限制文件数量为10。
Control the number of files. If it is less than 1, no operation is performed. When it is set to 10, the number of files is limited to 10.
(继承自 LogPathBase。)
受保护的字段fileName
当前正在存储的文件名
File name currently being stored
(继承自 LogPathBase。)
受保护的字段filePath
存储文件的路径,如果设置为空,就不进行存储。
The path for storing the file. If it is set to empty, it will not be stored.
(继承自 LogPathBase。)
受保护的字段m_fileSaveLock
文件存储的锁
(继承自 LogNetBase。)
Top
扩展方法
  名称说明
公共扩展器方法ToJsonString
获取当前对象的JSON格式表示的字符串。
Gets the string represented by the JSON format of the current object.
(由 HslExtension 定义。)
Top
备注
此日志实例将根据日期时间来进行分类,支持的时间分类如下:
  1. 分钟
  2. 小时
  3. 月份
  4. 季度
  5. 年份
当然你也可以指定允许存在多少个日志文件,比如我允许存在最多10个文件,如果你的日志是根据天来分文件的,那就是10天的数据。 同理,如果你的日志是根据年来分文件的,那就是10年的日志文件。
示例
日期存储实例化
// 实例化一个日志后,路径是D的一个文件夹,按照每天的规律来存储
ILogNet logNet = new LogNetDateTime( "D:\\Logs", GenerateMode.ByEveryDay );
基本的使用
// 然后我们的代码就可以调用下面的方法来存储日志了,支持下面的5个等级的
logNet.WriteDebug( "Debug log test" );
logNet.WriteInfo( "Info log test" );
logNet.WriteWarn( "Warn log test" );
logNet.WriteError( "Error log test" );
logNet.WriteFatal( "Fatal log test" );

// 还有下面的几种额外的情况
logNet.WriteNewLine( );                       // 追加一行空行
logNet.WriteDescrition( "test" );             // 写入额外的注释的信息
logNet.WriteAnyString( "any string" );        // 写任意的数据,不受格式化影响

// 此处的5个等级有高低之分 debug < info < warn < error < fatal < all
// 如果我们需要屏蔽debug等级的话
logNet.SetMessageDegree( HslMessageDegree.INFO );

// 如果我们需要屏蔽debug及info等级的
logNet.SetMessageDegree( HslMessageDegree.WARN );

// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += (object sender, HslEventArgs e) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );
};

// 带关键字的功能
logNet.WriteDebug( "A","Debug log test" );
logNet.WriteInfo( "B", "Info log test" );
logNet.WriteWarn( "C", "Warn log test" );
logNet.WriteError( "A", "Error log test" );
logNet.WriteFatal( "B", "Fatal log test" );

// 有了关键字之后,我们就可以根据关键字过滤了
logNet.FiltrateKeyword( "B" ); // 我们不需要B的关键字的日志
logNet.RemoveFiltrate( "B" );  // 重新需要B的关键字的日志

// 日志记录时默认获取当前系统的时间,如果需要在记录日志时,所有的时间往后加8小时,则可以这么设置(如果往前,就是负数)
logNet.HourDeviation = 8;
所有日志不存储
// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );

    // 我们接下来举个例子,所有的日志都不存储文件
    e.HslMessage.Cancel = true;
};
仅存储ERROR等级
// 如果所有的日志在记录之前需要在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );

    // 我们接下来举个例子,只有错误(ERROR)的等级才存储文件
    if (e.HslMessage.Degree != HslMessageDegree.ERROR)
    {
        // 这样的操作就导致,不是ERROR等级,全部不存储。但是不影响触发控制台输出
        e.HslMessage.Cancel = true;
    }
};
不指定路径
// 实例化一个日志后,如果不指定路径,那就不会存储文件,但仍然会触发BeforeSaveToFile事件
ILogNet logNet = new LogNetSingle( "" );

// 所有的日志在控制台显示出来
logNet.BeforeSaveToFile += ( object sender, HslEventArgs e ) =>
{
    Console.WriteLine( e.HslMessage.ToString( ) );
};
参见