こちらのページでは、列挙型ドメインに関連するメソッドおよびプロパティについて説明します。
以下の例では次の列挙型ドメインの定義を使用しています。

列挙型ドメイン名: MaritalStatus データタイプ : C(1)
値                : Name        Description   Value
                        Single      Single        S
                        Married     Married       M
                        Widow       Widow         W
                        Divorced    Divorced      D

列挙型ドメインメソッド

Convert()

列挙型ドメインに属している不明な値を、列挙型ドメインに基づくフィールド (項目属性、変数、SDT メンバー) に割り当てる必要がある場合に、このメソッドを使用します。たとえば、XML または CSV ファイルから値を読み取って列挙型ドメインフィールドに割り当てる場合などです。値は文字列ですが、GeneXus ではこの値が列挙型ドメインに属すことは認識されません。Convert() メソッドは、この場合に発生するタイプミスマッチのエラーを回避します。
Convert() メソッドでは、パラメーターの値が列挙型ドメインに属すかどうかを実行時に確認しません。

構文

<convert>::=<EnumeratedDomain>.Convert'('<expression>')'

構文の表記規則の表示
入力値の説明:
EnumeratedDomain は、定義済みの列挙型ドメインの名前です。
expression
は任意の有効なエクスプレッションです。データタイプは基本の列挙型ドメイン データ タイプと一致する必要があります。

サンプル

// 次のコードでは、「タイプの不一致」エラーが発生します
&MaritalStatus = "M"
// 代わりに、次のコードを使用します: &MaritalStatus = MaritalStatus.Convert( "M")

使用可能バージョンこのメソッドは、バージョン 9.0、およびそれ以降で使用可能です。

Elements()

列挙型ドメインにおいて定義されている値すべてを持つコレクションを返します。返されたコレクションの要素は、Value でソートされて返されます。コレクションが使用できる場所であればどこでも使用できます。

構文

<Elements>::=<EnumeratedDomain>.Elements'(' ')'

入力値の説明:
EnumeratedDomain
は、定義済みの列挙型ドメインの名前です。

サンプル

// テーブルにドメインの値を挿入します。For &x in MaritalStatus.Elements()
   new
      MaritalStatusId = &x
      MaritalStatusDescription = &x.EnumerationDescription()
   endnew
EndFor
 
// Where 節で
For each
   where MaritalStatusId in MaritalStatus.Elements()
   ...Endfor

使用可能バージョンこのメソッドは、GeneXus X Evolution 1 以降のバージョンで使用可能です。

---

列挙型ドメインに基づく項目属性および変数のメソッド

EnumerationDescription()

EnumerationDescription() メソッドは、任意の列挙型ドメインの値に関連付けられた説明テキストを返します。

構文

<EnumerationDescription>::= <Field>.EnumerationDescription'(' ')'

入力値の説明:
Field は、列挙型ドメインに基づく項目属性、変数、または SDT メンバーです。

サンプル

&MaritalStatus            = MaritalStatus.Married
&MaritalStatusDescription = &MaritalStatus.EnumerationDescription()
// この時点で &MaritalStatus の値は "M"、&MaritalStatusDescription の値は "Married" です

&MaritalStatus            = MaritalStatus.Divorced
&MaritalStatusDescription = &MaritalStatus.EnumerationDescription()
// この時点で &MaritalStatus の値は "D"、&MaritalStatusDescription の値は "Divorced" です

使用可能バージョンこのメソッドは GeneXus X 以降のバージョンで使用可能です。