適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
ページ レンダリングのコンテキスト内で、XML の現在のレベルに対してローカルに、またはページに対してグローバルに、変数を設定することができます。
<SetVar
ID = "Text"
Name = "Text"
Scope = "Request"
Value = "Text">
</SetVar>
要素と属性
以下のセクションで、属性、子要素、親要素について説明します。
属性
| 属性 | 説明 |
|---|---|
|
ID |
オプションの Text。 変数の ID を指定します。 |
|
名前 |
必須の Text。 変数の名前を指定します。 |
|
スコープ |
Request に設定すると、変数がグローバルになります。 |
|
値 |
オプションの Text。 この要素が空の要素である場合、これを使用して変数に値を割り当てることができます。 |
子要素
None
親要素
多数
Occurrences
- 最小 : 0
- 最大: 制約なし
注釈
SetVar 要素には、スパニングフォームとスパニング以外のフォームの両方があるため<SetVar Name="MyVar">Announcements</SetVar>、 は と<SetVar Name="MyVar" Value="Announcements/>同じになります。
SetVar で Scope="Request" を指定した場合、その変数割り当ては現在のページ全体に適用されます。 それ以外の場合、割り当ては SetVar 要素の子にのみ適用されます。
SetVar 要素は多くの場合、Method 要素の子として、要求をバッチ処理する記述に使われます。
SetVar 要素は、DisplayMode を次のいずれかの値に設定して表示モードを変更するためによく使用されます。
| 値 | 説明 |
|---|---|
|
表示 |
ビューの ViewBody セクションをレンダリングするときに使用されます。 |
|
編集 |
アイテム編集フォームをレンダリングするときに使用されます。 |
|
DISPLAYHEAD |
ビューの ViewHeader セクションをレンダリングするときに使用されます。 |
|
新機能 |
新規アイテム フォームをレンダリングするときに使用されます。 |
|
PREVIEWDISPLAY |
Microsoft FrontPage を使用して表示フォームを編集するときに使用されます。 |
|
PREVIEWNEW |
FrontPage を使用して新規アイテム フォームを編集するときに使用されます。 |
|
PREVIEWEDIT |
FrontPage を使用してアイテム編集フォームを編集するときに使用されます。 |
例
次の例では、SetVar 要素を使用して変数にグローバル スコープを設定する方法を示します。 1 行目で設定した値が 2 行目で返されます。
<SetVar Name="GlobalVar" Scope="Request">Value</SetVar>
...
<GetVar Name="GlobalVar">
次の例では、最初の GetVar 要素が返Value_2され、2 番目の GetVar 要素が返Value_1されます。これは、 を含む Value_2SetVar 要素が Sample 要素の子にのみ適用されるためです。
Value_2 が終了した Sample タグの後にスコープ外になります。
<SetVar Name="myVar">Value_1</SetVar>
<Sample>
<SetVar Name="myVar">Value_2</SetVar>
<GetVar Name="myVar"/>
</Sample>
<GetVar Name="myVar"/>
次の例では、フィールドが必須かどうかを評価し、必要な場合は、New フォームまたは Edit フォームの必須フィールドの横に表示される赤いアスタリスク (*) を作成し、 HasRequired 変数を TRUE に設定します。
<Switch>
<Expr>
<Property Select="Required"/>
</Expr>
<Case Value="TRUE">
<HTML><![CDATA[<font color=red> *</font>]]></HTML>
<SetVar Scope="Request" Name="HasRequired">TRUE</SetVar>
</Case>
</Switch>