点击或拖拽改变大小

LogNetFileSize 类

根据文件的大小来存储日志信息,当前的文件大小增长超过设定值,就会创建新的文件来存储,新的文件命名为当前时间。
Log information is stored according to the size of the file. If the current file size exceeds the set value, a new file is created for storage, and the new file is named the current time.
继承层次
SystemObject
  HslCommunication.LogNetLogNetBase
    HslCommunication.LogNetLogPathBase
      HslCommunication.LogNetLogNetFileSize

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

LogNetFileSize 类型公开以下成员。

构造函数
  名称说明
公共方法LogNetFileSize
实例化一个根据文件大小生成新文件的,默认是2M大的文件
Instantiate a new file based on the file size. The default is 2M.
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 (继承自 LogNetBase。)
受保护的方法Dispose(Boolean)
释放资源
(继承自 LogNetBase。)
公共方法Equals (继承自 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 (继承自 Object。)
公共方法GetExistLogFileNames
返回所有的日志文件名称,返回一个列表
Returns all log file names, returns a list
(继承自 LogPathBase。)
受保护的方法GetFileSaveName (重写 LogNetBaseGetFileSaveName.)
公共方法GetHashCode (继承自 Object。)
公共方法GetType (继承自 Object。)
受保护的方法MemberwiseClone (继承自 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 (重写 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
备注
此日志的实例是根据文件的大小储存,例如设置了2M,每隔2M,系统将生成一个新的日志文件。当然你也可以指定允许存在多少个日志文件, 比如我允许存在最多10个文件,那总量就是20M,旧的文件会被删除掉。
示例
限制文件大小实例化
// 实例化一个日志后,路径是D的一个文件夹,大小为2M
ILogNet logNet = new LogNetFileSize( "D:\\Logs", 2 * 1024 * 1024 );
基本的使用
// 然后我们的代码就可以调用下面的方法来存储日志了,支持下面的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( ) );
};
参见