Användarinformation

Användarinformation

Denna guide visar hur man ställer in den aktuella användaridentiteten som Aspose.Words FOSS för .NET rapporterar via användarrelaterade dokumentfält.

UserInformation representerar den identitet Aspose.Words FOSS för .NET använder när man utvärderar fält som rapporterar “den aktuella användaren” — Name, Initials och Address. Den är knuten till ett dokuments fältutvärderingsinställningar via FieldOptions.CurrentUser, och en processomfattande reserv finns tillgänglig via UserInformation.DefaultUser.

Ställa in den aktuella användaren

Document.FieldOptions (en FieldOptions instans) exponerar CurrentUser, ett UserInformation objekt. Ställ in dess Name, Initials och Address egenskaper innan du uppdaterar användarinformationsfält så att de värden de rapporterar matchar den identitet som din applikation vill lagras. UserInformation.DefaultUser tillhandahåller en statisk, processomfattande UserInformation instans att falla tillbaka på när ett dokuments FieldOptions.CurrentUser inte har satts explicit.

Användarinformationsfält

Tre Field underklasser läser den aktuella användarens identitet in i dokumentkroppen: FieldUserName (fältet USERNAME, med en UserName egenskap), FieldUserAddress (fältet USERADDRESS, med en UserAddress egenskap), och FieldUserInitials (fältet USERINITIALS, med en UserInitials egenskap). Precis som andra fält delar de bas Field livscykel — GetFieldCode(), Result, Update(), Unlink(), Remove() — och kan infogas med DocumentBuilder.InsertField(fieldCode) eller InsertField(fieldType, updateField) med hjälp av FieldType.FieldUserName, FieldType.FieldUserAddress eller FieldType.FieldUserInitials.

Tips och bästa praxis

• Ställ in FieldOptions.CurrentUser innan du anropar Update() på ett FieldUserName, FieldUserAddress eller FieldUserInitials fält, eller innan Document.UpdateFields() — annars kommer fälten att lösas mot vad UserInformation för närvarande är i kraft.
• UserInformation.DefaultUser är ett bekvämt delat standardvärde när samma identitet gäller för varje dokument som din applikation bearbetar; ställ in FieldOptions.CurrentUser per dokument när olika dokument behöver olika författare.
• Fyll i alla tre Name, Initials och Address tillsammans om dina mallar använder mer än en av FieldUserName, FieldUserAddress och FieldUserInitials — att lämna en tom ger ett tomt fältresultat snarare än ett fel.

Vanliga problem

FAQ

Vad är skillnaden mellan FieldOptions.CurrentUser och UserInformation.DefaultUser?

FieldOptions.CurrentUser är per dokument — ställ in det på en specifik Documents FieldOptions för att kontrollera det dokumentets användarinformationsfält. UserInformation.DefaultUser är en statisk, processomfattande reserv.

Vilka fält påverkar UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) och FieldUserInitials (USERINITIALS) — läser var och en den motsvarande Name, Address eller Initials egenskapen från den aktiva UserInformation.

Behöver jag anropa Update() efter att ha ändrat UserInformation?

Ja — att ändra Name, Initials eller Address uppdaterar inte retroaktivt de fält som redan har utvärderats i dokumentet; anropa Update() på det specifika fältet eller Document.UpdateFields().

API Reference Sammanfattning

Se även

• Aspose.Words for .NET — Enterprise Documentation