バージョン

FormulaString プロパティ (IUltraCalcFormula)

数式を表す文字列を返します。
シンタックス
'宣言
 
ReadOnly Property FormulaString As String
string FormulaString {get;}
解説
以下のリストは、数式の構文およびンストラクトの意味を説明します。
  • 数式は、バイナリ演算子または単項演算子によって分割される複数の項以上を含む式です。等号 (=) では開始しません。代わりに、最初の項で開始します。
  • 数式の項は数値の定数、文字列のリテラル、関数の呼び出し、参照、または式全体を含む括弧が可能です。
  • 数値の定数は 1234.567 の形式です。整数部分または分数部分を省略することができます。例: 5 または .71。
  • 文字列のリテラルはダブル引用符または単一引用符に含まれているテキストです。例: "some text" または 'single quoted text'。リテラルを含む文字をテキストに使用するには、バックスラッシュ文字 (\) によってエスケープします。
  • 関数の呼び出しは、関数名前および括弧に含まれている 0 以上のコンマによって分割される引数です。例: SUM(1, 2, 3)。関数名前は大文字と小文字を区別しなくて、1 つ以上の文字、数字、またはアンダースコアを含み、数字と開始できません。関数名前は組み込み関数または計算マネージャーと登録されるカスタム関数です。関数の引数は式、または以下に説明される範囲参照です。
  • 参照は角括弧に含まれています。計算ネットワークのコントロール、コントロールの論理的な子孫参照 (グリッドのバンドまたは列など)、および計算マネージャーに追加された数式を含む可能なカスタム名前付き参照が可能です。たとえば、"3.14" の数式を持つ PI を追加できます。[PI] を使用して参照できます。
    • 参照名前は大文字と小文字を区別しなくて、相対または絶対が可能です。絶対参照を使用する場合、名前は // と開始する必要があります。例: [//PI]。コントロールおよび名前付き参照などのすべてのルート レベル参照へのアクセスを許可します。
    • グリッドなどの参照の階層をサポートするコントロールの場合、スラッシュ (/) を使用すると、子参照を指定します。たとえば、[//grid1/Customers/Name] を使用すると、grid1 のグリッドの Customers バンドの Name 列にアクセスします。相対参照に .. を含む場合、ディレクトリ パスのように階層の親レベルにアクセスします。グリッドのセルの数式が [../Column1] の場合、子バンド アイランドを所有する親行の Column1 セルにアクセスします。
    • 参照で名前の後に括弧を使用する場合、参照パスの絶対項目または相対項目にアクセスします。たとえば、グリッドで [Total(-1)] は以前の行の Total セルにアクセスします。[//grid1/Customers/Name(3)] は第 4 行目の Customer の Name にアクセスします。コントロールは相対参照および絶対参照を解決します。各コントロールで構成が可能な場合があります。たとえば、グリッドで絶対インデックスを表示インデックスまたはデータ ソースの元のインデックスが可能なオプションを提供できます。
    • アスタリスクを使用すると、コレクションのすべての値にアクセスします。たとえば、[Total(-1)] は以前の行の合計値に参照しますが、[Total(*)] はすべての行の合計値に参照します。
    • 値またはキーと値のペアを括弧に使用すると、参照を簡単に識別できます。例: [//grid1/State(NY)/City(Albany)/Customers(CustomerID=ABCD)/Total]。複数の条件を指定するには、括弧にコンマで分割できます。
    • 参照に基づいて、アクセスするために括弧の必要が可能です。たとえば、グリッドの集計にアクセスするには、通常のバンドおよび列の代わりに括弧を使用する必要がある可能です。例: [//grid1/GrandTotal()]。
    • 数式の参照名前は特殊文字を含む場合、バックスラッシュ (\) とエスケープする必要があります。特殊文字は \ / [ ] ( ) " , = です。
  • 範囲参照は関数引数のみとして使用できます。範囲を 1 つ以上参照します。範囲のエンドポイントが範囲の参照のセットを説明する方法は、所有するコントロールに基づいて決定されます。構文は 2 つの参照の間に 2 つのドット (..) またはコロン (:) を使用します。たとえば、[Orders(0)]:[Orders(3)] はグリッドの最初の注文の範囲を設定します。範囲の参照の場合、アスタリスク (*) はコレクションの最後の項目を参照します。グリッドの現在の子バンド アイランドの最後の項目への参照が可能です。たとえば、[Orders(1)]..[Orders(*)] は最初以外のすべての注文を参照します。特殊ケースがあります。たとえば、[Order(0)]:[Orders] は最初の項目から現在の項目までの範囲です。グリッドの場合、現在の項目は、数式が評価されているターゲット セルと同じ行にある Orders 列の値が可能です。[Orders]:[Orders(*)] は、現在の項目から最後の項目までの範囲です。グリッドの現在の子バンド アイランドの最後の注文への参照が可能です。
  • + (追加)、& (連結)、-、*、/、および ^ (指数) のバイナリ演算子を使用すると、項を分割します。
  • + および - のプレフィックス単項演算子も演算子の前に使用可能です。
  • パーセント演算子 (%) はポストフィックスの単項演算子です。オペランドの値を 1/100 とかけ算します。
  • <、>、<=、>=、=、および != (または <>) の関係演算子はブール値の結果になります。
参照