Class InstanceIdentifier

The identifier used to distinguish the instances of the same type. Used mostly for logging and debugging.

Inheritance
System.Object
InstanceIdentifier
Implements
System.IEquatable<InstanceIdentifier>
Inherited Members
System.Object.Equals(System.Object, System.Object)
System.Object.GetType()
System.Object.MemberwiseClone()
System.Object.ReferenceEquals(System.Object, System.Object)
Namespace: Silverback
Assembly: Silverback.Core.dll
Syntax
public sealed class InstanceIdentifier : IEquatable<InstanceIdentifier>
Remarks

Using this class instead of a System.Guid allocates more memory (about 152 bytes, instead of the 16 bytes used by a System.Guid) because the value is stored directly as string to avoid extra allocations in the ToString() method (e.g. when writing to a log).

This is also a reference type and passing is around requires less allocations.

Constructors

| Improve this doc View source

InstanceIdentifier(Nullable<Guid>)

Initializes a new instance of the InstanceIdentifier class.

Declaration
public InstanceIdentifier(Guid? value = null)
Parameters
Type Name Description
System.Nullable<System.Guid> value

The System.Guid representing the identifier value. If null a random one will be generated.

Properties

| Improve this doc View source

Value

Gets the identifier.

Declaration
public string Value { get; }
Property Value
Type Description
System.String

Methods

| Improve this doc View source

Equals(InstanceIdentifier)

Declaration
public bool Equals(InstanceIdentifier other)
Parameters
Type Name Description
InstanceIdentifier other
Returns
Type Description
System.Boolean
| Improve this doc View source

Equals(Object)

Declaration
public override bool Equals(object obj)
Parameters
Type Name Description
System.Object obj
Returns
Type Description
System.Boolean
Overrides
System.Object.Equals(System.Object)
| Improve this doc View source

GetHashCode()

Declaration
public override int GetHashCode()
Returns
Type Description
System.Int32
Overrides
System.Object.GetHashCode()
| Improve this doc View source

ToString()

Converts the InstanceIdentifier to a string.

Declaration
public override string ToString()
Returns
Type Description
System.String

The identifier value.
Overrides
System.Object.ToString()

Operators

| Improve this doc View source

Equality(InstanceIdentifier, InstanceIdentifier)

Declaration
public static bool operator ==(InstanceIdentifier left, InstanceIdentifier right)
Parameters
Type Name Description
InstanceIdentifier left
InstanceIdentifier right
Returns
Type Description
System.Boolean
| Improve this doc View source

Implicit(InstanceIdentifier to String)

Converts the InstanceIdentifier to a string.

Declaration
public static implicit operator string (InstanceIdentifier identifier)
Parameters
Type Name Description
InstanceIdentifier identifier

The InstanceIdentifier to be converted.
Returns
Type Description
System.String

The identifier value.
| Improve this doc View source

Inequality(InstanceIdentifier, InstanceIdentifier)

Declaration
public static bool operator !=(InstanceIdentifier left, InstanceIdentifier right)
Parameters
Type Name Description
InstanceIdentifier left
InstanceIdentifier right
Returns
Type Description
System.Boolean

Implements

System.IEquatable<T>