Method AppendSemanticParameter

AppendSemanticParameter(SemanticParameterKind, string, string, string, int)

Appends a parameter of string type to the current StringBuilder. Back-ends that support semantic logging may store the parameter value semantically instead of appending it to the StringBuilder.

Declaration

protected override void AppendSemanticParameter(SemanticParameterKind kind, string name, string value, string prefix = null, int index = -1)

Parameters

Type	Name	Description
SemanticParameterKind	kind	Kind of semantic parameter.
string	name	Parameter name. The `name` parameter itself is not guaranteed to be unique in a given record. However, in combination with `prefix` and `index`, it is guaranteed to be unique.
string	value	Parameter value.
string	prefix	Prefix to be prepended to `name`, or `null` if there is no prefix.
int	index	Index of the parameter value, if there are several values for the same parameter name, or `-1` if there is a single parameter value for this parameter name.

Overrides

TextLogRecordBuilder.AppendSemanticParameter(SemanticParameterKind, string, string, string, int)

AppendSemanticParameter<T>(SemanticParameterKind, string, T, IFormatter<T>, string, int)

Appends a parameter to the current StringBuilder, where the name is given as a string, and uses a specific formatter. Back-ends that support semantic logging may store the parameter value semantically instead of appending it to the StringBuilder. This method overload is strongly typed.

Declaration

protected override void AppendSemanticParameter<T>(SemanticParameterKind kind, string name, T value, IFormatter<T> formatter, string prefix = null, int index = -1)

Parameters

Type	Name	Description
SemanticParameterKind	kind	Kind of semantic parameter.
string	name	Parameter name. The `name` parameter itself is not guaranteed to be unique in a given record. However, in combination with `prefix` and `index`, it is guaranteed to be unique.
T	value	Parameter value.
IFormatter<T>	formatter	The formatter to be used to format `value`.
string	prefix	Prefix to be prepended to `name`, or `null` if there is no prefix.
int	index	Index of the parameter value, if there are several values for the same parameter name, or `-1` if there is a single parameter value for this parameter name.

Type Parameters

Name	Description
T

Overrides

TextLogRecordBuilder.AppendSemanticParameter<T>(SemanticParameterKind, string, T, IFormatter<T>, string, int)

AppendSemanticParameter(SemanticParameterKind, string, object, IFormatter, string, int)

Appends a parameter to the current StringBuilder, where the name is given as a string, and uses a specific formatter. Back-ends that support semantic logging may store the parameter value semantically instead of appending it to the StringBuilder. This method overload is weakly typed.

Declaration

protected override void AppendSemanticParameter(SemanticParameterKind kind, string name, object value, IFormatter formatter, string prefix = null, int index = -1)

Parameters

Type	Name	Description
SemanticParameterKind	kind	Kind of semantic parameter.
string	name	Parameter name. The `name` parameter itself is not guaranteed to be unique in a given record. However, in combination with `prefix` and `index`, it is guaranteed to be unique.
object	value	Parameter value.
IFormatter	formatter	The formatter to be used to format `value`.
string	prefix	Prefix to be prepended to `name`, or `null` if there is no prefix.
int	index	Index of the parameter value, if there are several values for the same parameter name, or `-1` if there is a single parameter value for this parameter name.

Overrides

TextLogRecordBuilder.AppendSemanticParameter(SemanticParameterKind, string, object, IFormatter, string, int)

AppendSemanticParameter<T>(SemanticParameterKind, ArraySegment<char>, T, IFormatter<T>, string, int)

Appends a parameter to the current StringBuilder, where the name is given as a ArraySegment<T>, and uses a specific formatter. Back-ends that support semantic logging may store the parameter value semantically instead of appending it to the StringBuilder.

Declaration

protected override void AppendSemanticParameter<T>(SemanticParameterKind kind, ArraySegment<char> name, T value, IFormatter<T> formatter, string prefix = null, int index = -1)

Parameters

Type	Name	Description
SemanticParameterKind	kind	Kind of semantic parameter.
ArraySegment<char>	name	Parameter name. The `name` parameter itself is not guaranteed to be unique in a given record. However, in combination with `prefix` and `index`, it is guaranteed to be unique.
T	value	Parameter value.
IFormatter<T>	formatter	The formatter to be used to format `value`.
string	prefix	Prefix to be prepended to `name`, or `null` if there is no prefix.
int	index	Index of the parameter value, if there are several values for the same parameter name, or `-1` if there is a single parameter value for this parameter name.

Type Parameters

Name	Description
T

Overrides

TextLogRecordBuilder.AppendSemanticParameter<T>(SemanticParameterKind, ArraySegment<char>, T, IFormatter<T>, string, int)