ContentAreaByName

概要

指定された保存コンテンツ領域に含まれているコンテンツを返します。

構文

ContentAreaByName(1, 2, 3, 4, 5)

関数のプロパティ

序数	型		説明
1	string	必須	返すコンテンツ領域の名前 (必要に応じて my contents フォルダー内のパスを含める)
2	string		開始するインプレッション領域の名前
3	boolean		システムが指定のコンテンツ領域を特定できない場合や、無効なコンテンツ領域を返す場合に関数でエラーを返すかどうかを決定します。値が true の場合、エラーを返します。値が false の場合、エラーを返しません。デフォルトは true です。
4	string		エラーが発生した場合に返すデフォルトのコンテンツ。デフォルトは空の文字列です。
5	numeric		呼び出しのステータスを返す出力パラメーター。値が 0 の場合、関数でコンテンツ領域が見つかり、コンテンツが正常に表示されたことを示します。値が -1 の場合、コンテンツがないか、無効なコンテンツ領域であることを示します。

使用状況

1%%=ContentAreaByName('my contents\Stocks\Weekly Portfolio')=%%

システムは、Stocks フォルダーにある Weekly Portfolio という名前の保存コンテンツ領域のコンテンツを返します。この例では、次のようになります。

1%%=ContentAreaByName('my contents\OptOut_Page\Form\Opt Out Form 2','',0,ContentAreaByName('my contents\OptOut_Page\Form\Opt Out Form Default'))=%%

他のコンテンツが見つからない場合、Opt Out Form Default ページが表示されます。次の例では、ベースコンテンツ領域名とロケール ID を連結して、該当する言語でオプトアウトフォームを提供します。ロケール ID が指定されていないと、デフォルトの EN-US に設定されます。

1%%=ContentAreaByName(Concat('my contents\OptOut_Page\Form\Opt Out Form ',Uppercase(IIF(Empty(QueryParameter('lang')),'en-us',QueryParameter('lang')))),'',0,ContentAreaByName('my contents\OptOut_Page\Form\Opt Out Form EN-US'))=%%