Informazioni utente

Informazioni utente

Questa guida mostra come impostare l’identità dell’utente corrente che Aspose.Words FOSS per .NET segnala tramite i campi del documento relativi all’utente.

UserInformation rappresenta l’identità Aspose.Words FOSS che .NET utilizza durante la valutazione dei campi che segnalano “l’utente corrente” — Name, Initials e Address. È collegata alle impostazioni di valutazione dei campi di un documento tramite FieldOptions.CurrentUser, e un fallback a livello di processo è disponibile tramite UserInformation.DefaultUser.

Impostazione dell’utente corrente

Document.FieldOptions (un’istanza FieldOptions) espone CurrentUser, un oggetto UserInformation. Imposta le sue proprietà Name, Initials e Address prima di aggiornare i campi di informazioni sull’utente affinché i valori che segnalano corrispondano all’identità che la tua applicazione desidera registrare. UserInformation.DefaultUser fornisce un’istanza UserInformation statica, a livello di processo, da utilizzare come fallback quando il FieldOptions.CurrentUser di un documento non è stato impostato esplicitamente.

Campi di informazioni sull’utente

Tre sottoclassi Field leggono l’identità dell’utente corrente nel corpo del documento: FieldUserName (il campo USERNAME, con una proprietà UserName), FieldUserAddress (il campo USERADDRESS, con una proprietà UserAddress), e FieldUserInitials (il campo USERINITIALS, con una proprietà UserInitials). Come gli altri campi, condividono il ciclo di vita base Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — e possono essere inseriti con DocumentBuilder.InsertField(fieldCode) o InsertField(fieldType, updateField) usando FieldType.FieldUserName, FieldType.FieldUserAddress o FieldType.FieldUserInitials.

Suggerimenti e buone pratiche

• Imposta FieldOptions.CurrentUser prima di chiamare Update() su un campo FieldUserName, FieldUserAddress o FieldUserInitials, o prima di Document.UpdateFields() — altrimenti i campi si risolvono rispetto a qualunque UserInformation sia attualmente in vigore.
• UserInformation.DefaultUser è un comodo valore predefinito condiviso quando la stessa identità si applica a tutti i documenti elaborati dalla tua applicazione; imposta FieldOptions.CurrentUser per documento quando documenti diversi richiedono autori diversi.
• Compila tutti e tre Name, Initials e Address insieme se i tuoi modelli utilizzano più di uno tra FieldUserName, FieldUserAddress e FieldUserInitials — lasciare uno vuoto produce un risultato di campo vuoto anziché un errore.

Problemi comuni

FAQ

Qual è la differenza tra FieldOptions.CurrentUser e UserInformation.DefaultUser?

FieldOptions.CurrentUser è per documento — impostalo su un FieldOptions specifico di Document per controllare i campi di informazioni utente di quel documento. UserInformation.DefaultUser è un fallback statico a livello di processo.

Quali campi influenza UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) e FieldUserInitials (USERINITIALS) — ciascuno legge la proprietà Name, Address o Initials corrispondente dall’UserInformation attivo.

Devo chiamare Update() dopo aver modificato UserInformation?

Sì — modificare Name, Initials o Address non aggiorna retroattivamente i campi già valutati nel documento; chiama Update() sul campo specifico o Document.UpdateFields().

API Reference Riepilogo

Vedi anche

• Aspose.Words for .NET — Enterprise Documentation