Class KeyFactory (3.4.0)

Version 3.4.0

• 4.14.0 (latest)
• 4.13.0
• 4.12.0
• 4.11.0
• 4.10.0
• 4.9.0
• 4.8.0
• 4.7.0
• 4.6.0
• 4.5.0
• 4.4.0
• 4.3.0
• 4.2.0
• 4.1.0
• 4.0.0
• 3.5.0
• 3.4.0
• 3.3.0
• 3.2.0

public sealed class KeyFactory

Provides a convenient way of producing keys of a specific kind, from a specified parent entity or key, or for root entities based on a partition ID.

Inheritance

Object > KeyFactory

Inherited Members

Object.GetHashCode()

Object.GetType()

Object.MemberwiseClone()

Object.ToString()

Namespace

Google.Cloud.Datastore.V1

Assembly

Google.Cloud.Datastore.V1.dll

Remarks

If the key factory is constructed with just a partition ID and kind, then the parent key has an empty path, and all keys created by the factory will be root keys. Otherwise, all keys created by the factory will be direct children of the parent key, so both the parent key itself and any ancestors of that key will be ancestors of the child key. Ancestors can be determined in queries using HasAncestor(Key).

Constructors

KeyFactory(Entity, String)

public KeyFactory(Entity parent, string kind)

Creates a key factory for children of the given key. Keys created by the new factory will have the same path as this key, but with one extra path element.

Parameters
Name	Description
parent	Entity The "parent" entity for keys created by the new factory. Must not be null, and must have a key.
kind	String The kind of child entity keys to create. Must not be null.

Remarks

The entity key is cloned before being stored, so may be mutated after the factory is constructed without affecting the factory.

KeyFactory(Key, String)

public KeyFactory(Key parent, string kind)

Creates a key factory for children of the given key. Keys created by the new factory will have the same path as this key, but with one extra path element.

Parameters
Name	Description
parent	Key The "parent" key for keys created by the new factory. Must not be null.
kind	String The kind of child entity keys to create. Must not be null.

Remarks

The key is cloned before being stored, so may be mutated after the factory is constructed without affecting the factory.

KeyFactory(PartitionId, String)

public KeyFactory(PartitionId partitionId, string kind)

Creates a key factory for the root of a partition.

Parameters
Name	Description
partitionId	PartitionId The partition ID for the factory. Must not be null.
kind	String The kind of root entity keys to create. Must not be null.

KeyFactory(String, String, String)

public KeyFactory(string projectId, string namespaceId, string kind)

Creates a key factory for the root of a partition.

Parameters
Name	Description
projectId	String The project ID for the factory. Must not be null.
namespaceId	String The namespace ID for the factory. May be null in which case an empty string is used.
kind	String The kind of root entity keys to create. Must not be null.

Methods

CreateIncompleteKey()

public Key CreateIncompleteKey()

Creates a key with only the kind specified in the final path element, intended for insertions where the ID is populated by the server.

Returns
Type	Description
Key	A key with no name or ID in the final path element.

CreateKey(Int64)

public Key CreateKey(long id)

Creates a key for the given entity ID.

Parameter
Name	Description
id	Int64 The numeric entity ID.

Returns
Type	Description
Key	A key whose final path element contains the given ID.

CreateKey(String)

public Key CreateKey(string name)

Creates a key for the given entity name.

Parameter
Name	Description
name	String The entity name. Must not be null.

Returns
Type	Description
Key	A key whose final path element contains the given name.