この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

StandardSetController クラス

StandardSetController オブジェクトを使用すると、Salesforce が提供する、プリビルドされた Visualforce リストコントローラと同様のリストコントローラ、またはその拡張としてリストコントローラを作成できます。

名前空間

ApexPages

使用方法

StandardSetController クラスには、プロトタイプオブジェクトも含まれます。これは、Visualforce の StandardSetController クラスに含まれる単一の sObject です。プロトタイプオブジェクトの項目が設定されている場合、それらの値は、保存操作中に使用されます。つまり、値は設定されたコントローラコレクションのすべてのレコードに適用されます。これは、一括更新 (オブジェクトのコレクション内の項目に同一の変更を適用) を実行するページを記述するときに役立ちます。

他の Salesforce オブジェクトに必要な項目は、プロトタイプオブジェクトに使用される場合にも必要です。

メモ

インスタンス化

次のいずれかの方法で、StandardSetController をインスタンス化することができます。

sObjects のリストを使用する場合:

1List<account> accountList = [SELECT Name FROM Account LIMIT 20];
2ApexPages.StandardSetController ssc = new ApexPages.StandardSetController(accountList);

クエリロケータを使用する場合:

1ApexPages.StandardSetController ssc = 
2new ApexPages.StandardSetController(Database.getQueryLocator([SELECT Name,CloseDate FROM Opportunity]));

StandardSetController のレコード数の上限は 10,000 件です。10,000 件を超えるレコードを返すクエリロケータを使用して StandardSetController をインスタンス化すると、LimitException が発生します。ただし、10,000 件を超えるレコードのリストを使用して StandardSetController をインスタンス化すると、例外が発生する代わりに、レコードが上限まで切り捨てられます。

メモ

例

次の例では、StandardSetController オブジェクトのカスタムリストコントローラのコンストラクタでの使用方法を示します。

1public class opportunityList2Con {
2    // ApexPages.StandardSetController must be instantiated
3    // for standard list controllers
4    public ApexPages.StandardSetController setCon {
5        get {
6            if(setCon == null) {
7                setCon = new ApexPages.StandardSetController(Database.getQueryLocator(
8                    [SELECT Name, CloseDate FROM Opportunity]));
9            }
10            return setCon;
11        }
12        set;
13    }
14
15    // Initialize setCon and return a list of records
16    public List<Opportunity> getOpportunities() {
17        return (List<Opportunity>) setCon.getRecords();
18    }
19}

次の Visualforce マークアップは、上記のコントローラをページ内で使用する方法を示します。

1<apex:page controller="opportunityList2Con">
2    <apex:pageBlock>
3        <apex:pageBlockTable value="{!opportunities}" var="o">
4            <apex:column value="{!o.Name}"/>
5            <apex:column value="{!o.CloseDate}"/>
6        </apex:pageBlockTable>
7    </apex:pageBlock>
8</apex:page>

Visualforce 開発者ガイド

StandardSetController クラス

名前空間

使用方法

インスタンス化

例