Informations utilisateur

Informations utilisateur

Ce guide montre comment définir l’identité de l’utilisateur actuel que Aspose.Words FOSS pour .NET rapporte via les champs de document liés à l’utilisateur.

UserInformation représente l’identité Aspose.Words FOSS que .NET utilise lors de l’évaluation des champs qui signalent «l’utilisateur actuel» — Name, Initials et Address. Elle est attachée aux paramètres d’évaluation des champs d’un document via FieldOptions.CurrentUser, et une solution de repli à l’échelle du processus est disponible via UserInformation.DefaultUser.

Définir l’utilisateur actuel

Document.FieldOptions (une instance FieldOptions) expose CurrentUser, un objet UserInformation. Définissez ses propriétés Name, Initials et Address avant de mettre à jour les champs d’informations utilisateur afin que les valeurs qu’ils rapportent correspondent à l’identité que votre application souhaite enregistrer. UserInformation.DefaultUser fournit une instance UserInformation statique, à l’échelle du processus, pour servir de repli lorsque le FieldOptions.CurrentUser d’un document n’a pas été défini explicitement.

Champs d’informations utilisateur

Trois sous-classes Field lisent l’identité de l’utilisateur actuel dans le corps du document : FieldUserName (le champ USERNAME, avec une propriété UserName), FieldUserAddress (le champ USERADDRESS, avec une propriété UserAddress), et FieldUserInitials (le champ USERINITIALS, avec une propriété UserInitials). Comme les autres champs, elles partagent le cycle de vie de base Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — et peuvent être insérées avec DocumentBuilder.InsertField(fieldCode) ou InsertField(fieldType, updateField) en utilisant FieldType.FieldUserName, FieldType.FieldUserAddress ou FieldType.FieldUserInitials.

Conseils et bonnes pratiques

• Définissez FieldOptions.CurrentUser avant d’appeler Update() sur un champ FieldUserName, FieldUserAddress ou FieldUserInitials, ou avant Document.UpdateFields() — sinon les champs se résolvent par rapport à ce que UserInformation est actuellement en vigueur.
• UserInformation.DefaultUser est une valeur par défaut partagée pratique lorsque la même identité s’applique à chaque document que votre application traite; définissez FieldOptions.CurrentUser par document lorsque différents documents nécessitent différents auteurs.
• Renseignez les trois Name, Initials et Address ensemble si vos modèles utilisent plus d’un des FieldUserName, FieldUserAddress et FieldUserInitials — laisser l’un d’eux vide produit un résultat de champ vide plutôt qu’une erreur.

Problèmes courants

FAQ

Quelle est la différence entre FieldOptions.CurrentUser et UserInformation.DefaultUser?

FieldOptions.CurrentUser est par document — définissez-le sur le FieldOptions d’un Document spécifique pour contrôler les champs d’informations utilisateur de ce document. UserInformation.DefaultUser est une solution de secours statique, valable pour tout le processus.

Quels champs UserInformation affecte-t-il ?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) et FieldUserInitials (USERINITIALS) — chacun lit la propriété correspondante Name, Address ou Initials à partir du UserInformation actif.

Dois-je appeler Update() après avoir modifié UserInformation?

Oui — modifier Name, Initials ou Address ne met pas à jour rétroactivement les champs déjà évalués dans le document; appelez Update() sur le champ spécifique ou Document.UpdateFields().

API Reference Résumé

Voir aussi

• Aspose.Words for .NET — Enterprise Documentation