IModel.RelateByFieldTag method
Namespace: NextDesign.Core
Description
Returns a collection of all related instances that have been added by associating the given model with a reference field given the specified tag of this instance.
If a model that has been deleted or a temporary proxy is specified as the model to be associated, the association will not be performed.
Returns an empty collection if no association was made.
This method excludes fields from association that do not meet the following constraints:
[constraint to evaluate]
- Path constraints
- type constraints
- Multiplicity upper bound
- Operation availability
argument
| Name | Type | Description |
|---|---|---|
| opposite | IModel | The associated model Cannot be null. |
| fieldTag | string | Field tag name If null or an empty string is specified, the return value of this method will be an empty collection. |
| value | string | The string representation of the tag value The default value is null. If null or an empty string is specified, only the presence or absence of a tag for the field is evaluated. |
Return value
- IRelationshipCollection
Exceptions
| Name | Exception Class | Description |
|---|---|---|
| Invalid argument | ExtensionArgumentException | If null is specified for opposite |
| Illegal operation | ExtensionInvalidOperationException | If self is deleted model, temporary proxy |