StartPage 元素 (PropertiesDefinition complexType)

(SharePoint 外接程序清单)

适用范围：SharePoint 外接程序|SharePoint Foundation 2013 |SharePoint Server 2013

通常，启动 SharePoint 外接程序时访问的页面的 URL。 但是，它也可以是控制器方法的 URL，也可以是启动外接程序时调用的 Web 服务方法的 URL。

当 AppPrincipal 元素的子元素不是 Internal 时， StartPage 元素中指定的页面必须是支持 POST 谓词 (以及 GET) 的文件类型，以便可以在请求正文上发送 OAuth 上下文令牌。

通常在 Web 服务器中配置为支持 POST 的常见文件类型包括 aspx、php 以及支持服务器端代码的其他类型。 具有内部外接程序主体的外接程序不使用 OAuth，因此，此类外接程序的起始页可以是目标 Web 服务器中未配置为支持 POST 的类型。 例如，HTML 文件通常不支持 POST。

    <StartPage>http://domain_of_remote_component/Home.aspx?{StandardTokens}</StartPage>

如果远程 Web 服务器在协议为 HTTP 时将远程组件绑定到端口 80 以外的端口;如果协议为 HTTPS，则将远程组件绑定到 443 以外的端口，则必须显式包含该端口，如以下示例所示。

    <StartPage>http://domain_of_remote_component:3333/Home.aspx?{StandardTokens}</StartPage>

此元素的值可以包含某些标记，用于表示开发时未知的信息。 上面的“{StandardTokens}”就是一个示例。 有关详细信息，请参阅 SharePoint 外接程序中的 URL 字符串和标记。

在 Visual Studio 中调试时，适用于 Visual Studio 的 Microsoft Office 开发人员工具使用令牌 ~remoteWebUrl' 来代替协议和域，如以下示例所示。

    <StartPage>~remoteWebUrl/Home.aspx?{StandardTokens}</StartPage>

当使用 Visual Studio 中 SharePoint 外接程序项目的上下文菜单上的 “发布 ”选项打包加载项时，该令牌将自动替换为实际协议和域 (和端口（如果需要），) 由适用于 Visual Studio 的 Office 开发人员工具进行打包。 如果不使用发布向导 (或这样做，但远程组件正在部署到 Azure) ，则必须在打包 SharePoint 外接程序之前手动替换令牌。

如果外接程序使用 OAuth，则 StartPage 值的域部分必须与向 Microsoft Azure 访问控制 服务注册 SharePoint 外接程序时指定的外接程序域完全匹配， (ACS) 。 有关详细信息，请参阅 注册 SharePoint 外接程序。

元素信息

定义

    <xs:element name="StartPage" type="UrlElementDefinition" minOccurs="1" maxOccurs="1" >
         </xs:element>

元素和属性

如果架构定义了特定要求（如 sequence、 minOccurs、 maxOccurs 和 choice），请参阅定义部分。

父元素

子元素

无。

Attributes

无。