| documentKeyMask | A document key mask. |
Invalidate all properties stored from multiple documents that match a document key mask.
This operation is slower than the simpler PropertyDatabase.Invalidate since we cannot rely on a binary search to find all keys that match the mask.
// Store properties of multiple documents.
for (ulong i = 0; i < 10; ++i)
{
for (var j = 0; j < 10; ++j)
propertyDatabase.Store(i, PropertyDatabase.CreatePropertyHash($"prop{j}"), $"value{j}");
}
// Invalidate all documents that match any set bits of the mask.
ulong invalidatedDocumentMask = 2;
propertyDatabase.InvalidateMask(invalidatedDocumentMask);
// The invalidated documents can no longer be retrieved.
for (ulong i = 0; i < 10; ++i)
{
if ((i & invalidatedDocumentMask) == 0)
continue;
if (propertyDatabase.TryLoad(i, out IEnumerable<object> invalidatedDocumentValues))
Assert.Fail("TryLoad should have failed to retrieve the invalidated document values.");
}
See Also: PropertyDatabase.CreateDocumentKey.