Salesforce 提供了一个 可用于开发 Visualforce 页面的标准预构建组件库，例如 和 。在 此外，您可以构建自己的自定义组件来扩充此库。本章概述了自定义组件和 如何创建它们：

<apex:relatedList><apex:dataTable>

• 什么是自定义组件？
• 自定义组件标记
• 在 Visualforce 页面中使用自定义组件
• 自定义组件属性
• 自定义组件控制器
• 定义自定义组件

什么是自定义组件？

类似于封装一件作品的方式 代码，然后在 程序中，您可以将通用设计模式封装在自定义组件中 ，然后在一个或多个 Visualforce 页面中多次重复使用该组件。

例如，假设您要使用 Visualforce 页面。相册中的每张照片都有自己的边框颜色和文本 显示在其下方的标题。而不是重复 Visualforce 标记 需要 要显示相册中的每张照片，您可以定义自定义组件 named 具有 image、边框颜色和标题，然后使用这些属性来显示 页面上的图像。定义后，组织中的每个 Visualforce 页面都可以 利用 与页面可以利用标准组件（如 或 ）的方式相同。singlePhotosinglePhoto<apex:dataTable><apex:relatedList>与页面模板不同，页面模板也使开发人员能够重用 标记、自定义组件提供了更强大的功能和灵活性，因为：

• 自定义组件允许开发人员定义可传递到 每个组件。然后，属性的值可以更改标记的方式 显示在最后一页上，以及执行的基于控制器的逻辑 该组件的实例。此行为与模板的行为不同， 无法从使用 模板添加到模板的定义本身。
• 自定义组件描述显示在应用程序的组件中 参考对话框以及标准组件描述。模板 另一方面，描述只能通过“设置”区域引用 Salesforce，因为他们是 定义为页面。

定义自定义组件

要定义用于 Visualforce 页面的自定义组件，请执行以下操作：

1. 在 Salesforce 的“设置”中，输入“快速” “查找”框，然后选择“Visualforce 组件”。Components
2. 单击“新建”。
3. 在“标签”文本框中，输入应用于 在设置工具中识别自定义组件。
4. 在“名称”文本框中，输入应标识此名称的文本 Visualforce 标记中的自定义组件。此名称只能包含下划线和 字母数字字符，并且在您的组织中必须是唯一的。它必须以字母开头，而不是 包含空格，不以下划线结尾，不包含两个连续 强调。
5. 在“说明”文本框中，输入自定义项的文本说明 元件。此描述与其他标准一起出现在组件参考中 单击“保存”后立即查看组件描述。
6. 在正文文本框中，输入自定义的 Visualforce 标记 组件定义。单个组件最多可以容纳 1 MB 的文本，或者大约可以容纳 1,000,000 个字符。
7. 单击“版本设置”以指定 Visualforce 的版本，然后 与此组件一起使用的 API。您还可以为任何托管软件包指定版本 安装在您的组织中。
8. 单击“保存”以保存更改并查看自定义 组件的详细信息屏幕，或单击“快速保存”以保存 更改并继续编辑组件。您的 Visualforce 标记必须在 您可以保存组件。

注意

您还可以通过添加对自定义组件的引用，在 Visualforce 开发模式下创建自定义组件 尚不存在的 Visualforce 页面标记。保存标记后，将显示一个快速修复链接，该链接显示 允许您创建新的组件定义（包括任何指定的 attributes） 基于您为组件提供的名称。

例如，如果您尚未定义 自定义组件命名并插入到现有页面标记中，单击“保存”后，快速修复允许 您可以定义一个新的自定义组件，该组件使用以下默认值命名 定义：myNewComponent<c:myNewComponent myNewAttribute=”foo”/>myNewComponent

<apex:component>
  <apex:attribute name="myattribute" type="String" description="TODO: Describe me"/>
  <!-- Begin Default Content REMOVE THIS -->
  <h1>Congratulations</h1>
  This is your new Component: mynewcomponent
  <!-- End Default Content REMOVE THIS -->
</apex:component>

您可以修改此项 通过输入快速从设置中定义 “查找”框，然后选择“Visualforce 组件”，然后 ，然后单击 myNewComponent 自定义项旁边的编辑 元件。Components

创建组件后，您可以在 http:// yourSalesforceOrgURL/apexcomponent/nameOfNewComponent 中查看它。 其中用于访问您的 Salesforce 组织的 URL （例如，MyDomainName.my.salesforce.com） 和 value of 是自定义组件定义上“名称”字段的值。yourSalesforceOrgURLnameOfNewComponent

该组件的显示方式就好像它是 Visualforce 页面一样。 因此，如果组件依赖于属性或组件的内容 标记的正文，此 URL 可能会生成您意想不到的结果。查看更多 准确测试自定义组件，将其添加到 Visualforce 页面，然后查看该页面。

自定义组件标记

自定义组件的所有标记都在 一个标签。 此标记必须是自定义组件定义中的顶级标记。 例如：<apex:component>

<apex:component>
    <b>
        <apex:outputText value="This is my custom component."/> 
    </b>
</apex:component>

请注意，标记可以是 Visualforce 和 HTML 标记的组合，就像其他 Visualforce 页面一样。对于更复杂的示例，您可以使用自定义组件来 创建一个跨多个 Visualforce 页面使用的表单。创建一个新的自定义组件，并复制以下内容 法典：

recordDisplay

<apex:component>
    <apex:attribute name="record" description="The type of record we are viewing."
                    type="Object" required="true"/>
                     
    <apex:pageBlock title="Viewing {!record}">   
        <apex:detail />
    </apex:pageBlock>
</apex:component>

接下来，创建一个名为 法典：

displayRecords

<apex:page >
  <c:recordDisplay record="Account" />
</apex:page>

为 此示例要正确呈现，您必须关联 Visualforce 页面 在 URL 中具有有效的客户记录。例如，如果是账户 ID，则 生成的 URL 应 是：

001D000000IRt53

https://Salesforce_instance/apex/displayRecords?id=001D000000IRt53

你 应该会看到一个页面，其中包含有关您作为 同上。现在，将代码替换为以下示例：

displayRecords

<apex:page>
  <c:recordDisplay record="Contact" />
</apex:page>

同样，在之前传入联系人的 ID 刷新页面。您应该会看到页面显示有关以下方面的信息 您的联系人。

自定义组件属性包含有关使用组件的更多信息。<apex:attribute>

在 Visualforce 页面中使用自定义组件

标记的正文是添加到标准 Visualforce 页面的标记，每当 组件包括在内。例如，以下 Visualforce 页面使用该组件 在自定义组件标记中定义（在此示例中，组件使用名称保存）：<apex:component>myComponent

<apex:page standardController="Account">
   This is my <i>page</i>. <br/>
   <c:myComponent/>
</apex:page>

它产生以下输出：

This is my page.
This is my custom component.

要在 Visualforce 页面中使用自定义组件，您必须在 组件的名称，其中包含定义组件的命名空间。例如，如果 命名的组件在 命名空间调用，组件可以 在 Visualforce 页面中引用为 .myComponentmyNS<myNS:myComponent>

为了便于使用，在 命名空间作为关联页面也可以使用命名空间前缀。因此，如果定义了上述示例中的页面和组件 在同一命名空间中，可以将组件引用为 。c<c:myComponent>

如果要将内容插入到自定义组件中，请使用 <apex：componentBody> 标记。

与标准组件类似，当更新或编辑自定义组件时， 引用它的 Visualforce 页面也会更新。

管理自定义组件的版本设置

设置 Visualforce 的 Salesforce API 和 Visualforce 版本 页面或自定义组件：

1. 编辑 Visualforce 页面或组件，然后单击版本设置。注意您只能修改 “版本设置”中页面或自定义组件的版本设置 选项卡，在“设置”中编辑页面或组件时。
2. 选择 Salesforce API 的版本。这也是 与页面或组件一起使用的 Visualforce 版本。
3. 点击保存。

自定义组件属性

除了标准的 Visualforce 标记外，正文 标签还可以指定 在 Visualforce 页面中使用自定义组件时可以传递到自定义组件的属性。的价值观 然后，可以直接在组件中使用此类属性，也可以在组件的控制器中使用（如果适用）。但是，它们不能被使用 在组件控制器的构造函数中。<apex:component>

属性是用标签定义的。例如，以下 自定义组件定义指定了两个必需的属性，分别名为 和 。这些属性的值在自定义中引用 使用标准 Visualforce 表达式语言的组件定义 语法：<apex:attribute>valuetextColor{! }

<apex:component>
    <!-- Attribute Definitions -->
    <apex:attribute name="myValue" description="This is the value for the component."
                    type="String" required="true"/>
    <apex:attribute name="textColor" description="This is color for the text."
                    type="String" required="true"/>

    <!-- Component Definition -->
    <h1 style="color:{!textColor};">
        <apex:outputText value="{!myValue}"/> 
    </h1> 
</apex:component>

在 Visualforce 页面中使用此组件，并使用 以下标记：

<c:myComponent myValue="My value" textColor="red"/>

标签需要以下值 、 和 属性：

<apex:attribute>namedescriptiontype

• 该属性定义了 自定义属性可以在 Visualforce 页面中引用。名称必须是唯一的 跨组件，并且不区分大小写。例如，如果两个属性是 named 和 ，包对它们的处理方式相同， 可能会导致意外行为。name“Model”“model”
• 该属性定义了 在组件参考库中出现一次的属性的帮助文本 自定义组件已保存。自定义组件列在 参考库，其中包含可用的标准组件。description
• 该属性定义 Apex 属性的数据类型。仅允许以下数据类型作为值 对于属性：typetype
  • 基元，例如 String、Integer 或 Boolean。
  • sObject，例如 Account、My_Custom_Object__c 或泛型 sObject 类型。
  • 使用数组表示法指定的一维列表，例如 String[]， 或联系人[]。
  • 映射，使用 指定。您无需指定地图的 特定数据类型。type=”map”
  • 自定义 Apex 类。

有关其他属性的信息，请参阅 apex：attribute。<apex:attribute>

默认自定义组件 属性

始终为自定义组件生成两个属性。这些属性 不需要包含在组件定义中：id允许自定义组件被其他组件引用的标识符 组件。如果未指定，则唯一标识符为 自动生成。rendered一个 Boolean 值，该值指定是否呈现自定义组件 在页面上。如果未指定，则此值默认为 true。

自定义组件控制器

与标准 Visualforce 页面类似，自定义组件可以 与用 Apex 编写的控制器相关联。此关联是通过将组件上的属性设置为 自定义控制器。您可以使用控制器执行其他逻辑，然后再返回 组件的标记到关联页面。controller

访问控制器中的自定义组件属性

若要访问关联的自定义组件控制器中自定义组件属性的值，请执行以下操作：

1. 在自定义组件控制器中定义一个属性，以存储 属性。
2. 定义属性的 getter 和 setter 方法。为 例：public class myComponentController { public String controllerValue; public void setControllerValue (String s) { controllerValue = s.toUpperCase(); } public String getControllerValue() { return controllerValue; } }通知 setter 修改值。
3. 在标签中 组件定义，使用该属性将该属性绑定到您刚刚定义的类变量。为 例：<apex:attribute>assignTo<apex:component controller="myComponentController"> <apex:attribute name="componentValue" description="Attribute on the component." type="String" required="required" assignTo="{!controllerValue}"/> <apex:pageBlock title="My Custom Component"> <p> <code>componentValue</code> is "{!componentValue}" <br/> <code>controllerValue</code> is "{!controllerValue}" </p> </apex:pageBlock> Notice that the controllerValue has been upper cased using an Apex method. </apex:component>注意 当使用属性时，getter 必须定义 setter 方法或具有 和 值的属性。assignTogetset
4. 将组件添加到页面。例如<apex:page> <c:simpleComponent componentValue="Hi there, {!$User.FirstName}"/> </apex:page>

页面的输出将如下所示：

请注意，Apex 控制器方法已更改，因此它以大写形式显示 字符。

controllerValue

静态资源允许您上传 可以在 Visualforce 页面中引用，包括存档（如 .zip 和 .jar 文件）， 图像、样式表、JavaScript 和其他文件。静态资源只能使用 在您的 Salesforce 组织内，因此您不能在此处为其他应用程序或 网站。使用静态资源比将文件上传到 “文档”选项卡，因为：

• 您可以将相关文件的集合打包到 目录层次结构，并将该层次结构作为 .zip 或 .jar 存档上传。
• 您可以通过以下方式在页面标记中按名称引用静态资源 使用全局 变量，而不是硬编码文档 ID。$Resource

提示

另外 使用静态资源引用 JavaScript 或级联样式表 （CSS） 比包含内联标记更可取。管理这个 使用静态资源的内容类型允许您具有一致的 所有页面的外观和一组共享的 JavaScript 功能。

一个 单个静态资源最多可以有 5 MB，一个组织最多可以有 250 MB 的 静态资源，总计。

• 创建静态资源
• 在 Visualforce 标记中引用静态资源
• 使用 iframe 引用不受信任的第三方内容

创建静态资源

要创建静态资源，请执行以下操作：

1. 在“设置”中，输入“快速” “查找”框，然后选择“静态资源”。Static Resources
2. 点击新增功能.
3. 在名称文本框中，输入用于标识 资源。此名称只能包含下划线和字母数字 字符，并且必须在您的组织中是唯一的。它必须以字母开头，不能包含空格， 不以下划线结尾，也不包含两个连续的下划线。注意如果你 在 Visualforce 标记中引用静态资源，然后更改 资源，则 Visualforce 标记将更新以反映该更改。
4. 在“说明”文本区域中，指定 资源。
5. 在文件文本框旁边，单击浏览到 导航到要上传的资源的本地副本。一个 单个静态资源最多可以有 5 MB，一个组织最多可以有 250 MB 的 静态资源，总计。
6. 为用户会话设置缓存控制，包括 API 和 Experience Cloud 用户会话：
   • Private指定 Salesforce 服务器上缓存的静态资源数据不得 与其他用户共享。静态资源仅存储在缓存中，用于当前 用户的会话。注意在以下情况下，静态资源的缓存设置设置为私有 通过 Salesforce 站点访问，其访客用户的个人资料具有基于 IP 的限制 范围或登录时间。具有来宾用户配置文件限制的站点缓存静态 资源仅在浏览器中。此外，如果以前不受限制的站点成为 受限制时，静态资源最多可能需要 45 天才能从 Salesforce 缓存和任何中间缓存。Public指定共享 Salesforce 服务器上缓存的静态资源数据 与组织中的其他用户一起，以缩短加载时间。缓存后， 资源可供所有 Internet 流量访问，包括未经身份验证的 用户。
   标头上的 W3C 规范 字段定义包含有关缓存控制的更多技术信息。注意这 该功能仅适用于使用静态 资源。
7. 点击保存。

警告

如果您使用的是 WinZip，则必须安装最多的 最新版本。旧版本的 WinZip 可能会导致数据丢失。

在 Visualforce 标记中引用静态资源

在 Visualforce 标记中引用静态资源的方式取决于是否要引用独立文件。 或者是否要引用存档中包含的文件 （例如 .zip 或 .jar 文件）：

• 要引用独立文件，请用作 合并字段，其中名称是 you 在上传资源时指定。为 例：$Resource.<resource_name><resource_name><apex:image url="{!$Resource.TestImage}" width="50" height="50"/>或<apex:includeScript value="{!$Resource.MyJavascriptFile}"/>
• 要引用存档中的文件，请使用该函数。指定静态 上传存档时提供的资源名称 第一个参数，以及存档中所需文件的路径 与第二个。例如：URLFOR<apex:image url="{!URLFOR($Resource.TestZip, 'images/Bluehills.jpg')}" width="50" height="50"/>或<apex:includeScript value="{!URLFOR($Resource.LibraryJS, '/base/subdir/file.js')}"/>
• 您可以在静态资源中的文件中使用相对路径 存档来引用存档中的其他内容。例如，在 CSS 中 名为 styles.css 的文件，您有以下内容 风格：table { background-image: url('img/testimage.gif') }什么时候 您在 Visualforce 页面中使用该 CSS，您需要确保 CSS 文件可以 找到图像。为此，请创建一个包含样式.css和img/testimage.gif的存档（例如zip文件）。 确保路径结构保留在存档中。然后上传 将文件存档为名为“style_resources”的静态资源。然后 在页面中，添加以下组件：<apex:stylesheet value="{!URLFOR($Resource.style_resources, 'styles.css')}"/>因为 静态资源包含样式表和图像，相对 样式表中的路径将解析并显示图像。
• 通过自定义控制器，您可以动态引用 使用标记的静态资源的内容。首先，创建自定义控制器：<apex:variable>global class MyController { public String getImageName() { return 'Picture.gif';//this is the name of the image } }然后，参考代码中的方法：getImageName<apex:variable><apex:page renderAs="pdf" controller="MyController"> <apex:variable var="imageVar" value="{!imageName}"/> <apex:image url="{!URLFOR($Resource.myZipFile, imageVar)}"/> </apex:page>如果图像的名称在 zip 文件，您只需更改 中的返回值即可。getImageName

使用 iframe 引用不受信任的第三方内容

最好隔离从不受信任的来源下载的静态资源。您可以 使用 iframe 将第三方内容与 Visualforce 页面分开，以提供 额外的安全层，帮助您保护资产。

若要在单独的域中引用静态 HTML 文件，请用作合并 字段中，其中是您在 上传了资源。例如：$IFrameResource.<resource_name>resource_name

<apex:iframe src="{!$IFrameResource.TestHtml}" id ="theiframe" width="500" height="500"/>

iframe 标记将 JavaScript 注入到父文档和子 iframe 中，以 在两个元素之间建立安全的通信。父文档可以有 多个 iframe。每个唯一命名的静态资源都位于其自己的子域 或 中。force-user-content.comforceusercontent.com

对 iframe 的访问未经身份验证，因此它包含的任何第三方内容都无法访问 用户的会话 ID。

与父文档中的 iframe 进行通信

您可以在父文档中编写 JavaScript 代码以与 iframe 进行通信。

• 发送消息至 iframe：SfdcApp.iframe.sendMessage('theiframe', { key1: value1, key2: value2 });
• 接收来自以下位置的消息 iframe：SfdcApp.iframe.addMessageHandler('theiframe', function(data) { if(data.key1) { … } });
• 从以下位置捕获错误 iframe：SfdcApp.iframe.addErrorHandler('theiframe', function(error) { console.log(error); });

在 iframe 中与父文档进行通信

您也可以从 iframe 文档以另一种方式进行通信。

• 向父级发送消息 公文：LCC.onlineSupport.sendMessage('containerUserMessage', { key1: value1, key2: value2 });
• 设置处理程序以接收来自父级的消息 公文：LCC.onlineSupport.addMessageHandler(function(message) { if(data.key1) { … } });自 删除此内容 处理器：LCC.onlineSupport.removeMessageHandler(function)
• 为来自父级的消息错误设置处理程序 公文：LCC.onlineSupport.addMessageErrorHandler(function(message) { if(data.key1) { … } });自 删除此内容 处理器：LCC.onlineSupport.removeMessageErrorHandler(function)
• 为其他类型的 错误：LCC.onlineSupport.addErrorHandler(function(message) { if(data.key1) { … } });自 删除此内容 处理器：LCC.onlineSupport.removeErrorHandler(function)

标准控制器可以提供 Visualforce 页面所需的所有功能 因为它们包含用于标准页面的相同逻辑。例如，如果你 使用标准帐户控制器，单击 Visualforce 页面产生的行为与在 标准帐户编辑页面。但是，如果要覆盖现有功能，请通过以下方式自定义导航 应用程序，使用标注或 Web 服务，或者如果您需要更精细地控制方式 访问页面的信息，您可以编写自定义控制器或控制器 使用 Apex 的扩展：

• 什么是自定义 控制器和控制器扩展？
• 构建自定义 控制器
• 构建一个 控制器扩展
• 控制器 方法
• Controller 类 安全
• 考虑 用于创建自定义控制器和控制器扩展
• 执行顺序 在 Visualforce 页面中
• 测试自定义 控制器和控制器扩展
• 验证规则 和自定义控制器
• 使用 transient 关键字

什么是自定义控制器和控制器扩展？

自定义控制器是一个 Apex 类，用于实现页面的所有逻辑 无需使用标准控制器。当您希望 Visualforce 页面完全在系统中运行时，请使用自定义控制器 模式，该模式不强制执行当前用户的权限和字段级安全性。控制器扩展是一个 Apex 类，它扩展了 标准或自定义控制器。在以下情况下使用控制器扩展：

• 您希望利用标准控制器的内置功能，但要覆盖一个或 更多操作，例如编辑、查看、保存或删除。
• 您想要添加新操作。
• 您想要构建 Visualforce 页面 尊重用户权限。尽管控制器扩展类在系统模式下执行， 如果控制器扩展扩展标准控制器，则来自标准控制器的逻辑 不在系统模式下执行。相反，它在用户模式下执行，其中权限， 字段级安全性，并应用当前用户的共享规则。

注意

自定义控制器和控制器扩展类在 系统模式，因此它们会忽略用户权限和字段级安全性。但是，您可以 选择是否遵循用户在组织范围内的默认值、角色层次结构和共享 规则，方法是使用 类定义。有关信息，请参阅《使用 、 和关键字》中的“使用 Apex 开发人员 指南。with sharingwith sharingwithout sharinginherited sharing

构建自定义控制器

自定义控制器是使用默认的无参数构造函数的 Apex 类 对于外部的顶级类。不能创建 包括参数。

1. 在“设置”中，在“快速”中输入 Apex 类 “查找”框，然后选择“Apex 类”。
2. 单击“新建”。
3. 单击“版本设置”以指定 Apex 的版本 以及与此类一起使用的 API。如果您的组织已安装托管 软件包，您还可以指定每个软件包的版本 用于此类的托管包。对所有版本使用默认值。 这会将该类与最新版本的 Apex 和 API 相关联，如下所示 以及每个托管包。您可以指定旧版本的托管 软件包，如果您要访问与 最新的包版本。您可以指定旧版本的 Apex 和 用于维护特定行为的 API。
4. 在类编辑器中，输入类的 Apex 代码。单个类可以是 长度不超过 100 万个字符，不包括注释、测试方法或 使用 @isTest 定义的类。
5. 单击“保存”以保存更改并返回到课程 详细信息屏幕，或单击“快速保存”以保存更改 ，然后继续编辑您的课程。您的 Apex 类必须正确编译才能 您可以保存您的课程。

例

下面的类是自定义控制器的简单示例：

public class MyController {

    private final Account account;

    public MyController() {
        account = [SELECT Id, Name, Site FROM Account 
                   WHERE Id = :ApexPages.currentPage().getParameters().get('id')];
    }

    public Account getAccount() {
        return account;
    }

    public PageReference save() {
        update account;
        return null;
    }
}

以下 Visualforce 标记显示了如何在 一页：

<apex:page controller="myController" tabStyle="Account">
    <apex:form>
        <apex:pageBlock title="Congratulations {!$User.FirstName}">
            You belong to Account Name: <apex:inputField value="{!account.name}"/>
            <apex:commandButton action="{!save}" value="save"/>
        </apex:pageBlock>
    </apex:form>
</apex:page>

由于组件的属性，自定义控制器与页面相关联。controller<apex:page>

与标准控制器和控制器扩展一样，自定义控制器方法可以 用符号引用 关联的页面标记。在上面的示例中，该方法由标记的属性引用，而标记使用其属性引用该方法。{! }getAccount<apex:inputField>value<apex:commandButton>saveaction

注意

与其他 Apex 类一样，所有自定义控制器都在系统模式下运行。因此，当前用户的凭据不用于 执行控制器逻辑，用户权限和字段级安全性执行 不适用。

您可以选择自定义控制器是否遵循用户的 使用类中的关键字的组织范围的默认值、角色层次结构和共享规则 定义。with sharing有关信息，请参阅《使用 、 和关键字》中的“使用 Apex 开发人员 指南。with sharingwithout sharinginherited sharing

自定义控制器还可用于 创建新记录。为 例：

public class NewAndExistingController {

    public Account account { get; private set; }

    public NewAndExistingController() {
        Id id = ApexPages.currentPage().getParameters().get('id');
        account = (id == null) ? new Account() : 
            [SELECT Name, Phone, Industry FROM Account WHERE Id = :id];
    }

    public PageReference save() {
        try {
            upsert(account);
        } catch(System.DMLException e) {
            ApexPages.addMessages(e);
            return null;
        }
        //  After successful Save, navigate to the default view page
        PageReference redirectSuccess = new ApexPages.StandardController(Account).view();
        return (redirectSuccess);
    }
}

以下 Visualforce 标记显示了如何在 一页：

<apex:page controller="NewAndExistingController" tabstyle="Account">
    <apex:form>
        <apex:pageBlock mode="edit">
            <apex:pageMessages/>
            <apex:pageBlockSection>
                <apex:inputField value="{!account.name}"/>
                <apex:inputField value="{!account.phone}"/>
                <apex:inputField value="{!account.industry}"/>
            </apex:pageBlockSection>
            <apex:pageBlockButtons location="bottom">
                <apex:commandButton value="Save" action="{!save}"/>
            </apex:pageBlockButtons>
        </apex:pageBlock>
    </apex:form>
</apex:page>

构建控制器扩展

控制器扩展是任何 Apex 类，其中包含一个构造函数，该构造函数采用单个 类型为 或 的参数，其中 是所需的自定义控制器的名称 以扩展。ApexPages.StandardControllerCustomControllerNameCustomControllerName

下面的类是控制器扩展的简单示例：

public class myControllerExtension {

    private final Account acct;
    
    // The extension constructor initializes the private member
    // variable acct by using the getRecord method from the standard
    // controller.
    public myControllerExtension(ApexPages.StandardController stdController) {
        this.acct = (Account)stdController.getRecord();
    }

    public String getGreeting() {
        return 'Hello ' + acct.name + ' (' + acct.id + ')';
    }
}

以下 Visualforce 标记 显示了如何在页面中使用上面的控制器扩展：

<apex:page standardController="Account" extensions="myControllerExtension">
    {!greeting} <p/>
    <apex:form>
        <apex:inputField value="{!account.name}"/> <p/>
        <apex:commandButton value="Save" action="{!save}"/>
    </apex:form>
</apex:page>

扩展使用组件的属性与页面相关联。extensions<apex:page>

与所有控制器方法一样，控制器扩展方法可以在页面标记中使用表示法进行引用。在 上面的例子，表达式 页面顶部引用了控制器扩展的方法。{! }{!greeting}getGreeting

由于此扩展与 Account 标准控制器结合使用，因此 还提供标准控制器方法。例如，标记中的属性检索 使用标准控制器功能的帐户。同样，标签引用标准 account 方法及其属性。value<apex:inputField><apex:commandButton>saveaction可以通过逗号分隔为单个页面定义多个控制器扩展 列表。这允许重写具有相同名称的方法。例如，如果 以下页面 存在：

<apex:page standardController="Account" 
    extensions="ExtOne,ExtTwo" showHeader="false">
    <apex:outputText value="{!foo}" />
</apex:page>

跟 以下 扩展：

public class ExtOne {
    public ExtOne(ApexPages.StandardController acon) { }

    public String getFoo() {
        return 'foo-One';
    }
}

public class ExtTwo {
    public ExtTwo(ApexPages.StandardController acon) { }

    public String getFoo() {
        return 'foo-Two';
    }
}

这 组件的值 呈现为 .覆盖由以下任一因素定义 方法在“最左边”扩展中定义，或者在 在逗号分隔列表中的第一个。因此，的方法覆盖了 的方法。

<apex:outputText>foo-OnegetFooExtOneExtTwo

注意

与其他 Apex 类一样，控制器扩展在 系统模式。因此，当前用户的凭据不用于 执行控制器逻辑，用户权限和字段级安全性执行 不适用。然而 如果控制器扩展扩展标准控制器，则来自标准控制器的逻辑 控制器不在系统模式下执行。相反，它在用户模式下执行，其中 当前用户的权限、字段级安全性和共享规则 应用。

您可以选择控制器扩展是否遵循用户的 使用类定义中的关键字实现组织范围的默认值、角色层次结构和共享规则。 有关信息，请参阅《使用 、 和关键字》中的“使用 Apex 开发人员 指南。with sharingwith sharingwithout sharinginherited sharing

构建自定义列表控制器

自定义列表控制器类似于标准列表控制器。自定义列表 控制器可以实现您定义的 Apex 逻辑，以显示或操作一组 记录。例如，您可以创建以下自定义列表控制器，基于 一个 SOQL 查询：

public class opportunityList2Con {
    // ApexPages.StandardSetController must be instantiated
    // for standard list controllers
    public ApexPages.StandardSetController setCon {
        get {
            if(setCon == null) {
                setCon = new ApexPages.StandardSetController(Database.getQueryLocator(
                    [SELECT Name, CloseDate FROM Opportunity]));
            }
            return setCon;
        }
        set;
    }

    // Initialize setCon and return a list of records
    public List<Opportunity> getOpportunities() {
        return (List<Opportunity>) setCon.getRecords();
    }
}

注意

这 返回的 sObject 列表是 变。例如，你不能调用它。您可以对 列表，但无法向列表添加项目或从列表中删除项目 本身。getRecords()clear()以下 Visualforce 标记 展示了如何在 页：

<apex:page controller="opportunityList2Con">
    <apex:pageBlock>
        <apex:pageBlockTable value="{!opportunities}" var="o">
            <apex:column value="{!o.Name}"/>
            <apex:column value="{!o.CloseDate}"/>
        </apex:pageBlockTable>
    </apex:pageBlock>
</apex:page>

您还可以创建一个自定义列表控制器，该控制器使用反联接和半联接作为 SOQL 查询。以下代码是作为帐户的扩展实现的 标准 控制器：

public with sharing class AccountPagination {
    private final Account acct;  

    // The constructor passes in the standard controller defined
    // in the markup below
    public AccountPagination(ApexPages.StandardSetController controller) {
        this.acct = (Account)controller.getRecord(); 
    }    
    
    public ApexPages.StandardSetController accountRecords {
        get {
            if(accountRecords == null) {
                accountRecords = new ApexPages.StandardSetController(
                    Database.getQueryLocator([SELECT Name FROM Account WHERE Id NOT IN 
                        (SELECT AccountId FROM Opportunity WHERE IsClosed = true)]));
            }
            return accountRecords;
        }
        private set;
    }
    public List<Account> getAccountPagination() {
         return (List<Account>) accountRecords.getRecords();
    }  
}

这 显示这些记录的页面混合使用标准列表控制器操作，但 依赖于循环访问从自定义列表返回的记录 控制器：

<apex:page standardController="Account" recordSetVar="accounts" extensions="AccountPagination">
    <apex:pageBlock title="Viewing Accounts">
        <apex:form id="theForm">
            <apex:pageBlockSection >
                <apex:dataList value="{!accountPagination}" var="acct" type="1">
                    {!acct.name}
                </apex:dataList>
            </apex:pageBlockSection>
            <apex:panelGrid columns="2">
                <apex:commandLink action="{!previous}">Previous</apex:commandlink>
                <apex:commandLink action="{!next}">Next</apex:commandlink>
            </apex:panelGrid>
        </apex:form> 
    </apex:pageBlock>
</apex:page>

控制器方法

Visualforce 标记可以使用 以下类型的控制器扩展和自定义控制器方法：

• 行动
• 吸气剂
• 二传手

操作方法

操作方法在页面执行逻辑或导航时 事件发生，例如当用户单击按钮或将鼠标悬停在 页。可以通过在以下参数之一的参数中使用表示法从页面标记中调用操作方法 标签：{! }action

• <apex：commandButton> 创建一个按钮，该按钮调用 行动
• <apex：commandLink> 创建一个调用操作的链接
• <apex：actionPoller> 定期调用操作
• <apex：actionSupport> 创建一个事件（例如 “onclick”、“onmouseover”等） 命名组件，调用操作
• <apex：actionFunction> 定义了一个新的 JavaScript 调用操作的函数
• <apex：page> 调用操作 加载页面时

例如，在“生成自定义控制器”的示例页中，控制器的方法 由标记的参数调用。其他 定义操作方法中讨论了操作方法的示例。saveaction<apex:commandButton>

Getter 方法

Getter 方法从控制器返回值。每个值 由控制器计算并显示在页面中必须具有相应的 getter 方法，包括任何布尔变量。例如，在生成自定义控制器的示例页中，控制器包含一个方法。此方法允许页面标记引用 带有表示法的控制器类。标记的参数使用此表示法来 访问帐户，并使用点表示法显示帐户的名称。Getter 方法 必须始终命名为 。getAccountaccount{! }value<apex:inputField>getVariable

重要

它 getter 方法的最佳实践是幂等的，即没有 副作用。例如，不要递增变量，写日志消息， 或将新记录添加到数据库。Visualforce 没有 定义调用 getter 方法的顺序，或者调用它们的次数 在处理请求的过程中调用。设计 getter 方法以产生 相同的结果，无论它们被调用一次还是多次用于单个页面 请求。

Setter 方法

Setter 方法将用户指定的值从页面标记传递给 控制器。控制器中的任何 setter 方法都会在 任何操作方法。

例如，以下标记显示一个页面 实现 Leads 的基本搜索功能。关联的控制器包括 getter 和 setter 方法，然后使用搜索文本来 当用户单击 Go！ 时发出 SOSL 查询。虽然 标记不会显式调用搜索文本 setter 方法，它会执行 在操作方法之前，当 用户单击命令 按钮：doSearch

<apex:page controller="theController">
   <apex:form>
      <apex:pageBlock mode="edit" id="block">
         <apex:pageBlockSection>
            <apex:pageBlockSectionItem>
               <apex:outputLabel for="searchText">Search Text</apex:outputLabel>
               <apex:panelGroup>
                  <apex:inputText id="searchText" value="{!searchText}"/>
                  <apex:commandButton value="Go!" action="{!doSearch}" 
                                      rerender="block" status="status"/>
               </apex:panelGroup>
            </apex:pageBlockSectionItem>
        </apex:pageBlockSection>
        <apex:actionStatus id="status" startText="requesting..."/>
        <apex:pageBlockSection title="Results" id="results" columns="1">
           <apex:pageBlockTable value="{!results}" var="l" 
                               rendered="{!NOT(ISNULL(results))}">
              <apex:column value="{!l.name}"/>
              <apex:column value="{!l.email}"/>
              <apex:column value="{!l.phone}"/>
           </apex:pageBlockTable>
        </apex:pageBlockSection>
      </apex:pageBlock>
   </apex:form>
</apex:page>

这 以下类是页面标记的控制器 以上：

public class theController {

    String searchText;
    List<Lead> results;

    public String getSearchText() {
        return searchText;
    }

    public void setSearchText(String s) {
        searchText = s;
    }

    public List<Lead> getResults() {
        return results;
    }

    public PageReference doSearch() {
        results = (List<Lead>)[FIND :searchText RETURNING Lead(Name, Email, Phone)][0];
        return null;
    }
}

而 从控制器访问值始终需要 getter 方法，它是 并不总是需要包含 setter 方法以将值传递到控制器中。如果 Visualforce 组件是 绑定到存储在控制器中的 sObject，sObject 的字段为 如果用户更改，则自动设置，只要保存或更新 sObject 即可 通过相应的动作方法。示例中显示了此行为的示例 页面。

Setter 方法必须始终命名为 。setVariable

重要

最佳做法是 setter 方法是幂等的，即没有副作用。例如，不要 递增变量、写入日志消息或向数据库添加新记录。Visualforce 没有 定义调用 setter 方法的顺序，或者调用它们的次数 在处理请求的过程中调用。设计 setter 方法以产生 相同的结果，无论它们被调用一次还是多次用于单个页面 请求。

使用自定义扩展获取和设置数据，或者 控制器

有 无法保证 Apex 方法和变量的处理顺序 控制器扩展或自定义控制器。因此，不允许控制器和 扩展类依赖于正在运行的另一个方法，请直接调用该方法。 这特别适用于设置变量和从数据库访问数据。

例如，在以下自定义控制器中，第一个方法 ， 始终返回正确的 值，因为它不假定 contact 变量已存在。但是，第二种方法有时会返回 正确的值，但不是每次都正确 设置。getContactMethod1cgetContactMethod2c

public class conVsBad {
    Contact c;

    public Contact getContactMethod1() {
        if (c == null) c = [SELECT Id, Name FROM Contact LIMIT 1];
        return c;
    }

    public Contact getContactMethod2() {
        return c;
    }
}

这 以下自定义控制器具有完全相同的方法。但是，调用 ，因此变量始终被设置，并且始终包含 返回时的值正确。getContactMethod2contactMethod1c

public class conVsGood {
    Contact c;

    public Contact getContactMethod1() {
        if(c == null) c = [SELECT Id, Name FROM Contact LIMIT 1];
        return c;
    }

    public Contact getContactMethod2() {
        return getContactMethod1();
    }
}

这 以下标记显示调用这些控制器的两个页面。Visualforce 标记是 相同，只有控制器名称是 改变：

<apex:page controller="conVsGood">
    getContactMethod2(): {!contactMethod2.name}<br/>
    getContactMethod1(): {!contactMethod1.name}
</apex:page>

<apex:page controller="conVsBad">
    getContactMethod2(): {!contactMethod2.name}<br/>
    getContactMethod1(): {!contactMethod1.name}
</apex:page>

控制器类安全性

与其他 Apex 类一样，您可以指定用户是否可以在自定义中执行方法 控制器或基于用户配置文件的控制器扩展类。

注意

如果您在组织中安装了托管软件包，则只能为 Apex 设置安全性 包中声明为 或 的类 对于包含声明为 的方法的类。globalwebService

如果用户具有 Author Apex 权限，则可以访问所有 Apex 关联组织中的类，而不考虑个人的安全设置 类。

仅在顶层检查 Apex 类的权限。例如，类 A 调用类 B. 用户 X 有一个可以访问 A 类但不能访问 B 类的配置文件。用户 X 可以在 B类，但只能通过A类;用户 X 不能直接调用类 B。同样，如果 Visualforce 页面使用带有关联控制器的自定义组件，仅检查安全性 用于与页面关联的控制器。与自定义组件关联的控制器 无论权限如何，都会执行。

要从类列表页面设置 Apex 类安全性，请执行以下操作：

从类列表中设置 Apex 类访问权限 页

要从类详细信息页面设置 Apex 类安全性，请执行以下操作： 从类详细信息设置 Apex 类访问权限 页

处理大型数据集

Visualforce 自定义控制器和 控制器扩展受 Apex 调控器限制的约束。有关调速器的详细信息 限制，请参阅执行调控器和限制。此外，Visualforce 迭代组件（如 和）限制为 中最多 1,000 个项目 他们迭代的集合。<apex:pageBlockTable><apex:repeat>

有时，您的 Visualforce 页面可能会 需要处理或显示更大的数据集，但不需要对其进行修改 数据;例如，如果您要提供自定义报告和分析。Visualforce 为开发人员提供了”只读模式“，放宽了对数量的限制 可以在一个请求中查询的行，并增加对收集数量的限制 可以在页面内迭代的项目。您可以为整个页面指定只读模式，也可以在有某些限制的情况下指定只读模式 单个组件或方法。

注意

只有在以下情况下，才能循环访问大型数据集 为整个页面指定只读模式。

为整个页面设置只读模式

要为整个页面启用只读模式，请将组件上的属性设置为 。

readOnly<apex:page>true

例如，下面是一个以只读模式处理的简单页面：

<apex:page controller="SummaryStatsController" readOnly="true">
    <p>Here is a statistic: {!veryLargeSummaryStat}</p>
</apex:page>

此页面的控制器也很简单，但说明了如何 您可以计算在页面上显示的汇总统计信息：

public class SummaryStatsController {
    public Integer getVeryLargeSummaryStat() {
        Integer closedOpportunityStats = 
            [SELECT COUNT() FROM Opportunity WHERE Opportunity.IsClosed = true];
        return closedOpportunityStats;
    }
}

通常，对单个 Visualforce 页面请求的查询检索的行数可能不会超过 50,000 行。在只读模式下，此限制已放宽，最多允许查询 1,000,000 行。

除了查询更多行之外，该属性还增加了集合中可以 使用 、 和 等组件进行迭代。此限制从 1,000 增加到 项目到 10,000。下面是一个简单的控制器和页面演示：readOnly<apex:dataTable><apex:dataList><apex:repeat>

public class MerchandiseController {

    public List<Merchandise__c> getAllMerchandise() {
        List<Merchandise__c> theMerchandise = 
            [SELECT Name, Price__c FROM Merchandise__c LIMIT 10000];
        return(theMerchandise);
    }
}

<apex:page controller="MerchandiseController" readOnly="true">
    <p>Here is all the merchandise we have:</p>
    <apex:dataTable value="{!AllMerchandise}" var="product">
        <apex:column>
            <apex:facet name="header">Product</apex:facet>
            <apex:outputText value="{!product.Name}" />
        </apex:column>
        <apex:column>
            <apex:facet name="header">Price</apex:facet>
            <apex:outputText value="{!product.Price__c}" />
        </apex:column>
    </apex:dataTable>
</apex:page>

虽然对整个页面使用只读模式的 Visualforce 页面不能使用数据操作语言 （DML） 操作， 它们可以调用影响表单和其他用户的 getter、setter 和 action 方法 界面元素，进行其他只读查询，依此类推。

为控制器方法设置只读模式

Visualforce 控制器方法 可以使用 Apex 注释，但有一些重要的限制，即使页面本身不是只读模式。

ReadOnly带有注释的 Visualforce 控制器方法会自动利用只读模式。 但是，对注释的限制意味着 对于 Visualforce 控制器方法， 只读方法也必须具有批注。注解要求 方法是：

@ReadOnly@ReadOnly@RemoteAction@RemoteAction

• Either 或globalpublic
• static

启用只读模式 必须在顶部使用注释 level 方法调用。如果顶级方法调用没有注解，则对最大查询量的正常限制 对整个请求强制执行行，即使辅助方法使用 注释了 。@ReadOnly@ReadOnly@ReadOnly

在控制器方法上使用批注 允许您检索更大的记录集合作为 Visualforce 表达式的结果。但是，它 不会增加迭代组件的集合中的最大项数。如果 想要遍历更大的结果集合，需要为 整个页面。@ReadOnly

创建自定义控制器和控制器的注意事项 扩展

创建控制器扩展和自定义控制器时，请注意以下注意事项：

• 除非一个类具有定义为 的方法，否则自定义扩展和控制器类和方法通常 定义为 。如果类包含 Web 服务方法，则必须将其定义为 。webServicepublicglobal
• 从数据库返回数据时，请使用集、映射或列表。这将使您的代码 效率更高，因为代码对数据库的访问更少。
• Visualforce 控制器扩展的 Apex 调控器限制和 自定义控制器与匿名块或 WSDL 方法的限制相同。为 有关调控器限制的详细信息，请参阅附录中的执行调控器和限制。
• 如果要构建自定义控制器或控制器扩展，请注意这样做 不会无意中暴露通常对用户隐藏的敏感数据。考虑 在类上使用关键字 用于强制执行权限的定义。另外，使用受保护的 Web 服务时也要小心 作为配置文件的顶级入口点，但一旦它们被执行，就会在系统上下文中执行 发起。with sharing
• Apex 方法和变量不按保证顺序实例化。查看更多 信息，请参阅使用自定义扩展获取和设置数据或 控制器。
• 不能在“getxxx”中使用数据操作语言 （DML） 操作 方法。例如，如果控制器具有方法，则不能在该方法中使用 或 创建对象。getNameinsertupdate
• 不能在构造函数方法中使用数据操作语言 （DML） 操作 控制器。
• 您不能在 “getxxx”或“setxxx”方法，或者在 控制器的构造函数。@future
• Primitive Apex 数据类型（如 String 或 Integer）按值传递给 组件的控制器。
• 非原始 Apex 数据类型（如 lists 和 sObjects）通过引用传递给 组件的控制器。这意味着，如果组件的控制器更改了 帐户，更改可在页面的控制器中找到。
• 如果您的组织使用个人帐户
  • 使用自定义引用客户记录的名称字段时 控制器使用您必须在 您的查询。<apex:inputField>isPersonAccount
  • 如果创建新帐户并设置名称，则记录将为 企业帐户。如果您创建一个新帐户并设置姓氏， 这将是一个个人帐户。
  • 最佳做法是创建一个自定义名称公式字段，该字段将正确呈现 个人帐户和企业帐户，然后使用该字段而不是 Visualforce 页面中的标准字段。
  • 如果您计划将 Visualforce 页面包含在 Salesforce AppExchange 软件包中， 在控制器或控制器扩展中，不能显式引用字段 仅存在于个人帐户中。

Visualforce 页面中的执行顺序

当用户查看 Visualforce 页面时，控制器、扩展和组件的实例会关联 页面由服务器创建。这些顺序 元素的执行会影响页面向 用户。要完全了解 Visualforce 页面上元素的执行顺序，您必须首先了解页面的生命周期，即页面在 用户会话的过程。页面的生命周期不是确定的 仅通过页面的内容，还取决于页面的请求方式。 有两种类型的 Visualforce 页面请求：

• get 请求是初始请求 当用户输入 URL 或 单击链接或按钮，将用户带到新页面。
• 回发请求是 当用户交互需要页面更新时进行，例如当 用户单击“保存”按钮并触发 保存操作。

有关这两种请求的具体细节，请举例说明 页面的生命周期，以及有关如何处理执行顺序的提示 在编写自己的自定义控制器和控制器扩展时， 看：

• Visualforce 页面获取请求的执行顺序
• Visualforce 页面回发请求的执行顺序
• Visualforce 页面执行顺序示例

注意

Visualforce 页面请求的最大响应大小必须低于15兆字节.

Visualforce 页面获取请求的执行顺序

get 请求是初始请求 当用户输入 URL 或 单击链接或按钮，将用户带到新页面。下图显示了 Visualforce 页面如何与控制器扩展或自定义控制器进行交互 GET 请求期间的类：

在上图中，用户最初请求页面，或者 通过输入 URL 或单击链接或按钮。此初始页面 request 称为 get 请求。

1. 关联的自定义控制器上的构造函数方法或 调用控制器扩展类，实例化控制器 对象。
2. 如果页面包含任何自定义组件，则会创建这些组件并 任何关联的自定义控制器或控制器上的构造函数方法 扩展被执行。如果在自定义组件上设置了属性 使用表达式，表达式在构造函数之后计算 被评估。
3. 然后，页面对页面上的任何自定义组件执行任何属性。执行方法后，表达式 ，则计算组件上的属性，以及所有其他方法调用，例如获取 或设置属性值。assignToassignToaction<apex:page>
4. 如果页面包含组件，则维护状态所需的所有信息 的数据库在页面请求之间被保存为加密的视图状态。每当页面出现以下情况时，视图状态都会更新： 更新。<apex:form>
5. 生成的 HTML 将发送到浏览器。如果有任何客户端 页面上的技术，例如 JavaScript，浏览器执行 他们。

当用户与页面交互时，页面会联系控制器 对象，以执行 action、getter 和 setter 方法。一旦用户发出新的 get 请求，视图状态和 控制器对象将被删除。

注意

如果用户被重定向到 使用相同控制器和相同或适当子集的页面 的控制器扩展，则会发出回发请求。回发时 发出请求，视图状态保持不变。

如果用户交互需要页面更新，例如当 用户单击触发保存的“保存”按钮 操作时，将发出回发请求。更多信息 有关回发请求，请参见 Visualforce 页面回发请求的执行顺序。

有关 get 请求的特定示例，请参见 Visualforce 页面执行顺序示例。

Visualforce 页面回发请求的执行顺序

回发请求是 当用户交互需要页面更新时进行，例如当 用户单击“保存”按钮并触发 保存操作。下图显示了 Visualforce 页面如何与控制器扩展或自定义控制器进行交互 回发请求期间的类：

1. 在回发请求期间，将对视图状态进行解码并使用 作为更新页面上值的基础。注意组件 替换为属性 设置为绕过此 阶段。换言之，操作已执行，但未执行 对输入执行验证，页面上不会更改任何数据。immediatetrue
2. 对视图状态进行解码后，将计算表达式并 在控制器和任何控制器扩展上设置方法，包括 在为自定义组件定义的控制器中执行 set 方法。除非所有方法都 已成功执行。例如，如果其中一个方法更新 属性，并且由于验证规则或 数据类型不正确，数据不会更新，页面会重新显示 以及相应的错误消息。
3. 将执行触发回发请求的操作。如果 该操作成功完成，数据将更新。如果回发 request 将用户返回到同一页面，视图状态将更新。注意上的属性 组件 在回发请求期间不计算。它仅在 GET 请求。action<apex:page>
4. 生成的 HTML 将发送到浏览器。

如果回发请求指示页面重定向和重定向 是使用相同控制器和 原始页面的控制器扩展，回发请求 为该页面执行。否则，将执行 get 请求 页面。如果回发请求包含组件，则只有 返回回发请求的 ID 查询参数。<apex:form>

提示

可以使用 上的属性来控制是否执行回发或获取请求。如果设置为 true，则 get 请求被执行。将其设置为 false 不会忽略限制 当且仅当目标 使用相同的控制器和适当的扩展子集。如果设置为 false，则 Target 不满足这些要求，将发出 GET 请求。setRedirectpageReferencesetRedirectsetRedirect

一旦用户被重定向到另一个页面，视图状态和 控制器对象将被删除。

有关回发请求的特定示例，请参见 Visualforce 页面执行顺序示例。

Visualforce 页面执行示例 次序

以下示例说明了 Visualforce 页面作为用户的生命周期 与它交互。示例中使用的页面旨在显示有关以下内容的信息 帐户，页面上变量的值，并允许用户编辑详细信息 如果键值设置为除 false 之外的任何值，则帐户。

设置 Visualforce 页面 示例：

1. 为名为componentControllerpublic class componentController { public String selectedValue { get; set { editMode = (value != null); // Side effect here - don't do this! selectedValue = value; } } public Boolean editMode {get; private set;} }
2. 创建一个名为 ：editMode<apex:component controller="componentController"> <apex:attribute name="value" type="String" description="Sample component." assignTo="{!selectedValue}"/> <p> Value = {!value}<br/> selectedValue = {!selectedValue}<br/> EditMode = {!EditMode} </p> </apex:component>
3. 创建一个名为 ：myControllerpublic with sharing class myController { private final Account account; public myController() { account = [select id, name, site, NumberOfEmployees, Industry from Account where id = :ApexPages.currentPage().getParameters().get('id')]; } public Account getAccount() { return account; } public PageReference save() { update account; return null; } public PageReference cancel() { return null; } }
4. 创建一个名为lifecyclepublic with sharing class lifecycle { private final Account acct; Integer EmpAdd; public lifecycle(myController controller) { this.acct = (Account)controller.getAccount(); } public String getGreeting() { return acct.name + ' Current Information'; } public void resetEmp() { acct.numberofemployees = 10; update acct; } }
5. 创建一个名为 ：setEmps<apex:page controller="myController" tabStyle="Account" extensions="lifecycle" action="{!resetEmp}"> <apex:messages /> <apex:pageBlock title="{!greeting}"> <apex:outputLabel value="{!$ObjectType.account.fields.Name.label}: " for="acctName"/> <apex:outputField value="{!account.name}" id="acctName"/> <br/> <apex:outputLabel value="{!$ObjectType.account.fields.NumberOfEmployees.label}: " for="emps"/> <apex:outputField value="{!account.NumberOfEmployees}" id="emps"/> <br/> </apex:pageBlock> <apex:pageBlock title="Variable values"> <c:editMode value="{!$CurrentPage.parameters.key}"/> </apex:pageBlock> <apex:form rendered="{!$CurrentPage.parameters.key = 'true'}"> <apex:pageBlock title="Update the Account" id="thePageBlock"> <apex:pageBlockSection columns="1"> <apex:inputField id="aName" value="{!account.name}"/> <apex:inputField value="{!account.NumberOfEmployees}"/> <apex:pageBlockSectionItem> <apex:outputLabel value="{!$ObjectType.account.fields.Industry.label}" for="acctIndustry"/> <apex:actionRegion> <apex:inputField value="{!account.Industry}" id="acctIndustry"> <apex:actionSupport event="onchange" rerender="thePageBlock" status="status"/> </apex:inputField> </apex:actionRegion> </apex:pageBlockSectionItem> </apex:pageBlockSection> <apex:pageBlockButtons location="bottom"> <apex:commandButton action="{!save}" value="Save"/> <apex:commandButton action="{!cancel}" value="Cancel" immediate="true"/> </apex:pageBlockButtons> </apex:pageBlock> </apex:form> </apex:page>

获取请求示例一

对于第一个示例，请访问页面 使用格式为 https:// Salesforce_instance/apex/setEmps？id=recordId 的 URL， 其中 是实例的名称（例如，），并且是 组织中的客户记录（例如，）。您将看到一个页面，其内容类似于 以后：setEmpsSalesforce_instancena1recordID001D000000IRt53

让我们跟踪生命周期，看看为什么页面会显示它的作用。既然你已经 通过输入 URL 直接请求页面，此页面是 get 的结果 请求，而不是回发请求。

1. 在 get 请求中发生的第一件事是 调用自定义控制器和控制器扩展。该方法是 控制器，方法是 扩展上的构造函数。这些对象被执行，并且这两个对象现在存在。 控制器现在有一个名为 的变量，它是使用 URL 中的参数的查询的结果，用于标识 要查询的帐户对象。该扩展现在有一个变量，称为 ，该变量是通过调用 控制器。该方法具有 无副作用。myControllerlifecycleaccountidacctgetAccountgetAccount
2. get 请求的下一步是创建自定义组件并执行 关联控制器或控制器扩展上的构造函数方法。页面 包括一个自定义 元件：<c:editMode value="{!$CurrentPage.parameters.key}"/>这 自定义组件具有关联的控制器，但控制器没有 Explicit 构造函数。与所有没有显式的 Apex 对象一样 构造函数，对象是使用隐式的、无参数的、公共的 构造 函数。作为创建自定义组件的一部分，value 属性 在自定义组件上设置。在这种情况下，它等于 表达式 。由于我们没有在 URL 中指定属性，因此设置为 null。{!$CurrentPage.parameters.key}keyvalue
3. 创建自定义组件后，将执行这些自定义组件上的所有属性。属性是 setter 将此属性的值赋给 关联的自定义组件控制器。自定义组件确实有一个方法，因此会执行它。该方法将 on 属性设置为属性。该属性设置为 null，因此设置为 null。assignToassignToeditModeassignToassignToselectedValuevaluevalueselectedValue
4. get 请求的下一步是计算组件、表达式和 所需的 getter 和 setter 方法。虽然我们将在下面逐步介绍这些， 请记住，这些评估的顺序是不确定的，可能是 与以下内容不同：action<apex:page>
   • 组件 具有一个属性，该属性 调用 上的方法 扩展。该方法将对象上的字段设置为 10。<apex:page>actionresetEmpnumberofemployeesacct
   • 页面上有几个计算表达式。让我们关注三个：
     • <apex:pageBlock title=”{!greeting}”>该属性调用 getter 方法 生命周期扩展。这在页面上呈现为 “全球媒体时事信息”。title<apex:pageblock>getGreeting
     • <apex:form rendered=”{!$CurrentPage.parameters.key = ‘true’}”>设置了 on 属性 基于参数的值。我们在调用 页面，因此不会呈现表单。rendered<apex:form>keykey
     • Value = {!value}<br/> selectedValue = {!selectedValue}<br/> EditMode = {!EditMode}此表达式出现在自定义中 元件。我们已经讨论过了，并且已经准备好了 但是，对于 null，则 的值尚未 已知。 是 上的布尔变量。它是根据 是否是 等于 null：valueselectedValueEditModeEditModecomponentControllervalueset { selectedValue = value; // Side effect here - don't do this! editMode = (value != null); }由于为 null，因此设置为 自。注意 但是，setter 方法存在副作用 为。如 部分设置，我们还设置为 。由于为 null， 这不会改变任何事情，但这种行为有一个 影响在后面的示例中。valueEditModefalseEditModeeditModeselectedValuevaluevalue
   • 其他表达式和方法的计算方式类似 方式。
5. 由于组件不是 呈现时，不会创建视图状态。<apex:form>
6. get 请求的最后一步是将 HTML 发送到浏览器，浏览器 呈现 HTML。

获取请求示例二

对于第二个示例，使用格式为 https:// Salesforce_instance/apex/setEmps？id=recordId&key=false 的 URL 访问页面。 其中 是实例的名称（例如，），并且是 ID 组织中的客户记录（例如，）。与第一个示例不同，此示例包括 第二个参数 key=false。您将看到一个包含内容的页面 类似于以下内容：setEmpsSalesforce_instancena1recordID001D000000IRt53

让我们再次跟踪生命周期。此页面也是 get 请求的结果：

1. 在 get 请求中发生的第一件事是 调用自定义控制器和控制器扩展。该方法是 上的构造函数 控制器和方法 是扩展的构造函数。这些被执行，现在有两个对象 存在。控制器现在有一个变量，称为 ，它是查询的结果，该查询使用 URL 中的参数来标识哪个 要查询的客户记录。该扩展现在有一个变量，称为 ，该变量是通过调用 控制器。myControllerlifecycleaccountidacctgetAccount
2. get 请求的下一步是创建自定义组件并执行 关联控制器或控制器扩展上的构造函数方法。页面 包括一个自定义 元件：<c:editMode value="{!$CurrentPage.parameters.key}"/>这 自定义组件具有没有构造函数的关联控制器，因此 控制器对象是使用隐式的、无参数的、公共的 构造 函数。作为创建自定义组件的一部分，自定义组件上的属性 已设置。在这种情况下，它等于表达式 的结果。我们 将属性指定为 false，因此设置为 假。value{!$CurrentPage.parameters.key}keyvalue
3. 创建自定义组件后，将执行这些自定义组件上的所有属性。该方法将 on 属性设置为属性。该属性设置为 false，因此设置为 false。assignToassignToselectedValuevaluevalueselectedValue
4. get 请求的下一步是计算组件、表达式和 所需的 getter 和 setter 方法。虽然我们将在下面逐步介绍这些， 请记住，这些评估的顺序是不确定的，可能是 与以下内容不同：action<apex:page>
   • 组件 具有一个属性，该属性 调用 上的方法 扩展。该方法将对象上的字段设置为 10。<apex:page>actionresetEmpnumberofemployeesacct
   • 在页面上的表达式中，让我们看看我们选择的三个是如何计算的：<apex:pageBlock title=”{!greeting}”>属性 on 调用 getter 方法 on 生命周期扩展。它在页面上呈现为 “全球媒体时事信息”。title<apex:pageblock>getGreeting<apex:form rendered=”{!$CurrentPage.parameters.key = ‘true’}”>呈现的属性 on 是根据 参数。 我们设置为何时 调用页面，因此不会呈现表单。<apex:form>keykeyfalseValue = {!value}<br/> selectedValue = {!selectedValue}<br/> EditMode = {!EditMode}此表达式出现在自定义组件中。既然不是 null，是 设置为 。在 此点设置为 null。记得 但是，setter 方法具有 副作用。在本例中，副作用设置为属性 在自定义组件上。由于设置为 ，设置为 假。这说明了为什么你不应该使用副作用 在你的方法中。如果评估顺序不同，并且 的值是在 setter for 的计算结果仍为 null。执行 订单不保证，结果可能 更改下次访问此页面的时间。valueEditModetrueselectedValueEditModeselectedValuevaluevaluefalseselectedValueselectedValueEditModeselectedValueselectedValue警告不要在吸气剂中使用副作用 或二传手！
5. 由于组件不是 呈现时，不会创建视图状态<apex:form>
6. get 请求的最后一步是将 HTML 发送到浏览器，浏览器 呈现 HTML。

获取请求示例三

对于第三个示例，使用格式为 https:// Salesforce_instance/apex/setEmps？id=recordId&key=true 的 URL 访问页面。 其中 是实例的名称（例如，），并且是 组织中的客户记录（例如，）。与第二个示例不同，此示例设置 key=true。您将看到一个页面，其内容类似于 以后：setEmpsSalesforce_instancena1recordID001D000000IRt53

让我们再跟踪一次 get 请求生命周期：

1. 在 get 请求中发生的第一件事是 调用自定义控制器和控制器扩展。该方法是 控制器，方法是 扩展上的构造函数。这些对象被执行，并且这两个对象现在存在。 控制器现在有一个变量，称为 ，它是查询的结果，该查询使用 URL 中的参数来标识哪个 要查询的客户记录。该扩展现在有一个变量，称为 ，该变量是通过调用 控制器。myControllerlifecycleaccountidacctgetAccount
2. get 请求的下一步是创建自定义组件并执行 关联控制器或控制器扩展上的构造函数方法。页面 包括一个自定义 元件：<c:editMode value="{!$CurrentPage.parameters.key}"/>这 自定义组件具有没有构造函数的关联控制器，因此 控制器对象是使用隐式的、无参数的、公共的 构造 函数。作为创建自定义组件的一部分，自定义组件上的属性 已设置。在这种情况下，它等于表达式 的结果。我们 将属性指定为 true，则设置为 真。value{!$CurrentPage.parameters.key}keyvalue
3. 创建自定义组件后，将执行这些自定义组件上的所有属性。该方法将 on 属性设置为属性。该属性设置为 true，因此设置为 true。assignToassignToselectedValuevaluevalueselectedValue
4. get 请求的下一步是计算组件、表达式和 所需的 getter 和 setter 方法。虽然我们将在下面逐步介绍这些， 请记住，这些评估的顺序是不确定的，可能是 与以下内容不同：action<apex:page>
   • 组件 具有一个属性，该属性 调用 上的方法 扩展。该方法将对象上的字段设置为 10。<apex:page>actionresetEmpnumberofemployeesacct
   • 在页面上的表达式中，让我们看看我们选择的三个是如何计算的：<apex:pageBlock title=”{!greeting}”>属性 on 调用 getter 方法 on 生命周期扩展。它在页面上呈现为 “全球媒体时事信息”。title<apex:pageblock>getGreeting<apex:form rendered=”{!$CurrentPage.parameters.key = ‘true’}”>属性 on 是根据 参数。 我们设置为何时 调用页面，以便呈现表单。rendered<apex:form>keykeytrueValue = {!value}<br/> selectedValue = {!selectedValue}<br/> EditMode = {!EditMode}此表达式出现在自定义组件中。既然不是 null，是 设置为 。如 前面的示例设置为 null。副作用 在 setter 方法中设置为 。valueEditModetrueselectedValueEditModeselectedValuetrue
5. 由于组件是 呈现时，将创建视图状态。<apex:form>
6. get 请求的最后一步是将 HTML 发送到浏览器，浏览器 呈现 HTML。

回发请求示例

与前两个示例不同，第三个示例呈现了可编辑的最终页面 字段可单击按钮。要了解回发请求的工作原理，请使用最终的 页面，将帐户名称更改为“Pan Galactic Media”， 员工人数为 42 人“，行业人数为 ”其他”。然后 点击保存。这将启动回发请求：

1. 回发请求中发生的第一件事是视图状态为 解码。视图状态包含呈现 页。如果在回发请求期间操作失败，则视图状态为 用于向用户显示页面。
2. 接下来，对控制器和控制器上的所有表达式和方法进行计算 扩展被执行。在页面上的表达式中，让我们看看我们的 对选定的三个进行评估：<apex:pageBlock title=”{!greeting}”>属性 on 调用生命周期扩展上的 getter 方法。在我们的编辑中， 我们更改了帐户名称的值。因此，值更改为 “泛银河媒体当前信息。”title<apex:pageblock>getGreetinggreeting<apex:form rendered=”{!$CurrentPage.parameters.key = ‘true’}”>属性 on 是 根据参数的值进行设置。我们没有更改参数，因此值 在视图状态中。由于该值为 true，因此当 视图状态已创建，它仍然是 true，表单是 呈现。rendered<apex:form>keykeyValue = {!value}<br/> selectedValue = {!selectedValue}<br/> EditMode = {!EditMode}我们没有更改这些值中的任何一个，因此，对于每个 表达式，则使用视图状态中的值。
3. 最后，保存操作（触发回发请求的操作）是 评价。保存操作是以下方法 控制器：public PageReference save() { update account; return null; }这 方法使用新数据更新记录。如果此方法失败，则 如果用户没有更新记录的权限，或者如果 有由更改触发的验证规则，页面是 与描述错误的错误消息一起显示。值 输入的用户不会丢失。它们保持用户单击时的状态 “保存”按钮。假设没有错误，则 对象上的数据会更新，视图状态会更新，并且，由于 触发回发的操作不包括页面重定向，即视图 状态已更新。生成的 HTML 将发送到浏览器：

测试自定义控制器和控制器扩展

控制器扩展和自定义控制器，与所有 Apex 脚本一样，应由 单元测试。单元测试是验证特定代码段是否为类的方法 工作正常。单元测试方法不带参数，不向 数据库，并在方法定义中使用关键字进行标记。testMethod

在为控制器扩展和自定义控制器类编写单元测试时，可以 设置可在测试中使用的查询参数。例如，以下 自定义控制器和标记基于控制器方法中的示例，但已扩展为在 URL 中显示以下查询参数 对于页面：.测试方法类 下面，它练习了此页面的功能：?qp=yyyy

public class thecontroller {

            private String firstName;
            private String lastName;
            private String company;
            private String email;
            private String qp;

            public thecontroller() {
                this.qp = ApexPages.currentPage().getParameters().get('qp');
            }

            public String getFirstName() {
                  return this.firstName;
            }

            public void setFirstName(String firstName) {
                  this.firstName = firstName;
            }

            public String getLastName() {
                  return this.lastName;
            }

            public void setLastName(String lastName) {
                  this.lastName = lastName;
            }

            public String getCompany() {
                  return this.company;
            }

            public void setCompany(String company) {
                  this.company = company;
            }

            public String getEmail() {
                  return this.email;
            }

            public void setEmail(String email) {
                  this.email = email;
            }

            public PageReference save() {
                PageReference p = null;
                
                if (this.qp == null || !'yyyy'.equals(this.qp)) {
                    p = Page.failure;
                    p.getParameters().put('error', 'noParam');
                } else {
                    try {
                        Lead newlead = new Lead(LastName=this.lastName, 
                                                FirstName=this.firstName, 
                                                Company=this.company, 
                                                Email=this.email);
                        insert newlead;
                    } catch (Exception e) {
                        p = Page.failure;
                        p.getParameters().put('error', 'noInsert');
                    }
                }
                
                if (p == null) {
                    p = Page.success;
                }
                
                p.setRedirect(true);
                return p;
            }
 }

控制器调用另外两个页面：成功页面和失败页面。文本 对于此示例，这些页面并不重要。它们只需要存在。

以下标记使用上面的控制器：

<apex:page controller="thecontroller" tabstyle="lead">
   <apex:pageBlock>
      <apex:form>
         <h1>Test page for adding leads</h1>
         <p>This is a test page for adding leads.</p>
         <p>First name: <apex:inputText value="{!FirstName}"></apex:inputText></p>
         <p>Last name: <apex:inputText value="{!LastName}"></apex:inputText></p>
         <p>Company: <apex:inputText value="{!Company}"></apex:inputText></p>
         <p>Email address: <apex:inputText value="{!Email}"></apex:inputText></p>
         <apex:commandButton action="{!save}" value="Save New Lead"/>
      </apex:form>
   </apex:pageBlock>
</apex:page>

以下类测试控制器：

@isTest
public class thecontrollerTests {

    public static testMethod void testMyController() {
        PageReference pageRef = Page.success;
        Test.setCurrentPage(pageRef);
      
        thecontroller controller = new thecontroller();
        String nextPage = controller.save().getUrl();

        // Verify that page fails without parameters
        System.assertEquals('/apex/failure?error=noParam', nextPage);

        // Add parameters to page URL
        ApexPages.currentPage().getParameters().put('qp', 'yyyy');
      
        // Instantiate a new controller with all parameters in the page
        controller = new thecontroller(); 
        controller.setLastName('lastname');
        controller.setFirstName('firstname');
        controller.setCompany('acme');
        controller.setEmail('firstlast@acme.com');
        nextPage = controller.save().getUrl();

        // Verify that the success page displays
        System.assertEquals('/apex/success', nextPage);
        Lead[] leads = [select id, email from lead where Company = 'acme'];
        System.assertEquals('firstlast@acme.com', leads[0].email);
    }
}

提示

如果您正在测试控制器，您可能会看到以下错误消息：

Method does not exist or incorrect signature: Test.setCurrentPage(System.PageReference)

验证规则和自定义控制器

如果用户在使用自定义控制器的 Visualforce 页面上输入数据，并且该数据导致验证 规则错误，该错误可以显示在 Visualforce 页面上。就像使用标准控制器的页面一样，如果验证 规则错误位置是与组件关联的字段， 错误显示在那里。如果设置了验证规则错误位置 在页面顶部，使用 中的组件 显示错误。但是，要获取页面信息， 自定义控制器必须捕获异常。<apex:inputField><apex:messages><apex:page>例如，假设您有以下内容 页：

<apex:page controller="MyController" tabStyle="Account">
  <apex:messages/>
  <apex:form>
   <apex:pageBlock title="Hello {!$User.FirstName}!">
     This is your new page for the {!name} controller. <br/>
     You are viewing the {!account.name} account.<br/><br/>
     Change Account Name: <p></p>
     <apex:inputField value="{!account.name}"/> <p></p>
     Change Number of Locations:
     <apex:inputField value="{!account.NumberofLocations__c}" id="Custom_validation"/> 
         <p>(Try entering a non-numeric character here, then hit save.)</p><br/><br/>
     <apex:commandButton action="{!save}" value="Save New Account Name"/>
   </apex:pageBlock>
  </apex:form>
</apex:page>

注意

这 必须在此页的 URL 中将有效客户记录的 ID 指定为查询参数 进行渲染。例如，http:// MyDomainName.salesforce.com/apex/myValidationPage?id=001x000xxx3Jsxb。你 需要编写一个自定义控制器，例如 以后：

public class MyController {
  Account account;

  public PageReference save() {
    try{
        update account;
       }
    catch(DmlException ex){
        ApexPages.addMessages(ex);
       }
    return null;
  }

  public String getName() {
    return 'MyController';
  }

  public Account getAccount() {
    if(account == null)
      account = [select id, name, numberoflocations__c from Account
        where id = :ApexPages.currentPage().getParameters().get('id')];
      return account;

  }
}

什么时候 用户保存页面，如果触发验证错误，则捕获异常并 在页面上显示，就像标准控制器一样。

使用 transient 关键字

使用关键字声明实例 无法保存且不应作为视图状态的一部分传输的变量 用于 Visualforce 页面。为 例：

transient

Transient Integer currentTotal;

您还可以在 Apex 中使用关键字 可序列化的类，即在控制器、控制器扩展或类中 实现 or 接口。此外，还可以在定义类型的类中使用 在可序列化类中声明的字段。transientBatchableSchedulabletransient

将变量声明为缩减视图 状态大小。关键字的一个常见用例是 Visualforce 页面上的字段，该字段仅在页面持续时间内需要 请求，但不应是页面视图状态的一部分，并且会使用过多的系统 在请求期间要多次重新计算的资源。transienttransient

某些 Apex 对象会自动被视为瞬态对象，也就是说，它们的值不会 保存为页面视图状态的一部分。这些对象包括：

• 页面引用
• XmlStream 类
• 集合自动标记为暂时性，仅当它们的对象类型 保留会自动标记为暂时性保留，例如保存点的集合
• 大多数对象由系统方法生成，例如 .Schema.getGlobalDescribe
• JSONParser类实例。

静态变量也不会得到 通过视图状态传输。

以下示例包含一个 Visualforce 页面和一个自定义控制器。点击 页面上的“刷新”按钮使瞬态日期为 已更新，因为每次刷新页面时都会重新创建它。非瞬态 date 继续具有其原始值，该值已从视图中反序列化 状态，所以它保持不变。

<apex:page controller="ExampleController">
  T1: {!t1} <br/>
  T2: {!t2} <br/>
  <apex:form>
    <apex:commandLink value="refresh"/>
  </apex:form>
</apex:page>

public class ExampleController {

    DateTime t1;
    transient DateTime t2;

    public String getT1() {
        if (t1 == null) t1 = System.now();
        return '' + t1;
    }

    public String getT2() {
        if (t2 == null) t2 = System.now();
        return '' + t2;
    }
}

标准列表控制器允许您创建可以显示或处理一组记录的 Visualforce 页面。现有 Salesforce 页面的示例 使用一组记录的包括列表页、相关列表、 和大规模行动页面。标准列表控制器可与 以下对象：

• 帐户
• 资产
• 运动
• 箱
• 联系
• 合同
• 想法
• 铅
• 机会
• 次序
• 产品2
• 溶液
• 用户
• 自定义对象

以下主题包括有关使用 标准列表控制器：

• 关联标准列表控制器 使用 Visualforce 页面
• 使用列表控制器访问数据
• 使用标准列表控制器操作
• 将列表视图与标准列表控制器一起使用
• 使用标准列表覆盖选项卡 控制器
• 使用标准列表添加自定义列表按钮 控制器

关联标准列表控制器 使用 Visualforce 页面

使用标准列表控制器与使用标准列表控制器非常相似 控制器。首先在组件上设置属性，然后在同一组件上设置属性。standardController<apex:page>recordSetVar例如，要将页面与帐户的标准列表控制器相关联，请使用 以后 标记：

<apex:page standardController="Account" recordSetVar="accounts">

注意

什么时候 您在标签上使用该属性，不能同时使用该属性。standardController<apex:page>controller

该属性不仅指示 页面使用列表控制器，它设置记录集合的变量名称。此变量 可用于访问记录集合中的数据。recordSetVar

使用列表控制器访问数据

使用表达式语法访问记录

将页面与列表控制器关联后，可以使用以下命令对一组记录执行操作 表达式语言语法。例如，若要创建会计科目表，请使用以下命令 标记：

<apex:page standardController="Account" recordSetVar="accounts" tabstyle="account" sidebar="false">
  <apex:pageBlock>
    <apex:pageBlockTable value="{!accounts}" var="acc">
      <apex:column value="{!acc.name}"/>
    </apex:pageBlockTable>
  </apex:pageBlock>
</apex:page>

这 示例使用组件 生成数据表。属性已设置 添加到标准列表控制器加载的变量，该变量是循环访问的记录列表。

<apex:pageBlockTable>value{!accounts}<apex:pageBlockTable>

对于列表中的每条记录，将记录分配给变量。然后，在表中构造一个新行， 使用组件定义的行。该组件使用表示当前记录的变量， 以提取该记录的字段值。<apex:pageBlockTable>acc<apex:pageBlockTable><apex:column><apex:column>acc

列出的组织中的所有帐户名称的生成页面：

使用标准列表控制器时，返回的记录会自动对第一个记录进行排序 由当前视图定义的数据列。使用扩展或自定义列表控制器时，可以控制 sort 方法。

注意

此页面未在请求中指定筛选器，因此页面显示最后一个 使用过滤器。有关将筛选器与列表控制器一起使用的信息，请参阅将列表视图与标准列表控制器一起使用。

与 Lightning 平台 API 中的查询一样，您可以使用表达式语言语法来执行以下操作 从相关记录中检索数据。与标准控制器一样，您最多可以遍历 5 个 子与子关系的级别和父与子关系的一个级别。

带 ID 的访问记录

在典型的页面交互中，用户先从列表视图中选择记录，然后导航到 页面，然后 Visualforce 将它们发送到控制器。您还可以通过以下方式手动指定记录 将所选记录直接设置到控制器上。

标准列表控制器基于类。使用该方法从 Apex 控制器。StandardSetController ApexApexPages.StandardSetController.setSelected()

让我们看一些代码。此示例使用前面示例中的标记来显示 表中的帐户名称。然后，它包含自定义 Apex 代码来请求特定记录 显示。

<apex:page standardController="Account" recordSetVar="accounts" extensions="MyControllerExtension">
  <apex:pageBlock >
    <apex:pageBlockTable value="{!accounts}" var="acc">
      <apex:column value="{!acc.name}"/>
    </apex:pageBlockTable>
  </apex:pageBlock>
</apex:page>

public with sharing class MyControllerExtension {
    private ApexPages.StandardSetController setController;

    public MyControllerExtension(ApexPages.StandardSetController setController) {
        this.setController = setController;
        
        Account [] records = [SELECT Id, Name FROM Account LIMIT 30];
        setController.setSelected(records);
    }
}

标准列表控制器基于 Apex 类。检索分配给 list 控制器，使用 方法 .StandardSetControllerApexPages.StandardSetController.setSelected()

在 的构造函数中，将 SOQL 请求从 Account 对象中选择 ID 和 Name，并限制前 30 个结果。 然后，定义 记录在页面加载时被选中。MyControllerExtensionsetController.setSelected(records)

注意

标准列表控制器最多可以返回 10,000 条记录。自定义控制器可以工作 具有更大的结果集。请参阅使用大型数据集。

还可以通过将记录 ID 列表作为多个包含来将它们传递到 URL 中 查询参数。例如，具有三个帐户 ID 的 URL 如下所示： /apex/pageName?ids=001xx00account1&ids=001xx00account2&ids=001xx00account3

某些浏览器对 URL 的长度有硬性限制。如果您的 URL 包含太多 ID，则 达到该限制的可能性更大，导致您的页面行为不端。而不是 手动将 ID 包含在 URL 字符串中，最好将所选记录设置为 控制器。

使用标准列表控制器操作

操作方法在页面执行逻辑或导航时 事件发生，例如当用户单击按钮或将鼠标悬停在 页。可以通过在以下参数之一的参数中使用表示法从页面标记中调用操作方法 标签：{! }action

• <apex：commandButton> 创建一个按钮，该按钮调用 行动
• <apex：commandLink> 创建一个调用操作的链接
• <apex：actionPoller> 定期调用操作
• <apex：actionSupport> 创建一个事件（例如 “onclick”、“onmouseover”等） 命名组件，调用操作
• <apex：actionFunction> 定义了一个新的 JavaScript 调用操作的函数
• <apex：page> 调用操作 加载页面时

支持的操作方法如下表所示 由所有标准列表控制器。您可以关联这些操作 替换为任何包含属性的 Visualforce 组件。

action

行动	描述
save	插入新记录或更新现有记录 改变。此操作完成后，该操作会将用户返回到 原始页面（如果已知）或主页。save
quicksave	插入新记录或更新现有记录 改变。与操作不同，不会重定向用户 到另一页。savequicksave
list	返回标准列表页的 PageReference 对象，基于 在最近使用的该对象的列表筛选器上，当 未由 用户。filterId
cancel	中止编辑操作。此操作完成后， 操作返回 用户到用户最初调用编辑的页面。cancel
first	显示集中记录的第一页。
last	显示集中记录的最后一页。
next	显示集中记录的下一页。
previous	显示集中记录的上一页。

在以下示例中，用户指定用于查看的筛选器 帐户记录。当用户单击 Go 时， 使用选定的筛选器显示标准列表页。

<apex:page standardController="Account" recordSetVar="accounts">
   <apex:form>
       <apex:selectList value="{!filterid}" size="1">
           <apex:selectOptions value="{!listviewoptions}"/>
       </apex:selectList>
       <apex:commandButton value="Go" action="{!list}"/>
   </apex:form>
</apex:page>

使用列表控制器进行分页

您可以使用列表控制器将分页添加到页面，方法是利用 和 操作。例如，如果 创建具有以下标记的页面：

nextprevious

<apex:page standardController="Account" recordSetvar="accounts">
  <apex:pageBlock title="Viewing Accounts">
  <apex:form id="theForm">
    <apex:pageBlockSection >
      <apex:dataList var="a" value="{!accounts}" type="1">
        {!a.name}
      </apex:dataList>
    </apex:pageBlockSection>
    <apex:panelGrid columns="2">
      <apex:commandLink action="{!previous}">Previous</apex:commandlink>
      <apex:commandLink action="{!next}">Next</apex:commandlink>
    </apex:panelGrid>
  </apex:form> 
  </apex:pageBlock>
</apex:page>

默认情况下，列表控制器返回 20 页面上的记录。控制上显示的记录数 每个页面，使用控制器扩展来设置 .有关控制器的信息 扩展，请参阅构建控制器扩展。

pageSize

注意

使用分页时，当存在 集合中已修改的行。这包括添加的任何新行 通过扩展操作添加到集合中。错误的处理 在这种情况下，消息遵循标准行为，可以 显示在页面上。例如，您可以使用 or 组件来显示 发送给用户的错误消息。<apex:pageMessages><apex:messages>

将列表视图与标准列表控制器一起使用

许多 Salesforce 页面都包含列表视图，允许您筛选记录 显示在页面上。例如，在商机主页上， 您可以选择仅查看您拥有的商机列表 从列表视图中选择 My Opportunity 下拉列表。在与列表控制器关联的页面上，您 还可以使用列表视图。例如，若要创建具有列表视图的简单帐户列表， 使用以下标记创建页面：

<apex:page standardController="Account" recordSetvar="accounts">
  <apex:pageBlock title="Viewing Accounts">
  <apex:form id="theForm">
    <apex:panelGrid columns="2">
      <apex:outputLabel value="View:"/>
      <apex:selectList value="{!filterId}" size="1">
        <apex:actionSupport event="onchange" rerender="list"/>
        <apex:selectOptions value="{!listviewoptions}"/>
      </apex:selectList>
    </apex:panelGrid>
    <apex:pageBlockSection >
      <apex:dataList var="a" value="{!accounts}" id="list">
        {!a.name}
      </apex:dataList>
    </apex:pageBlockSection>
  </apex:form> 
  </apex:pageBlock>
</apex:page>

当您打开该页面时，您会看到如下内容：

此页面与标准帐户控制器相关联，并且 组件 填充为 ，计算结果为用户可以看到的列表视图。当用户 从下拉列表中选择一个值，该值绑定到控制器的属性。 当更改时， 页面可用的记录会发生变化，因此，当 更新时， value 用于更新页面可用的记录列表。<apex:selectlist>{!listviewoptions}filterIdfilterId<apex:datalist>您还可以在编辑页面上使用视图列表，如下所示：

<apex:page standardController="Opportunity" recordSetVar="opportunities" 
              tabStyle="Opportunity"
    sidebar="false">
    <apex:form>
        <apex:pageBlock>
            <apex:pageMessages/>
            <apex:pageBlock>
                <apex:panelGrid columns="2">
                    <apex:outputLabel value="View:"/>
                    <apex:selectList value="{!filterId}" size="1">
                        <apex:actionSupport event="onchange" rerender="opp_table"/>
                        <apex:selectOptions value="{!listviewoptions}"/>
                    </apex:selectList>
                </apex:panelGrid>
            </apex:pageBlock>

            <apex:pageBlockButtons>
                <apex:commandButton value="Save" action="{!save}"/>
            </apex:pageBlockButtons>
            <apex:pageBlockTable value="{!opportunities}" var="opp" id="opp_table">
                <apex:column value="{!opp.name}"/>
                <apex:column headerValue="Stage">
                    <apex:inputField value="{!opp.stageName}"/>
                </apex:column>
                <apex:column headerValue="Close Date">
                    <apex:inputField value="{!opp.closeDate}"/>
                </apex:column>
            </apex:pageBlockTable>
        </apex:pageBlock>
    </apex:form>
</apex:page>

注意

如果用户更改列表视图，则在以下情况下会引发异常 集合中有已修改的行。错误消息的处理 在这种情况下，遵循标准行为，可以显示 在页面上。例如，您可以使用 or 组件来显示 发送给用户的错误消息。<apex:pageMessages><apex:messages>

使用列表控制器编辑记录

您也可以使用列表控制器编辑一组记录。为 例如，如果创建具有以下标记的页面：

<apex:page standardController="Opportunity" recordSetVar="opportunities" tabStyle="Opportunity" sidebar="false">
    <apex:form >
        <apex:pageBlock >
            <apex:pageMessages />
            <apex:pageBlockButtons >
                <apex:commandButton value="Save" action="{!save}"/>
            </apex:pageBlockButtons>
            <apex:pageBlockTable value="{!opportunities}" var="opp">
                <apex:column value="{!opp.name}"/>
                <apex:column headerValue="Stage">
                    <apex:inputField value="{!opp.stageName}"/>
                </apex:column>
                <apex:column headerValue="Close Date">
                    <apex:inputField value="{!opp.closeDate}"/>
                </apex:column>
            </apex:pageBlockTable>      
        </apex:pageBlock>
    </apex:form>
</apex:page>

您会看到一个允许您更新的页面 并保存商机的“阶段”和“结束日期”，如下所示：

有关详细信息，请参阅使用自定义列表控制器批量更新记录。

注意

如果用户不呈现与列表控制器中的 、 或操作关联的命令按钮和链接，则不会呈现 具有适当的权限。同样，如果没有特定记录 与页面、命令按钮和链接相关联 操作不是 呈现。savequicksaveeditedit