Información del usuario

Información del usuario

Esta guía muestra cómo establecer la identidad del usuario actual que Aspose.Words FOSS para .NET informa a través de campos de documento relacionados con el usuario.

UserInformation representa la identidad Aspose.Words FOSS que .NET utiliza al evaluar campos que informan “el usuario actual” — Name, Initials y Address. Se adjunta a la configuración de evaluación de campos de un documento mediante FieldOptions.CurrentUser, y existe una alternativa a nivel de proceso mediante UserInformation.DefaultUser.

Estableciendo el usuario actual

Document.FieldOptions (una instancia de FieldOptions) expone CurrentUser, un objeto UserInformation. Establezca sus propiedades Name, Initials y Address antes de actualizar los campos de información del usuario para que los valores que informan coincidan con la identidad que su aplicación desea registrar. UserInformation.DefaultUser proporciona una instancia estática y a nivel de proceso de UserInformation para usar como respaldo cuando el FieldOptions.CurrentUser de un documento no se ha establecido explícitamente.

Campos de información del usuario

Tres subclases de Field leen la identidad del usuario actual en el cuerpo del documento: FieldUserName (el campo USERNAME, con una propiedad UserName), FieldUserAddress (el campo USERADDRESS, con una propiedad UserAddress), y FieldUserInitials (el campo USERINITIALS, con una propiedad UserInitials). Al igual que otros campos, comparten el ciclo de vida base de Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — y pueden insertarse con DocumentBuilder.InsertField(fieldCode) o InsertField(fieldType, updateField) usando FieldType.FieldUserName, FieldType.FieldUserAddress o FieldType.FieldUserInitials.

Consejos y Mejores Prácticas

• Establezca FieldOptions.CurrentUser antes de llamar a Update() en un campo FieldUserName, FieldUserAddress o FieldUserInitials, o antes de Document.UpdateFields() — de lo contrario los campos se resuelven contra lo que UserInformation esté actualmente en vigor.
• UserInformation.DefaultUser es un valor predeterminado compartido y conveniente cuando la misma identidad se aplica a todos los documentos que procesa su aplicación; establezca FieldOptions.CurrentUser por documento cuando diferentes documentos necesiten diferentes autores.
• Complete los tres Name, Initials y Address juntos si sus plantillas usan más de uno de FieldUserName, FieldUserAddress y FieldUserInitials — dejar uno en blanco produce un resultado de campo vacío en lugar de un error.

Problemas Comunes

FAQ

¿Cuál es la diferencia entre FieldOptions.CurrentUser y UserInformation.DefaultUser?

FieldOptions.CurrentUser es por documento — establézcalo en el FieldOptions de un Document específico para controlar los campos de información del usuario de ese documento. UserInformation.DefaultUser es una alternativa estática a nivel de proceso.

¿Qué campos afecta UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) y FieldUserInitials (USERINITIALS) — cada uno lee la propiedad correspondiente Name, Address o Initials del UserInformation activo.

¿Necesito llamar a Update() después de cambiar UserInformation?

Sí — cambiar Name, Initials o Address no actualiza retroactivamente los campos ya evaluados en el documento; llama a Update() en el campo específico o a Document.UpdateFields().

Resumen de API Reference

Ver también

• Aspose.Words for .NET — Enterprise Documentation