Aspose.Cellsのスマートマーカー機能
Smart markers は、Aspose.Cellsに特定の情報と書式設定のみを含むMicrosoft Excelデザイナースプレッドシートに配置するために使用されます。
デザイナースプレッドシートとスマートマーカー
デザイナースプレッドシートは、視覚的な書式、数式、スマートマーカーを含む標準のExcelファイルです。プロジェクトからの情報や関連連絡先の情報など、1つ以上のデータソースを参照するスマートマーカーを含めることができます。スマートマーカーは、情報を配置したいセルに書き込まれます。
すべてのスマートマーカーは&=で始まります。データマーカーの例は、&=Party.FullNameです。データマーカーが1つ以上のアイテムになる場合、たとえば完全な行の場合、新しい情報に対応するために自動的に次の行が下に移動します。したがって、小計や合計などの計算は、挿入されたデータに基づいて行います。挿入された行で計算を行うには、動的な数式を使用します。
スマートマーカーには、ほとんどの情報のデータソースとフィールド名から成るものがあります。特別な情報は変数や変数配列を伴ったスマートマーカーにも渡される場合があります。変数は常に1つのセルのみに入り、変数配列は複数のセルに入ることがあります。セルごとに1つのデータマーカーしか使用しないでください。未使用のスマートマーカーは削除されます。
スマートマーカーにはパラメータを含めることもできます。パラメータを使用すると、情報の配置方法を変更できます。パラメータは、カンマで区切ったリストとして、スマートマーカーの末尾に括弧で追加されます。
スマートマーカーオプション
- &=DataSource.FieldName
- &=Data Source.Field Name
- &=$VariableName
- &=$VariableArray
- &==DynamicFormula
- &=&=RepeatDynamicFormula
パラメータ
以下のパラメータが許可されています:
- noadd - 追加の行を追加しません。
- skip:n - 各データ行に対してn行をスキップします。
- ascending:n または descending:n - スマートマーカーのデータを並べ替えます。nが1の場合、列はソーターの最初のキーです。データはデータソースの処理の後にソートされます。例：&=Table1.Field3(ascending:1)。
- horizontal - 左から右にデータを書き込みます。
- numeric - 可能な場合はテキストを数値に変換します。.NETバージョンでのみサポートされています。
- shift - データを収まるように下方向または右方向にシフトし、余分な行や列を作成します。shiftパラメータは、Microsoft Excelと同様に機能します。たとえば、MS Excelでは、セルの範囲を選択して、右クリックして挿入を選択し、シフトセルを下方向、シフトセルを右方向などを指定します。要するに、shiftパラメータは垂直/通常（上から下）または水平（左から右）のスマートマーカーに対して同じ機能を果たします。
- copystyle - 基本セルのスタイルをその列のすべてのセルにコピーします。
パラメータnoaddとskipは、交互にデータを挿入するために組み合わせることができます。テンプレートは下から上に処理されるため、交互の行の前に余分な行が挿入されないようにするために、最初の行にnoaddを追加する必要があります。
このセクションには以下のトピックが含まれています