Gebruikersinformatie

Gebruikersinformatie

Deze gids laat zien hoe je de identiteit van de huidige gebruiker instelt die Aspose.Words FOSS voor .NET rapporteert via gebruikersgerelateerde documentvelden.

UserInformation vertegenwoordigt de identiteit Aspose.Words FOSS voor .NET gebruikt bij het evalueren van velden die “de huidige gebruiker” rapporteren — Name, Initials en Address. Het wordt gekoppeld aan de veld-evaluatie-instellingen van een document via FieldOptions.CurrentUser, en een procesbrede fallback is beschikbaar via UserInformation.DefaultUser.

De huidige gebruiker instellen

Document.FieldOptions (een FieldOptions instantie) maakt CurrentUser beschikbaar, een UserInformation object. Stel zijn Name, Initials en Address eigenschappen in voordat je gebruikersinformatie-velden bijwerkt, zodat de waarden die ze rapporteren overeenkomen met de identiteit die jouw applicatie wil vastleggen. UserInformation.DefaultUser biedt een statische, procesbrede UserInformation instantie als fallback wanneer de FieldOptions.CurrentUser van een document niet expliciet is ingesteld.

Gebruikersinformatie-velden

Drie Field subklassen lezen de identiteit van de huidige gebruiker in het documentgedeelte: FieldUserName (het USERNAME veld, met een UserName eigenschap), FieldUserAddress (het USERADDRESS veld, met een UserAddress eigenschap), en FieldUserInitials (het USERINITIALS veld, met een UserInitials eigenschap). Net als andere velden delen ze de basis Field levenscyclus — GetFieldCode(), Result, Update(), Unlink(), Remove() — en kunnen ze worden ingevoegd met DocumentBuilder.InsertField(fieldCode) of InsertField(fieldType, updateField) via FieldType.FieldUserName, FieldType.FieldUserAddress of FieldType.FieldUserInitials.

Tips en best practices

• Stel FieldOptions.CurrentUser in voordat je Update() aanroept op een FieldUserName, FieldUserAddress of FieldUserInitials veld, of vóór Document.UpdateFields() — anders worden de velden opgezocht tegen wat UserInformation momenteel van kracht is.
• UserInformation.DefaultUser is een handig gedeeld standaard wanneer dezelfde identiteit van toepassing is op elk document dat je applicatie verwerkt; stel FieldOptions.CurrentUser per document in wanneer verschillende documenten verschillende auteurs nodig hebben.
• Vul alle drie Name, Initials en Address samen in als je sjablonen meer dan één van FieldUserName, FieldUserAddress en FieldUserInitials gebruiken — een leeg laten van één veld levert een leeg veldresultaat op in plaats van een fout.

Veelvoorkomende problemen

FAQ

Wat is het verschil tussen FieldOptions.CurrentUser en UserInformation.DefaultUser?

FieldOptions.CurrentUser is per-document — stel het in op een specifieke Document’s FieldOptions om de gebruikersinformatievelden van dat document te beheren. UserInformation.DefaultUser is een statische, procesbrede fallback.

Op welke velden heeft UserInformation invloed?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) en FieldUserInitials (USERINITIALS) — elk leest de overeenkomstige Name, Address of Initials eigenschap van de actieve UserInformation.

Moet ik Update() aanroepen na het wijzigen van UserInformation?

Ja — het wijzigen van Name, Initials of Address werkt velden die al in het document zijn geëvalueerd niet retroactief bij; roep Update() aan op het specifieke veld of Document.UpdateFields().

API Reference Samenvatting

Zie ook

• Aspose.Words for .NET — Enterprise Documentation