AuditValues Enumeration

Assembly: CodeEffects.Rule.Audit.dll
Namespace: CodeEffects.Rule.Audit

Summary

Specifies which values of the evaluated object a record holds.

Syntax

public enum AuditValues
{
	// Only the values the engine read. The default
	Read = 0,

	// Also every field the source object declares, kept apart from the values read
	AllFields = 1
}

Remarks

Set it through the RecordValues property of AuditSettings.

Read records the values that decided the evaluation: all that is needed to replay it, and nothing that a skipped branch never reached. Recording reads nothing that the engine did not read.

AllFields also records every field that the source version declares, which is what the Fields View of the Rule Repository shows: fields, collections and the fields of their items, never methods. The values are taken before the rule runs, so the record holds the whole case, and a test saved from it can run any rule. Audit calls property getters that the rule did not call, on the evaluating thread, in every resilience mode. Do not use it for a source object whose properties load data lazily, such as an Entity Framework navigation property, or whose getters are expensive. A getter that throws is recorded as that member's error and the evaluation goes on. Collections are cut at MaxCollectionItems.

What the setters of an execution-type rule set is recorded in either case. Members listed in ExcludedMembers are never recorded.

The numeric values are permanent.