EntityBase

EntityBase

Class EntityBase

Version:

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

A base class for entities.

Inheritance

System.Object

EntityBase

Implements

IEntity

IResource

IDirtyTracking

Namespace: Stylelabs.M.Sdk.Models.Base

Assembly: Stylelabs.M.Sdk.dll

Syntax

public abstract class EntityBase : object, IEntity, IResource, IDirtyTracking

Constructors

EntityBase(IMClient, EntityConstructionArgs)

Initializes a new instance of the EntityBase class.

Declaration

protected EntityBase(IMClient client, EntityConstructionArgs args)

Parameters

Type	Name	Description
IMClient	client	Client.
EntityConstructionArgs	args	Aggregate of construction parameters

Properties

Client

Declaration

protected IMClient Client { get; }

Property Value

Type	Description
IMClient

CreatedBy

Gets the id of the user who created this resource. null if it has not been created.

Declaration

public long? CreatedBy { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

CreatedOn

Gets the date on which this resource was created. null if it has not been created.

Declaration

public DateTime? CreatedOn { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

Cultures

Gets a list of all cultures that the entity was loaded with. Never returns null. All ICultureSensitiveProperty properties can only contains values for these cultures.

Declaration

public IReadOnlyList<CultureInfo> Cultures { get; }

Property Value

Type	Description
IReadOnlyList<CultureInfo>

DefinitionName

Gets the name of the IEntityDefinition that defines this entity.

Declaration

public string DefinitionName { get; set; }

Property Value

Type	Description
System.String

Id

Gets the id of the entity. The id is an automatically assigned, read only, unique and strictly positive number identifying the entity. The id is null if the entity has not been persisted yet.

Declaration

public long? Id { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

Identifier

Gets the identifier of the entity. The identifier can be set on a new entities, until it is persisted. However, it must always be unique. The identifier will be auto generated when it is null when persisting.

Declaration

public string Identifier { get; set; }

Property Value

Type	Description
System.String

InheritsSecurity

Gets or sets a value indicating whether the entity inherits security from its ancestors connected via relations with InheritsSecurity.

Declaration

public bool InheritsSecurity { get; set; }

Property Value

Type	Description
System.Boolean

IsDirty

Declaration

public bool IsDirty { get; }

Property Value

Type	Description
System.Boolean

IsNew

Declaration

public bool IsNew { get; }

Property Value

Type	Description
System.Boolean

IsPathRoot

Gets or sets a value indicating whether this entity is a top level path.

Declaration

public bool IsPathRoot { get; set; }

Property Value

Type	Description
System.Boolean

IsRootTaxonomyItem

Gets or sets a value indicating whether this entity is a top level facet.

Declaration

public bool IsRootTaxonomyItem { get; set; }

Property Value

Type	Description
System.Boolean

IsSystemOwned

Gets or sets a value indicating whether the entity is owned by the system and cannot be modified or deleted by the regular users.

Declaration

public bool IsSystemOwned { get; set; }

Property Value

Type	Description
System.Boolean

IsTracking

Declaration

public bool IsTracking { get; }

Property Value

Type	Description
System.Boolean

LockedBy

Gets the id of the user who locked this entity. null if it has not been locked.

Declaration

public long? LockedBy { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

LockedOn

Gets the date on which this entity was locked. null if it has not been locked.

Declaration

public DateTime? LockedOn { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

ModifiedBy

Gets the id of the user who modified this resource. null if it has not been created.

Declaration

public long? ModifiedBy { get; set; }

Property Value

Type	Description
System.Nullable<System.Int64>

ModifiedOn

Gets the date on which this resource was modified. null if it has not been created.

Declaration

public DateTime? ModifiedOn { get; set; }

Property Value

Type	Description
System.Nullable<DateTime>

Properties

Gets a list of all properties that are currently loaded on the entity. Never returns null.

Declaration

public IReadOnlyList<IProperty> Properties { get; }

Property Value

Type	Description
IReadOnlyList<IProperty>

Remarks

New properties can still be added by lazy loading them.

Relations

Gets a list of all relations that are currently loaded on the entity. Never returns null.

Declaration

public IReadOnlyList<IRelation> Relations { get; }

Property Value

Type	Description
IReadOnlyList<IRelation>

Remarks

New relations can still be added by lazy loading them.

Renditions

Gets a list of all renditions for this entity. Never returns null.

Declaration

public abstract IReadOnlyList<IRendition> Renditions { get; }

Property Value

Type	Description
IReadOnlyList<IRendition>

Version

Gets the current version of the entity. Version is a monotonically increasing number (from 1 up). Any change(s) of the entity propagated to the persistent storage will cause this number to be incremented.

Declaration

public long Version { get; set; }

Property Value

Type	Description
System.Int64

Methods

CanDoLazyLoading()

Checks if lazy loading is possible. Lazy loading is only possible on persisted entities.

Declaration

public bool CanDoLazyLoading()

Returns

Type	Description
System.Boolean	true if lazy loading is possible.

GetEntityDefinitionAsync()

Gets the IEntityDefinition of the entity. It is loaded once and will cache the result.

Declaration

public Task<IEntityDefinition> GetEntityDefinitionAsync()

Returns

Type	Description
Task<IEntityDefinition>	The entity definition.

GetPermissionsAsync()

Gets the permissions that the current user has on this entity.

Declaration

public abstract Task<ISet<string>> GetPermissionsAsync()

Returns

Type	Description
Task<ISet<System.String>>	A case insensitive set of permissions.

GetProperty(String)

Gets the specified property. Returns null when the property is not found.

Declaration

public IProperty GetProperty(string name)

Parameters

Type	Name	Description
System.String	name	Property name.

Returns

Type	Description
IProperty	The property

GetProperty<T>(String)

Gets the specified property. Returns null when the property is not found.

Declaration

public T GetProperty<T>(string name)
    where T : class, IProperty

Parameters

Type	Name	Description
System.String	name	Property name.

Returns

Type	Description
T	The property

Type Parameters

Name	Description
T

GetPropertyAsync(String, MemberLoadOption)

Gets the specified property. Returns null when the property is not found. However, if the property is not present, it can be lazy loaded.

Declaration

public Task<IProperty> GetPropertyAsync(string name, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name	Property name.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<IProperty>	The property

GetPropertyAsync<T>(String, MemberLoadOption)

Gets the specified property. Returns null when the property is not found. However, if the property is not present, it can be lazy loaded.

Declaration

public Task<T> GetPropertyAsync<T>(string name, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)
    where T : class, IProperty

Parameters

Type	Name	Description
System.String	name	Property name.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<T>	The property

Type Parameters

Name	Description
T	Type of the property.

GetPropertyValue(String)

Gets the value of the specified culture insensitive property. Returns null when the property is not found.

Declaration

public object GetPropertyValue(string name)

Parameters

Type	Name	Description
System.String	name	Property name.

Returns

Type	Description
System.Object	The property

GetPropertyValue(String, CultureInfo)

Gets the value of the specified culture sensitive property. Returns null when the property is not found.

Declaration

public object GetPropertyValue(string name, CultureInfo culture)

Parameters

Type	Name	Description
System.String	name	Property name.
CultureInfo	culture

Returns

Type	Description
System.Object	The property

GetPropertyValue<T>(String)

Gets the value of the specified culture insensitive property and casts it to the corresponding type. Returns null when the property is not found.

Declaration

public T GetPropertyValue<T>(string name)

Parameters

Type	Name	Description
System.String	name	Property name.

Returns

Type	Description
T	The property

Type Parameters

Name	Description
T

GetPropertyValue<T>(String, CultureInfo)

Gets the value of the specified culture sensitive property and casts it to the corresponding type. Returns null when the property is not found.

Declaration

public T GetPropertyValue<T>(string name, CultureInfo culture)

Parameters

Type	Name	Description
System.String	name	Property name.
CultureInfo	culture

Returns

Type	Description
T	The property

Type Parameters

Name	Description
T

GetPropertyValueAsync(String, CultureInfo, MemberLoadOption)

Declaration

public Task<object> GetPropertyValueAsync(string name, CultureInfo culture, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name
CultureInfo	culture
MemberLoadOption	loadOption

Returns

Type	Description
Task<System.Object>

GetPropertyValueAsync(String, MemberLoadOption)

Gets the value of the specified culture insensitive property and casts it to the corresponding type. If the property is not present, it can be lazy loaded.

Declaration

public Task<object> GetPropertyValueAsync(string name, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name	Property name.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<System.Object>	Value of the property. If the property does not exist or is not loaded, it returns null.

GetPropertyValueAsync<T>(String, CultureInfo, MemberLoadOption)

Gets the value of the specified culture sensitive property and converts it to the corresponding type. If the property is not present, it can be lazy loaded.

Declaration

public Task<T> GetPropertyValueAsync<T>(string name, CultureInfo culture, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name	Property name.
CultureInfo	culture	Culture of the value.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<T>	Value of the property in specified culture. If the property does not exist or is not loaded, it returns null.

Type Parameters

Name	Description
T	Type of the value.

GetPropertyValueAsync<T>(String, MemberLoadOption)

Gets the value of the specified culture insensitive property and casts it to the corresponding type. If the property is not present, it can be lazy loaded.

Declaration

public Task<T> GetPropertyValueAsync<T>(string name, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name	Property name.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<T>	Value of the property. If the property does not exist or is not loaded, it returns null.

Type Parameters

Name	Description
T	Type of the value.

GetRelation(String, Nullable<RelationRole>)

Gets a relation by name. Returns null when the relation was not found.

Declaration

public IRelation GetRelation(string name, RelationRole? role = null)

Parameters

Type	Name	Description
System.String	name	Name of the relation.
System.Nullable<RelationRole>	role

Returns

Type	Description
IRelation	The relation

GetRelation<T>(String)

Gets a relation by name and tries to resolve the role automatically by the specified interface. Returns null when the relation was not found.

Declaration

public T GetRelation<T>(string name)
    where T : class, IRelation

Parameters

Type	Name	Description
System.String	name	Name of the relation.

Returns

Type	Description
T	The relation

Type Parameters

Name	Description
T

GetRelationAsync(String, Nullable<RelationRole>, MemberLoadOption)

Gets the relation from the entity. Returns null when the relation was not found. However, when the relation is not present, it can be lazy loaded.

Declaration

public Task<IRelation> GetRelationAsync(string name, RelationRole? role = null, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)

Parameters

Type	Name	Description
System.String	name	Relation name.
System.Nullable<RelationRole>	role	The role of the relation.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<IRelation>	The relation or null when it does not exist or is not lazy loaded.

GetRelationAsync<T>(String, MemberLoadOption)

Gets a relation by name and tries to resolve the role automatically by the specified interface. Returns null when the relation was not found. If the relation is not present, it can be lazy loaded.

Declaration

public Task<T> GetRelationAsync<T>(string name, MemberLoadOption loadOption = MemberLoadOption.LazyLoading)
    where T : class, IRelation

Parameters

Type	Name	Description
System.String	name	Relation name.
MemberLoadOption	loadOption	Enables (default) or disables lazy loading.

Returns

Type	Description
Task<T>	The relation or null when it does not exist or is not lazy loaded.

Type Parameters

Name	Description
T	Type of relation.

GetRendition(String)

Gets an IRendition by name.

Declaration

public abstract IRendition GetRendition(string name)

Parameters

Type	Name	Description
System.String	name	Name of the rendition

Returns

Type	Description
IRendition	The rendition or null when it does not exist.

LoadMembersAsync(IPropertyLoadOption, IRelationLoadOption)

Loads the specified members on the current entity. It will only load if it is actually missing members and does not overwrite existing members.

Declaration

public Task<bool> LoadMembersAsync(IPropertyLoadOption propertyLoadOption, IRelationLoadOption relationLoadOption)

Parameters

Type	Name	Description
IPropertyLoadOption	propertyLoadOption	Properties to load.
IRelationLoadOption	relationLoadOption	Relations to load.

Returns

Type	Description
Task<System.Boolean>	true if new members were added on the current entity.

Remarks

Culture sensitive properties will only be loaded in the current cultures. Lazy loading is only possible on entities that are not new.

LoadPropertiesAsync(IPropertyLoadOption)

Loads the specified properties on the current entity. It will only load if it is actually missing properties and does not overwrite existing properties.

Declaration

public Task<bool> LoadPropertiesAsync(IPropertyLoadOption propertyLoadOption)

Parameters

Type	Name	Description
IPropertyLoadOption	propertyLoadOption	Properties to load.

Returns

Type	Description
Task<System.Boolean>	true if new properties were added on the current entity.

Remarks

Culture sensitive properties will only be loaded in the current cultures. Lazy loading is only possible on entities that are not new.

LoadRelationsAsync(IRelationLoadOption)

Loads the specified relations on the current entity. It will only load if it is actually missing relations and does not overwrite existing relations.

Declaration

public Task<bool> LoadRelationsAsync(IRelationLoadOption relationLoadOption)

Parameters

Type	Name	Description
IRelationLoadOption	relationLoadOption	Relations to load.

Returns

Type	Description
Task<System.Boolean>	true if new members were added on the current entity.

Remarks

Lazy loading is only possible on entities that are not new.

MarkClean()

Declaration

public void MarkClean()

SetPropertyValue(String, CultureInfo, Object)

Sets the value of specified culture sensitive property.

Declaration

public void SetPropertyValue(string name, CultureInfo culture, object value)

Parameters

Type	Name	Description
System.String	name	Property name.
CultureInfo	culture	Culture of the value
System.Object	value	Property value.

Exceptions

Type	Condition
PropertyNotFoundException	When the property does not exist or was not loaded.

SetPropertyValue(String, Object)

Sets the value of specified culture insensitive property.

Declaration

public void SetPropertyValue(string name, object value)

Parameters

Type	Name	Description
System.String	name	Property name.
System.Object	value	Property value.

Exceptions

Type	Condition
PropertyNotFoundException	When the property does not exist or was not loaded.

StartTracking()

Starts tracking the object for changes.

Declaration

public void StartTracking()

Implements

IEntity

IResource

IDirtyTracking

この記事を改善するための提案がある場合は、お知らせください!

Class EntityBase

Inheritance

Implements

Namespace: Stylelabs.M.Sdk.Models.Base

Assembly: Stylelabs.M.Sdk.dll

Syntax

Constructors

EntityBase(IMClient, EntityConstructionArgs)

Declaration

Parameters

Properties

Client

Declaration

Property Value

CreatedBy

Declaration

Property Value

CreatedOn

Declaration

Property Value

Cultures

Declaration

Property Value

DefinitionName

Declaration

Property Value

Id

Declaration

Property Value

Identifier

Declaration

Property Value

InheritsSecurity

Declaration

Property Value

IsDirty

Declaration

Property Value

IsNew

Declaration

Property Value

IsPathRoot

Declaration

Property Value

See Also

IsRootTaxonomyItem

Declaration

Property Value

See Also

IsSystemOwned

Declaration

Property Value

IsTracking

Declaration

Property Value

LockedBy

Declaration

Property Value

LockedOn

Declaration

Property Value

ModifiedBy

Declaration

Property Value

ModifiedOn

Declaration

Property Value

Properties

Declaration

Property Value

Remarks

Relations

Declaration

Property Value

Remarks

Renditions

Declaration

Property Value

Version

Declaration