GetVar 要素 (ビュー)

  • [アーティクル]

適用対象: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

ページをレンダリングするコンテキスト内の変数を返します。 変数は、XML の現在のレベルに対してローカルに設定するか、ページに対してグローバルに設定できます。

<GetVar
  AutoHyperlink = "TRUE" | "FALSE"
  AutoHyperLinkNoEncoding = "TRUE" | "FALSE"
  AutoNewLine = "TRUE" | "FALSE"
  Default = "TRUE" | "FALSE"
  ExpandXML = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  Name = "Text"
  Scope ="Request"
    StripWS = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsURL = "TRUE" | "FALSE">
</GetVar>

要素と属性

以下のセクションで、属性、子要素、親要素について説明します。

属性

属性 説明
AutoHyperlink
省略可能 なブール値。 テキストがハイパーリンクのように表示される場合に、テキストをタグで<A>囲むには TRUE を指定します (例: www.microsoft.com)。
AutoHyperLinkNoEncoding
省略可能 なブール値。 テキスト がハイパーリンクのように表示される場合 (たとえば)、HTML エンコードなしでテキストをタグで <A> 囲む場合は TRUE www.microsoft.com。
AutoNewLine
省略可能 なブール値。 テキスト ストリームにタグを挿入 <BR> し、複数のスペースを非区切りスペース (&nbsp;) に置き換える場合は TRUE。
Default
オプションの Text。 別の要素の Select 属性によって返される値が空の文字列の場合、この属性に割り当てられているテキストをレンダリングします。
ExpandXML
省略可能 なブール値。 CAML で CAML をレンダリングすることができる CAML (Collaborative Application Markup Language) インタープリタを介して、レンダリングされたコンテンツを再び渡すには、TRUE に設定します。
Htmlencode
省略可能 なブール値。 TRUE で、ブラウザにテキストとして表示されるように埋め込み文字を変換します。 つまり、HTML タグと混同する可能性がある文字はエンティティに変換されます。
名前
必須の Text。 変数の名前。
スコープ
Request に設定すると、変数はページでグローバルに使用可能になります。
StripWS
省略可能 なブール値。 要素から返される値の先頭および末尾にある空白を削除する場合は、TRUE を設定します。
URLEncode
省略可能 なブール値。 空白 などの特殊文字を引用符で囲まれた UTF-8 形式に変換する場合は TRUE (文字 %c3%abëなど)。
URLEncodeAsUrl
省略可能 なブール値。 URLEncode と同様ですが、エンコードする文字列が URL のパス コンポーネントであることを指定する場合は TRUE で、スラッシュ (/) がエンコードされないようにします。

子要素

None

親要素

多数

Occurrences

  • 最小 : 0
  • 最大: 制約なし

注釈

多くの場合、GetVar 要素は、Switch または IfEqual 要素の Expr 要素で使用されます。

Scope="Request" を SetVar 要素に指定した場合、変数の割り当ては現在のページの任意の場所で有効になります。 それ以外の場合、割り当ては SetVar 要素の子にのみ適用されます。

例

次の例では、GetVar 要素を使用して現在のフィルタ情報を返し、リストの上のツール バーに表示するテキストを確認しています。

<Switch>
   <Expr>
      <GetVar Name="Filter" />
   </Expr>
   <Case Value="1">
      <HTML>Hide Filter Choices</HTML>
   </Case>
   <Default>
      <Switch>
         <Expr>
            <GetVar Name="FilterField1" />
         </Expr>
         <Case Value="">
            <HTML>Filter</HTML>
         </Case>
         <Default>
            <HTML>Change Filter</HTML>
         </Default>
      </Switch>
   </Default>
</Switch>

一覧でフィルターの選択肢が開き、[ フィルター ] 変数に 1 が含まれている場合は、[ フィルターの選択肢を非表示にする] が表示されます。 そうでない場合、既定のアクションは、2 つ目の変数 FilterField1 を評価する 2 つ目の Switch ステートメントを実装します。 FilterField1 の値が空の文字列の場合、フィルターは適用されません。フィルターはツール バーに表示されます。それ以外の場合、既定のアクションは [フィルターの変更] を表示することです。

関連項目