12.1.3.2. Name

Als Name bzw. HTML Id wird wenn möglich der Feldname aus der Datentabelle verwendet. Dies ist nicht in allen Fällen möglich, beispielsweise bei berechneten Felden oder bei Relationsauswahlen.

DevExpress erstellt für die einzelnen Maskenelemente JavaSscript Objekte, die unter window zur Verfügung stehen. Beispiel:

window.Name.GetValue()

Daher muss darauf geachtet werden, das nicht die identischen Namen zweimal innerhalb eines Tabs verwendet werden. Dazu zählen auch alle Dialoge, die innerhalb eines Tabs geöffnet werden. Daher erhalten die Elementnamen neben dem Feldnamen, noch einen weiteren Präfix.

TextEditControl control = (TextEditControl)parametersUi.Control;
string namePrefix = RenderingUtils.GetUIReadyContextPrefix(renderingContext);
MVCxFormLayoutItem mvcxItem = new MVCxFormLayoutItem
{
    NestedExtensionType = FormLayoutNestedExtensionItemType.TextBox,
    Name = namePrefix + control.OrmFieldName,
    FieldName = control.OrmFieldName,
};

Werden nach dem hier dargestellten Schema verfahren werden die Daten auch automatisch gebunden.

Werden Elemente generiert, die nicht konkreten Feldern aus der Datentabelle zuzuordnen sind, werden die IDs der Steuerelemente aus der Maskenkonfiguration genutzt, um eindeutige Namen zu generieren. Vereinfacht kann man einfach ControlInternalName dafür verwenden.

string namePrefix = RenderingUtils.GetUIReadyContextPrefix(renderingContext);
MVCxFormLayoutItem mvcxItem = new MVCxFormLayoutItem
{
    Name = namePrefix + parametersUi.Control.ControlInternalName,
    FieldName = parametersUi.Control.ControlInternalName,
};