Информация о пользователе

Информация о пользователе

Это руководство показывает, как установить идентичность текущего пользователя, которую Aspose.Words FOSS для .NET сообщает через связанные с пользователем поля документа.

UserInformation представляет собой идентичность, которую Aspose.Words FOSS для .NET использует при оценке полей, сообщающих «текущий пользователь» — Name, Initials и Address. Она привязывается к настройкам оценки полей документа через FieldOptions.CurrentUser, а резервный вариант на уровне процесса доступен через UserInformation.DefaultUser.

Установка текущего пользователя

Document.FieldOptions (экземпляр FieldOptions) раскрывает CurrentUser, объект UserInformation. Установите его свойства Name, Initials и Address перед обновлением полей пользовательской информации, чтобы значения, которые они сообщают, соответствовали идентичности, которую ваше приложение хочет записать. UserInformation.DefaultUser предоставляет статический, процессный UserInformation экземпляр, который можно использовать в качестве резервного, когда FieldOptions.CurrentUser документа не был установлен явно.

Поля пользовательской информации

Три подкласса Field читают идентичность текущего пользователя в тело документа: FieldUserName (поле USERNAME с свойством UserName), FieldUserAddress (поле USERADDRESS с свойством UserAddress) и FieldUserInitials (поле USERINITIALS с свойством UserInitials). Как и другие поля, они используют базовый жизненный цикл Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — и могут быть вставлены с помощью DocumentBuilder.InsertField(fieldCode) или InsertField(fieldType, updateField), используя FieldType.FieldUserName, FieldType.FieldUserAddress или FieldType.FieldUserInitials.

Советы и лучшие практики

• Установите FieldOptions.CurrentUser перед вызовом Update() на поле FieldUserName, FieldUserAddress или FieldUserInitials, или перед Document.UpdateFields() — иначе поля будут разрешаться относительно текущего UserInformation.
• UserInformation.DefaultUser — удобный общий параметр по умолчанию, когда одна и та же идентичность применяется ко всем документам, обрабатываемым вашим приложением; устанавливайте FieldOptions.CurrentUser для каждого документа, когда разные документы требуют разных авторов.
• Заполняйте одновременно все три значения Name, Initials и Address, если ваши шаблоны используют более одного из FieldUserName, FieldUserAddress и FieldUserInitials — оставление одного пустым приводит к пустому результату поля, а не к ошибке.

Распространённые проблемы

FAQ

В чём разница между FieldOptions.CurrentUser и UserInformation.DefaultUser?

FieldOptions.CurrentUser — это параметр для каждого документа; установите его в конкретном Document’s FieldOptions, чтобы управлять полями пользовательской информации этого документа. UserInformation.DefaultUser — статический, глобальный для процесса запасной вариант.

Какие поля затрагивает UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) и FieldUserInitials (USERINITIALS) — каждый читает соответствующее свойство Name, Address или Initials из активного UserInformation.

Нужно ли вызывать Update() после изменения UserInformation?

Да — изменение Name, Initials или Address не обновляет ретроспективно поля, уже вычисленные в документе; вызовите Update() для конкретного поля или Document.UpdateFields().

API Reference Сводка

См. также:

• Aspose.Words for .NET — Enterprise Documentation