省略記号とレンダリングの制限

Windows SharePoint Services は、フィールドのテキストの長さがモバイルの web.config ファイル (Local_Drive:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS\MOBILE に置かれている) で設定されている制限を超えている場合に、モバイル デバイス ビューアに省略記号を表示します。モバイルの編集フォームでは、Windows SharePoint Services は、大量のデータを含むアイテムついては、コンテンツが指定された制限を超えている場合のデータ損失を避けるために、フィールド型ごとのフィールド編集を無効にします。どちらの場合も、モバイル デバイスに表示される内容は、モバイル レンダリングの制限によって決定されます。

図 1 テキストの切り詰めと省略記号のレンダリング

テキストの長さの制限、およびモバイル ビューまたはフォームのレンダリング動作は、web.config ファイルをテキスト エディタで編集するか、Windows SharePoint Services オブジェクトの型とメンバを使用することによって変更できます。

レンダリングの制限では、モバイル コントロールで使用される省略記号のレンダリングのためのテキストの長さの制限を定義するだけでなく、コントロールに表示されるオプションの数も定義します。レンダリングの制限とその既定値の一覧については、このトピックの最後にある表を参照してください。

各制限設定は、web.config ファイルの <appSettings> セクションでキーと値のペア (たとえば、<add key="mobile_webtitlelimit" value="20" />) として表されます。テキストの長さの制限が 0 に設定されていたり、エントリが指定されていない場合には、省略記号のレンダリングは行われません。

オブジェクト モデルを使用して制限を構成する

レンダリングの制限は、次のどちらかの方法で決定されます。

• モバイルの web.config ファイル内で設定される既定の構成設定を使用

• オブジェクト モデルを通じて Web サイトごとに構成できる SPWeb クラスの Properties プロパティを使用

web.config に加えた変更はフロントエンド Web サーバーに対してグローバルですが、Web プロパティにより加えた変更は Web サイトごとのスコープを持ち、サブサイトに継承されることはありません。

Web サイトごとにレンダリングの制限をカスタマイズできるようにするために、Windows SharePoint Services では、最初に SPWeb オブジェクトのプロパティ バッグ (Properties プロパティ) にレンダリング制限のパラメータが保存されているかどうかが確認されます。保存されている場合は、プロパティ バッグに格納されている値がレンダリングの制限となります。それ以外の場合は、web.config に格納されている値がレンダリングの制限となります。特定のサイトのプロパティ バッグの設定は、web.config でのグローバルな設定より優先されます。

モバイル コントロールのレンダリングの制限を変更するには、Properties プロパティのプロパティ バッグ (SPPropertyBag オブジェクト) にプロパティを追加します。以下の例で、指定した Web サイトのリスト タイトルのレンダリング制限を 15 文字に変更する方法を示します。

SPWeb webSite = SPContext.Current.Site.AllWebs["WebSite"];
SPPropertyBag propBag = webSite.Properties;
propBag["mobile_listtitlelimit"] = "15";
propBag.Update();

この例では、Microsoft.SharePoint および Microsoft.SharePoint.Utilities 名前空間で、using ディレクティブ (Visual Basic では Imports) が必要です。さらに、カスタム Web アプリケーションの default.aspx ページに FormDigest コントロールを挿入する必要があります。

レンダリングの制限

以下の表では、モバイル ページで使用されるレンダリングの制限パラメータについて説明し、その既定の最大値を示します。単位は、半角文字または全角文字に関係なく文字数です。