XPO Templates

• Nov 16, 2021
• 2 minutes to read

This topic describes templates you can use when you implement business classes in eXpress Persistent Objects (XPO).

Member Declaration

XPO Persistent Class

Template: xc

C#

public class PersistentClass : XPObject {
    public PersistentClass(Session session) : base(session) { }
}

VB.NET

Public Class PersistentClass
    Inherits XPObject
    Public Sub New(ByVal session As Session)
        MyBase.New(session)
    End Sub
End Class

XPO Persistent Property

Template: xp^[1]

C#

string propertyName;
[Size(SizeAttribute.DefaultStringMappingFieldSize)]
public string PropertyName {
    get => propertyName;
    set => SetPropertyValue(nameof(PropertyName), ref propertyName, value);
}

VB.NET

Private _propertyName As String
<Size(SizeAttribute.DefaultStringMappingFieldSize)>
Property PropertyName As String
    Get
        Return _propertyName
    End Get
    Set(ByVal Value As String)
        SetPropertyValue(Nameof(PropertyName), _propertyName, Value)
    End Set
End Property

XPO-Associated Property

Template: xpa

C#

object propertyName;
[Association("object-Programs")]
public object PropertyName {
    get => propertyName;
    set => SetPropertyValue(nameof(PropertyName), ref propertyName, value);
}

VB.NET

Private _propertyName As Object
<Association("Object-Persons")> _
Property PropertyName() As Object
    Get
        Return _propertyName
    End Get
    Set(ByVal Value As Object)
        SetPropertyValue(Nameof(PropertyName), _propertyName, Value)
    End Set
End Property

XPO-Associated Collection

Template: xpcl

C#

[Association("Program-Relations")]
public XPCollection<RelationType> Relations {
    get {
        return GetCollection<RelationType>(nameof(Relations));
    }
}

VB.NET

<Association("Person-Relations")> 
Public ReadOnly Property Relations() As XPCollection(Of RelationType)
    Get
        Return GetCollection(Of RelationType)(NameOf(Relations))
    End Get
End Property

XPO Read-Only Persistent Property

Template: xr^[2]

C#

[Persistent(nameof(PropertyName))]
int propertyName;
[PersistentAlias(nameof(propertyName))]
public int PropertyName {
    get { return propertyName; }
}

VB.NET

<Persistent(Nameof(PropertyName))> _
Private _propertyName As Integer

<PersistentAlias(Nameof(_propertyName))> _
ReadOnly Property PropertyName As Integer
    Get
        Return _propertyName
    End Get
End Property

Note

Visual Studio IntelliSense has priority over CodeRush templates. For information on how to prioritize CodeRush template over Visual Studio IntelliSense, refer to the following topic section: Expand a Template Instead of Visual Studio IntelliSense.

Footnotes

1. The xp template must be followed by a type mnemonic. For example, s for string.

2. The xr template must be followed by a type mnemonic. For example, i for integer.