Class SubmodelElementList

A submodel element list is an ordered list of submodel elements.

Inheritance

System.Object

SubmodelElementList

Implements

ISubmodelElementList

ISubmodelElement

IReferable

IHasExtensions

IHasKind

IHasSemantics

IQualifiable

IHasDataSpecification

IClass

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ReferenceEquals(System.Object, System.Object)

System.Object.ToString()

Namespace: AasCore.Aas3_0_RC02

Assembly: AasCore.Aas3_0_RC02.dll

Syntax

public class SubmodelElementList : ISubmodelElementList, ISubmodelElement, IReferable, IHasExtensions, IHasKind, IHasSemantics, IQualifiable, IHasDataSpecification, IClass

Remarks

The numbering starts with zero (0).

Constraints:

• Constraint AASd-107: If a first level child element in a SubmodelElementList has a SemanticId it shall be identical to SemanticIdListElement.
• Constraint AASd-114: If two first level child elements in a SubmodelElementList have a SemanticId then they shall be identical.
• Constraint AASd-115: If a first level child element in a SubmodelElementList does not specify a SemanticId then the value is assumed to be identical to SemanticIdListElement.
• Constraint AASd-108: All first level child elements in a SubmodelElementList shall have the same submodel element type as specified in TypeValueListElement.
• Constraint AASd-109: If TypeValueListElement is equal to Property or Range ValueTypeListElement shall be set and all first level child elements in the SubmodelElementList shall have the value type as specified in ValueTypeListElement.

Constructors

SubmodelElementList(AasSubmodelElements, List<IExtension>, String, String, List<ILangString>, List<ILangString>, String, Nullable<ModelingKind>, IReference, List<IReference>, List<IQualifier>, List<IEmbeddedDataSpecification>, Nullable<Boolean>, List<ISubmodelElement>, IReference, Nullable<DataTypeDefXsd>)

Declaration

public SubmodelElementList(AasSubmodelElements typeValueListElement, List<IExtension> extensions = null, string category = null, string idShort = null, List<ILangString> displayName = null, List<ILangString> description = null, string checksum = null, ModelingKind? kind = null, IReference semanticId = null, List<IReference> supplementalSemanticIds = null, List<IQualifier> qualifiers = null, List<IEmbeddedDataSpecification> embeddedDataSpecifications = null, bool? orderRelevant = null, List<ISubmodelElement> value = null, IReference semanticIdListElement = null, DataTypeDefXsd? valueTypeListElement = null)

Parameters

Type	Name	Description
AasSubmodelElements	typeValueListElement
System.Collections.Generic.List<IExtension>	extensions
System.String	category
System.String	idShort
System.Collections.Generic.List<ILangString>	displayName
System.Collections.Generic.List<ILangString>	description
System.String	checksum
System.Nullable<ModelingKind>	kind
IReference	semanticId
System.Collections.Generic.List<IReference>	supplementalSemanticIds
System.Collections.Generic.List<IQualifier>	qualifiers
System.Collections.Generic.List<IEmbeddedDataSpecification>	embeddedDataSpecifications
System.Nullable<System.Boolean>	orderRelevant
System.Collections.Generic.List<ISubmodelElement>	value
IReference	semanticIdListElement
System.Nullable<DataTypeDefXsd>	valueTypeListElement

Properties

Category

The category is a value that gives further meta information w.r.t. to the class of the element. It affects the expected existence of attributes and the applicability of constraints.

Declaration

public string Category { get; set; }

Property Value

Type	Description
System.String

Remarks

The category is not identical to the semantic definition (IHasSemantics) of an element. The category e.g. could denote that the element is a measurement value whereas the semantic definition of the element would denote that it is the measured temperature.

Checksum

Checksum to be used to determine if an Referable (including its aggregated child elements) has changed.

Declaration

public string Checksum { get; set; }

Property Value

Type	Description
System.String

Remarks

The checksum is calculated by the user's tool environment. The checksum has no semantic meaning for an asset administration shell model and there is no requirement for asset administration shell tools to manage the checksum

Description

Description or comments on the element.

Declaration

public List<ILangString> Description { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<ILangString>

Remarks

The description can be provided in several languages.

If no description is defined, then the definition of the concept description that defines the semantics of the element is used.

Additional information can be provided, e.g., if the element is qualified and which qualifier types can be expected in which context or which additional data specification templates are provided.

DisplayName

Display name. Can be provided in several languages.

Declaration

public List<ILangString> DisplayName { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<ILangString>

Remarks

If no display name is defined in the language requested by the application, then the display name is selected in the following order if available:

• the preferred name in the requested language of the concept description defining the semantics of the element
• If there is a default language list defined in the application, then the corresponding preferred name in the language is chosen according to this order.
• the English preferred name of the concept description defining the semantics of the element
• the short name of the concept description
• the IdShort of the element

EmbeddedDataSpecifications

Embedded data specification.

Declaration

public List<IEmbeddedDataSpecification> EmbeddedDataSpecifications { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<IEmbeddedDataSpecification>

Extensions

An extension of the element.

Declaration

public List<IExtension> Extensions { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<IExtension>

IdShort

In case of identifiables this attribute is a short name of the element. In case of referable this ID is an identifying string of the element within its name space.

Declaration

public string IdShort { get; set; }

Property Value

Type	Description
System.String

Remarks

In case the element is a property and the property has a semantic definition (SemanticId) conformant to IEC61360 the IdShort is typically identical to the short name in English.

Kind

Kind of the element: either type or instance.

Declaration

public ModelingKind? Kind { get; set; }

Property Value

Type	Description
System.Nullable<ModelingKind>

Remarks

Default: Instance

OrderRelevant

Defines whether order in list is relevant. If OrderRelevant = False then the list is representing a set or a bag.

Declaration

public bool? OrderRelevant { get; set; }

Property Value

Type	Description
System.Nullable<System.Boolean>

Remarks

Default: True

Qualifiers

Additional qualification of a qualifiable element.

Declaration

public List<IQualifier> Qualifiers { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<IQualifier>

Remarks

Constraints:

• Constraint AASd-021: Every qualifiable can only have one qualifier with the same Type.

SemanticId

Identifier of the semantic definition of the element. It is called semantic ID of the element or also main semantic ID of the element.

Declaration

public IReference SemanticId { get; set; }

Property Value

Type	Description
IReference

Remarks

It is recommended to use a global reference.

SemanticIdListElement

Semantic ID the submodel elements contained in the list match to.

Declaration

public IReference SemanticIdListElement { get; set; }

Property Value

Type	Description
IReference

Remarks

It is recommended to use a global reference.

SupplementalSemanticIds

Identifier of a supplemental semantic definition of the element. It is called supplemental semantic ID of the element.

Declaration

public List<IReference> SupplementalSemanticIds { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<IReference>

Remarks

It is recommended to use a global reference.

TypeValueListElement

The submodel element type of the submodel elements contained in the list.

Declaration

public AasSubmodelElements TypeValueListElement { get; set; }

Property Value

Type	Description
AasSubmodelElements

Value

Submodel element contained in the list.

Declaration

public List<ISubmodelElement> Value { get; set; }

Property Value

Type	Description
System.Collections.Generic.List<ISubmodelElement>

Remarks

The list is ordered.

ValueTypeListElement

The value type of the submodel element contained in the list.

Declaration

public DataTypeDefXsd? ValueTypeListElement { get; set; }

Property Value

Type	Description
System.Nullable<DataTypeDefXsd>

Methods

Accept(Visitation.IVisitor)

Accept the visitor to visit this instance for double dispatch.

Declaration

public void Accept(Visitation.IVisitor visitor)

Parameters

Type	Name	Description
Visitation.IVisitor	visitor

Accept<TContext>(Visitation.IVisitorWithContext<TContext>, TContext)

Accept the visitor to visit this instance for double dispatch with the context.

Declaration

public void Accept<TContext>(Visitation.IVisitorWithContext<TContext> visitor, TContext context)

Parameters

Type	Name	Description
Visitation.IVisitorWithContext<TContext>	visitor
TContext	context

Type Parameters

Name	Description
TContext

Descend()

Iterate recursively over all the class instances referenced from this instance.

Declaration

public IEnumerable<IClass> Descend()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IClass>

DescendOnce()

Iterate over all the class instances referenced from this instance without further recursion.

Declaration

public IEnumerable<IClass> DescendOnce()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IClass>

KindOrDefault()

Return the Kind or the default value if it has not been set.

Declaration

public ModelingKind KindOrDefault()

Returns

Type	Description
ModelingKind

OrderRelevantOrDefault()

Return the OrderRelevant or the default value if it has not been set.

Declaration

public bool OrderRelevantOrDefault()

Returns

Type	Description
System.Boolean

OverDescriptionOrEmpty()

Iterate over Description, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<ILangString> OverDescriptionOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<ILangString>

OverDisplayNameOrEmpty()

Iterate over DisplayName, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<ILangString> OverDisplayNameOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<ILangString>

OverEmbeddedDataSpecificationsOrEmpty()

Iterate over EmbeddedDataSpecifications, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<IEmbeddedDataSpecification> OverEmbeddedDataSpecificationsOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IEmbeddedDataSpecification>

OverExtensionsOrEmpty()

Iterate over Extensions, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<IExtension> OverExtensionsOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IExtension>

OverQualifiersOrEmpty()

Iterate over Qualifiers, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<IQualifier> OverQualifiersOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IQualifier>

OverSupplementalSemanticIdsOrEmpty()

Iterate over SupplementalSemanticIds, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<IReference> OverSupplementalSemanticIdsOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<IReference>

OverValueOrEmpty()

Iterate over Value, if set, and otherwise return an empty enumerable.

Declaration

public IEnumerable<ISubmodelElement> OverValueOrEmpty()

Returns

Type	Description
System.Collections.Generic.IEnumerable<ISubmodelElement>

Transform<T>(Visitation.ITransformer<T>)

Accept the transformer to transform this instance for double dispatch.

Declaration

public T Transform<T>(Visitation.ITransformer<T> transformer)

Parameters

Type	Name	Description
Visitation.ITransformer<T>	transformer

Returns

Type	Description
T

Type Parameters

Name	Description
T

Transform<TContext, T>(Visitation.ITransformerWithContext<TContext, T>, TContext)

Accept the transformer to visit this instance for double dispatch with the context.

Declaration

public T Transform<TContext, T>(Visitation.ITransformerWithContext<TContext, T> transformer, TContext context)

Parameters

Type	Name	Description
Visitation.ITransformerWithContext<TContext, T>	transformer
TContext	context

Returns

Type	Description
T

Type Parameters

Name	Description
TContext
T

Implements

ISubmodelElementList

ISubmodelElement

IReferable

IHasExtensions

IHasKind

IHasSemantics

IQualifiable

IHasDataSpecification

IClass