Informacje o użytkowniku

Informacje o użytkowniku

Ten przewodnik pokazuje, jak ustawić tożsamość bieżącego użytkownika, którą Aspose.Words FOSS dla .NET raportuje poprzez pola dokumentu związane z użytkownikiem.

UserInformation reprezentuje tożsamość Aspose.Words FOSS, której .NET używa przy ocenie pól raportujących „bieżącego użytkownika” — Name, Initials i Address. Jest ona dołączana do ustawień oceny pól dokumentu poprzez FieldOptions.CurrentUser, a ogólnoprozcesowy mechanizm awaryjny jest dostępny poprzez UserInformation.DefaultUser.

Ustawianie bieżącego użytkownika

Document.FieldOptions (instancja FieldOptions) udostępnia CurrentUser, obiekt UserInformation. Ustaw jego właściwości Name, Initials i Address przed aktualizacją pól informacji o użytkowniku, aby wartości, które raportują, odpowiadały tożsamości, którą Twoja aplikacja chce zapisać. UserInformation.DefaultUser zapewnia statyczną, ogólnoprozcesową instancję UserInformation, do której można się odwołać, gdy FieldOptions.CurrentUser dokumentu nie zostało ustawione wyraźnie.

Pola informacji o użytkowniku

Trzy podklasy Field odczytują tożsamość bieżącego użytkownika do treści dokumentu: FieldUserName (pole USERNAME z właściwością UserName), FieldUserAddress (pole USERADDRESS z właściwością UserAddress) oraz FieldUserInitials (pole USERINITIALS z właściwością UserInitials). Podobnie jak inne pola, dzielą bazowy cykl życia Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — i mogą być wstawiane przy użyciu DocumentBuilder.InsertField(fieldCode) lub InsertField(fieldType, updateField) za pomocą FieldType.FieldUserName, FieldType.FieldUserAddress lub FieldType.FieldUserInitials.

Wskazówki i najlepsze praktyki

• Ustaw FieldOptions.CurrentUser przed wywołaniem Update() na polu FieldUserName, FieldUserAddress lub FieldUserInitials, lub przed Document.UpdateFields() — w przeciwnym razie pola będą rozwiązywane względem tego, co UserInformation jest aktualnie w efekcie.
• UserInformation.DefaultUser jest wygodnym współdzielonym domyślnym, gdy ta sama tożsamość obowiązuje we wszystkich dokumentach przetwarzanych przez twoją aplikację; ustaw FieldOptions.CurrentUser na poziomie dokumentu, gdy różne dokumenty wymagają różnych autorów.
• Wypełnij jednocześnie wszystkie trzy pola Name, Initials i Address, jeśli twoje szablony używają więcej niż jednego z FieldUserName, FieldUserAddress i FieldUserInitials — pozostawienie jednego pustego powoduje wynik pustego pola zamiast błędu.

Typowe problemy

FAQ

Jaka jest różnica między FieldOptions.CurrentUser a UserInformation.DefaultUser?

FieldOptions.CurrentUser jest per-document — ustaw je w konkretnym Document’s FieldOptions, aby kontrolować pola informacji o użytkowniku tego dokumentu. UserInformation.DefaultUser jest statycznym, ogólnoprocesowym rozwiązaniem awaryjnym.

Na które pola wpływa UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) i FieldUserInitials (USERINITIALS) — każdy odczytuje odpowiednie właściwości Name, Address lub Initials z aktywnego UserInformation.

Czy muszę wywołać Update() po zmianie UserInformation?

Tak — zmiana Name, Initials lub Address nie aktualizuje retrospektywnie pól już ocenionych w dokumencie; wywołaj Update() na konkretnym polu lub Document.UpdateFields().

API Reference Podsumowanie

Zobacz także

• Aspose.Words for .NET — Enterprise Documentation