PageContext class

SharePoint 页面上下文对象。

注解

页面上下文为公共 SharePoint 对象提供了标准的定义,该对象需要在客户端应用程序、Web 部件和其他组件之间共享。 导航至新页时通常通过 REST 查询提取数据,但也可以通过 Web 服务器预先加载,或从自定义应用程序缓存中进行填充。

构造函数

(constructor)(serviceScope)

构造 类的新实例PageContext

属性

aadInfo

用于与 Azure Active Directory 通信的上下文信息。 如果当前页没有关联的 Azure Active Directory 租户,则此属性将未定义。

cultureInfo

它为应用程序的当前用户提供区域性信息。 此类主要用于 PageContext 类。

isInitialized

返回是否已 PageContext 初始化 。

legacyPageContext

提供某些旧脚本可能需要的经典 SharePoint 属性的对象。

list

承载该页面的 SharePoint 列表的上下文信息。 如果没有与当前页关联的列表,则未定义此属性。

listItem

承载该页面的 SharePoint 列表项的上下文信息。 如果没有与当前页关联的列表项,则未定义此属性。

serviceKey

PageContext 的服务密钥。

site

承载页面的 SharePoint 网站集 (“SPSite”) 上下文信息。

user

它为访问该页的 SharePoint 用户提供上下文信息。 此类主要用于 PageContext 类。

web

托管页面的 SharePoint 网站的上下文信息 (“SPWeb”) 。

构造函数详细信息

(constructor)(serviceScope)

构造 类的新实例PageContext

constructor(serviceScope: ServiceScope);

参数

serviceScope
ServiceScope

属性详细信息

aadInfo

用于与 Azure Active Directory 通信的上下文信息。 如果当前页没有关联的 Azure Active Directory 租户,则此属性将未定义。

get aadInfo(): AzureActiveDirectoryInfo | undefined;

属性值

@microsoft/sp-page-context!AzureActiveDirectoryInfo:class | undefined

cultureInfo

它为应用程序的当前用户提供区域性信息。 此类主要用于 PageContext 类。

get cultureInfo(): CultureInfo;

属性值

isInitialized

返回是否已 PageContext 初始化 。

get isInitialized(): boolean;

属性值

boolean

legacyPageContext

提供某些旧脚本可能需要的经典 SharePoint 属性的对象。

get legacyPageContext(): any;

属性值

any

注解

提供此属性是为了促进旧代码的迁移。 它返回一个 JavaScript 对象,其内容类似于经典页面中的 _spPageContextInfo 窗口变量。 SharePoint 的未来版本可能会更改此变量的内容。 因此,建议新项目改用 SharePoint 框架 TypeScript API,因为它们已完整记录,并提供可靠的向后兼容性保证。

注意:如果在 中 legacyPageContext 公开了某些功能,但似乎没有适当的 TypeScript API,请在 GitHub 上提出问题。 其意图是,任何新式应用程序都不应依赖于 对象 legacyPageContext

list

承载该页面的 SharePoint 列表的上下文信息。 如果没有与当前页关联的列表,则未定义此属性。

get list(): SPList | undefined;

属性值

SPList | undefined

listItem

承载该页面的 SharePoint 列表项的上下文信息。 如果没有与当前页关联的列表项,则未定义此属性。

get listItem(): SPListItem | undefined;

属性值

SPListItem | undefined

serviceKey

PageContext 的服务密钥。

static readonly serviceKey: ServiceKey<PageContext>;

属性值

site

承载页面的 SharePoint 网站集 (“SPSite”) 上下文信息。

get site(): SPSite;

属性值

user

它为访问该页的 SharePoint 用户提供上下文信息。 此类主要用于 PageContext 类。

get user(): SPUser;

属性值

web

托管页面的 SharePoint 网站的上下文信息 (“SPWeb”) 。

get web(): SPWeb;

属性值