Partager via


PageContext class

Objet de contexte de page SharePoint.

Remarques

Le contexte de la page fournit des définitions standard pour les objets SharePoint communs qui doivent être partagés entre l’application cliente, les composants WebPart et d’autres composants. Généralement, les données sont récupérées par l’intermédiaire des requêtes REST lors de l’accès à une nouvelle page, mais elles peuvent également être préchargées par le serveur Web ou remplies à partir d’un cache d’application personnalisé.

Constructeurs

(constructor)(serviceScope)

Construit une nouvelle instance de la PageContext classe

Propriétés

aadInfo

Informations contextuelles pour communiquer avec Azure Active Directory. Si aucun locataire Azure Active Directory n’est associé à la page active active, cette propriété n’est pas définie.

cultureInfo

Elle fournit les informations culturelles à l’utilisateur de l’application. Cette classe est principalement utilisée avec la PageContext classe .

isInitialized

Retourne si le PageContext a été initialisé.

legacyPageContext

Objet fournissant des propriétés SharePoint classiques qui peuvent être requises par certains scripts hérités.

list

Informations contextuelles pour la liste SharePoint qui héberge la page. Si aucune liste n’est associée à la page active, cette propriété n’est pas définie.

listItem

Informations contextuelles pour l’élément de liste SharePoint qui héberge la page. Si aucun élément de liste n’est associé à la page active, cette propriété n’est pas définie.

serviceKey

Clé de service pour PageContext.

site

Informations contextuelles pour la collection de sites SharePoint (« SPSite ») qui héberge la page.

user

Elle fournit des informations contextuelles pour l’utilisateur SharePoint qui accède à la page. Cette classe est principalement utilisée avec la PageContext classe .

web

Informations contextuelles pour le site SharePoint (« SPWeb ») qui héberge la page.

Détails du constructeur

(constructor)(serviceScope)

Construit une nouvelle instance de la PageContext classe

constructor(serviceScope: ServiceScope);

Paramètres

serviceScope
ServiceScope

Détails de la propriété

aadInfo

Informations contextuelles pour communiquer avec Azure Active Directory. Si aucun locataire Azure Active Directory n’est associé à la page active active, cette propriété n’est pas définie.

get aadInfo(): AzureActiveDirectoryInfo | undefined;

Valeur de propriété

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

cultureInfo

Elle fournit les informations culturelles à l’utilisateur de l’application. Cette classe est principalement utilisée avec la PageContext classe .

get cultureInfo(): CultureInfo;

Valeur de propriété

isInitialized

Retourne si le PageContext a été initialisé.

get isInitialized(): boolean;

Valeur de propriété

boolean

legacyPageContext

Objet fournissant des propriétés SharePoint classiques qui peuvent être requises par certains scripts hérités.

get legacyPageContext(): any;

Valeur de propriété

any

Remarques

Cette propriété est fournie pour faciliter la migration du code hérité. Elle renvoie un objet JavaScript dont le contenu est similaire à la _spPageContextInfo variable de fenêtre des pages classiques. Le contenu de cette variable peut changer dans les versions ultérieures de SharePoint. C’est pourquoi les nouveaux projets sont encouragés à utiliser les API TypeScript SharePoint Framework à la place, car ils sont entièrement documentés et fournissent des garanties de compatibilité descendante fiables.

REMARQUE : Si certaines fonctionnalités sont exposées dans le legacyPageContext mais ne semblent pas avoir une API TypeScript appropriée, veuillez signaler un problème sur GitHub. L’objectif est qu’aucune application moderne ne doit avoir besoin de s’appuyer sur l’objet legacyPageContext .

list

Informations contextuelles pour la liste SharePoint qui héberge la page. Si aucune liste n’est associée à la page active, cette propriété n’est pas définie.

get list(): SPList | undefined;

Valeur de propriété

SPList | undefined

listItem

Informations contextuelles pour l’élément de liste SharePoint qui héberge la page. Si aucun élément de liste n’est associé à la page active, cette propriété n’est pas définie.

get listItem(): SPListItem | undefined;

Valeur de propriété

SPListItem | undefined

serviceKey

Clé de service pour PageContext.

static readonly serviceKey: ServiceKey<PageContext>;

Valeur de propriété

site

Informations contextuelles pour la collection de sites SharePoint (« SPSite ») qui héberge la page.

get site(): SPSite;

Valeur de propriété

user

Elle fournit des informations contextuelles pour l’utilisateur SharePoint qui accède à la page. Cette classe est principalement utilisée avec la PageContext classe .

get user(): SPUser;

Valeur de propriété

web

Informations contextuelles pour le site SharePoint (« SPWeb ») qui héberge la page.

get web(): SPWeb;

Valeur de propriété