Informații utilizator

Informații utilizator

Acest ghid arată cum să setați identitatea utilizatorului curent pe care Aspose.Words FOSS pentru .NET o raportează prin câmpurile de document legate de utilizator.

UserInformation reprezintă identitatea Aspose.Words FOSS pe care .NET o folosește când evaluează câmpurile care raportează „utilizatorul curent” — Name, Initials și Address. Este atașată la setările de evaluare a câmpurilor unui document prin FieldOptions.CurrentUser, iar un fallback la nivel de proces este disponibil prin UserInformation.DefaultUser.

Setarea utilizatorului curent

Document.FieldOptions (o instanță FieldOptions) expune CurrentUser, un obiect UserInformation. Setați proprietățile Name, Initials și Address ale acestuia înainte de a actualiza câmpurile de informații despre utilizator, astfel încât valorile pe care le raportează să corespundă identității pe care aplicația dumneavoastră dorește să o înregistreze. UserInformation.DefaultUser furnizează o instanță UserInformation statică, la nivel de proces, pentru a fi folosită ca fallback atunci când FieldOptions.CurrentUser unui document nu a fost setat explicit.

Câmpuri de informații despre utilizator

Trei subclase Field citesc identitatea utilizatorului curent în corpul documentului: FieldUserName (câmpul USERNAME, cu o proprietate UserName), FieldUserAddress (câmpul USERADDRESS, cu o proprietate UserAddress) și FieldUserInitials (câmpul USERINITIALS, cu o proprietate UserInitials). Ca și celelalte câmpuri, ele împărtășesc ciclul de viață de bază Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — și pot fi inserate cu DocumentBuilder.InsertField(fieldCode) sau InsertField(fieldType, updateField) utilizând FieldType.FieldUserName, FieldType.FieldUserAddress sau FieldType.FieldUserInitials.

Sfaturi și cele mai bune practici

• Setați FieldOptions.CurrentUser înainte de a apela Update() pe un câmp FieldUserName, FieldUserAddress sau FieldUserInitials, sau înainte de Document.UpdateFields() — altfel câmpurile se rezolvă în funcție de ceea ce UserInformation este în prezent în vigoare.
• UserInformation.DefaultUser este un implicit partajat convenabil când aceeași identitate se aplică la fiecare document pe care aplicația dvs. îl procesează; setați FieldOptions.CurrentUser pe document în parte când diferite documente necesită autori diferiți.
• Completați toate cele trei Name, Initials și Address împreună dacă șabloanele dvs. folosesc mai mult de unul dintre FieldUserName, FieldUserAddress și FieldUserInitials — lăsarea unuia necompletat produce un rezultat de câmp gol în loc de o eroare.

Probleme comune

FAQ

Care este diferența dintre FieldOptions.CurrentUser și UserInformation.DefaultUser?

FieldOptions.CurrentUser este pe document — setați-l pe FieldOptions unui Document specific pentru a controla câmpurile de informații ale utilizatorului ale acelui document. UserInformation.DefaultUser este un fallback static, valabil pentru întregul proces.

Ce câmpuri afectează UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) și FieldUserInitials (USERINITIALS) — fiecare citește proprietatea Name, Address sau Initials corespunzătoare din UserInformation activ.

Trebuie să apelez Update() după ce am modificat UserInformation?

Da — modificarea Name, Initials sau Address nu actualizează retroactiv câmpurile deja evaluate în document; apelează Update() pe câmpul specific sau Document.UpdateFields().

API Reference Rezumat

Vezi și:

• Aspose.Words for .NET — Enterprise Documentation