---
title: "Class RelationBase"
slug: "sdk--stylelabs.m.sdk.models.base.relationbase"
abstract: ""
---
# Class RelationBase

Base class for relations.

## Inheritance

object

[MemberBase](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

RelationBase

[ChildRelationBase](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.childrelationbase.html)

## Implements

[IRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.irelation.html)

[IMember](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.imember.html)

[IDirtyTracking](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.dirtytracking.idirtytracking.html)

## Inherited Members

[MemberBase.Name](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

[MemberBase.IsTracking](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

[MemberBase.IsDirty](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

[MemberBase.StartTracking()](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

[MemberBase.MarkClean()](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

## Namespace: StylelabsStylelabs.MSdkStylelabs.M.Sdk.ModelsBase

## Assembly: Stylelabs.M.Sdk.dll

## Syntax

```csharp
public abstract class RelationBase : MemberBase, IRelation, IMember, IDirtyTracking
```

## Constructors

### RelationBase(IMClient, string, IDictionary<long, IDictionary<string, JToken>>)

Initializes a new instance of the [RelationBase](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.relationbase.html) class.

#### Declaration

```csharp
protected RelationBase(IMClient client, string name, IDictionary<long, IDictionary<string, JToken>> properties = null)
```

#### Parameters

| Type | Name | Description |
| --- | --- | --- |
| [IMClient](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.imclient.html) | client | The [IMClient](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.imclient.html) instance. |
| string | name | The name of the relation. |
| IDictionary<, >longIDictionary<, >stringJToken | properties | The properties of the linked entity. |

### RelationBase(string, IDictionary<long, IDictionary<string, JToken>>)

Initializes a new instance of the [RelationBase](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.relationbase.html) class.

#### Declaration

```csharp
protected RelationBase(string name, IDictionary<long, IDictionary<string, JToken>> properties = null)
```

#### Parameters

| Type | Name | Description |
| --- | --- | --- |
| string | name | The name of the relation. |
| IDictionary<, >longIDictionary<, >stringJToken | properties | The properties of the linked entity. |

## Properties

### DefinitionType

Gets the definition type.

#### Declaration

```csharp
public override MemberDefinitionType DefinitionType { get; }
```

#### Property Value

| Type | Description |
| --- | --- |
| [MemberDefinitionType](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.memberdefinitiontype.html) |  |

#### Overrides

[MemberBase.DefinitionType](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.models.base.memberbase.html)

### Properties

Gets the properties of the linked entity.

#### Declaration

```csharp
public IDictionary<long, IDictionary<string, JToken>> Properties { get; }
```

#### Property Value

| Type | Description |
| --- | --- |
| IDictionary<, >longIDictionary<, >stringJToken |  |

### [Role](https://doc.sitecore.com/ch/en/developers/api-reference/web-sdk--stylelabs.m.sdk.resources.base.role.html)

Gets the role of this instance in the relation.

#### Declaration

```csharp
public abstract RelationRole Role { get; }
```

#### Property Value

| Type | Description |
| --- | --- |
| [RelationRole](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.framework.essentials.loadoptions.relationrole.html) |  |

## Methods

### Clear()

Clears the value(s) of the relation.

#### Declaration

```csharp
public abstract void Clear()
```

### GetIds()

This utility method allows getting the value of any type of relation.

In case of an [IToManyRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itomanyrelation.html) the result will contain all ids on the relation.

In case of an [IToOneRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itoonerelation.html) the list can contain 1 id (maximum) if an id was set on the relation. If no id was set on the relation, an empty list is returned.

#### Declaration

```csharp
public abstract IList<long> GetIds()
```

#### Returns

| Type | Description |
| --- | --- |
| IList<>long | A list of ids (never null). |

### GetTypeName()

Gets the name of the relation type.

#### Declaration

```csharp
protected abstract string GetTypeName()
```

#### Returns

| Type | Description |
| --- | --- |
| string | The name of the type. |

### SetIdentifiersAsync(IEnumerable<string>)

Sets the ids on the relations values based on the given identifiers.

In case of an [IToManyRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itomanyrelation.html), the list of ids will be set on the relation.

In case of an [IToOneRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itoonerelation.html), `identifiers` can have at most one value. If the list is empty then the value will be set to null.

#### Declaration

```csharp
public Task SetIdentifiersAsync(IEnumerable<string> identifiers)
```

#### Parameters

| Type | Name | Description |
| --- | --- | --- |
| IEnumerable<>string | identifiers | Identifiers. |

#### Returns

| Type | Description |
| --- | --- |
| Task | A representing the asynchronous operation. |

### SetIds(IEnumerable<long>)

Sets the ids on the relations values. The values should be strictly positive.

In case of an [IToManyRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itomanyrelation.html), the list of ids will be set on the relation.

In case of an [IToOneRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.itoonerelation.html), `ids` can have at most one value. If the list is empty then the value will be set to null.

#### Declaration

```csharp
public abstract void SetIds(IEnumerable<long> ids)
```

#### Parameters

| Type | Name | Description |
| --- | --- | --- |
| IEnumerable<>long | ids | Ids. |

### Implements

[IRelation](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.irelation.html)

[IMember](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.base.imember.html)

[IDirtyTracking](https://doc.sitecore.com/ch/en/developers/api-reference/sdk--stylelabs.m.sdk.contracts.dirtytracking.idirtytracking.html)
