Informace o uživateli

Informace o uživateli

Tento průvodce ukazuje, jak nastavit identitu aktuálního uživatele, kterou Aspose.Words FOSS pro .NET hlásí prostřednictvím polí dokumentu souvisejících s uživatelem.

UserInformation představuje identitu, kterou Aspose.Words FOSS pro .NET používá při vyhodnocování polí, jež hlásí „aktuálního uživatele“ — Name, Initials a Address. Je připojena k nastavením vyhodnocování polí dokumentu prostřednictvím FieldOptions.CurrentUser a procesně široký náhradní mechanismus je k dispozici přes UserInformation.DefaultUser.

Nastavení aktuálního uživatele

Document.FieldOptions (instance FieldOptions) vystavuje CurrentUser, objekt UserInformation. Nastavte jeho vlastnosti Name, Initials a Address před aktualizací polí s informacemi o uživateli, aby hodnoty, které hlásí, odpovídaly identitě, kterou vaše aplikace chce zaznamenat. UserInformation.DefaultUser poskytuje statickou, procesně širokou instanci UserInformation, na kterou se lze spolehnout, když FieldOptions.CurrentUser dokumentu nebylo nastaveno explicitně.

Pole s informacemi o uživateli

Tři podtřídy Field načítají identitu aktuálního uživatele do těla dokumentu: FieldUserName (pole USERNAME s vlastností UserName), FieldUserAddress (pole USERADDRESS s vlastností UserAddress) a FieldUserInitials (pole USERINITIALS s vlastností UserInitials). Stejně jako ostatní pole sdílejí základní životní cyklus Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — a mohou být vloženy pomocí DocumentBuilder.InsertField(fieldCode) nebo InsertField(fieldType, updateField) za použití FieldType.FieldUserName, FieldType.FieldUserAddress nebo FieldType.FieldUserInitials.

Tipy a osvědčené postupy

• Nastavte FieldOptions.CurrentUser před voláním Update() na poli FieldUserName, FieldUserAddress nebo FieldUserInitials, nebo před Document.UpdateFields() — jinak se pole vyhodnotí vůči tomu, co je momentálně v platnosti UserInformation.
• UserInformation.DefaultUser je pohodlné sdílené výchozí nastavení, když se stejná identita vztahuje na každý dokument, který vaše aplikace zpracovává; nastavte FieldOptions.CurrentUser pro každý dokument, pokud různé dokumenty potřebují různé autory.
• Vyplňte všechny tři položky Name, Initials a Address společně, pokud vaše šablony používají více než jeden z FieldUserName, FieldUserAddress a FieldUserInitials — ponechání jedné prázdné způsobí výsledek s prázdným polem místo chyby.

Časté problémy

FAQ

Jaký je rozdíl mezi FieldOptions.CurrentUser a UserInformation.DefaultUser?

FieldOptions.CurrentUser je na úrovni dokumentu — nastavte jej na konkrétním Document’s FieldOptions, aby jste řídili uživatelské informační pole tohoto dokumentu. UserInformation.DefaultUser je statický, procesně široký náhradní mechanismus.

Která pole ovlivňuje UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) a FieldUserInitials (USERINITIALS) — každé načítá odpovídající vlastnost Name, Address nebo Initials z aktivního UserInformation.

Musím volat Update() po změně UserInformation?

Ano — změna Name, Initials nebo Address neaktualizuje zpětně pole, která byla v dokumentu již vyhodnocena; zavolejte Update() na konkrétní pole nebo Document.UpdateFields().

API Reference Shrnutí

Viz také:

• Aspose.Words for .NET — Enterprise Documentation