Benutzerinformationen

Benutzerinformationen

Dieser Leitfaden zeigt, wie die aktuelle Benutzeridentität festgelegt wird, die Aspose.Words FOSS für .NET über benutzerbezogene Dokumentfelder meldet.

UserInformation stellt die Identität dar, die Aspose.Words FOSS für .NET verwendet, wenn Felder ausgewertet werden, die „der aktuelle Benutzer“ melden — Name, Initials und Address. Sie ist über FieldOptions.CurrentUser an den Feldauswertungseinstellungen eines Dokuments angebunden, und ein prozessweiter Rückfallback ist über UserInformation.DefaultUser verfügbar.

Festlegen des aktuellen Benutzers

Document.FieldOptions (eine FieldOptions-Instanz) stellt CurrentUser bereit, ein UserInformation-Objekt. Setzen Sie dessen Name, Initials und Address-Eigenschaften, bevor Sie benutzerbezogene Informationsfelder aktualisieren, damit die von ihnen gemeldeten Werte mit der Identität übereinstimmen, die Ihre Anwendung speichern möchte. UserInformation.DefaultUser bietet eine statische, prozessweite UserInformation-Instanz als Rückfallback, wenn die FieldOptions.CurrentUser eines Dokuments nicht explizit gesetzt wurde.

Benutzer-Informationsfelder

Drei Field-Unterklassen lesen die Identität des aktuellen Benutzers in den Dokumentinhalt ein: FieldUserName (das USERNAME-Feld mit einer UserName-Eigenschaft), FieldUserAddress (das USERADDRESS-Feld mit einer UserAddress-Eigenschaft) und FieldUserInitials (das USERINITIALS-Feld mit einer UserInitials-Eigenschaft). Wie andere Felder teilen sie den Basis-Field-Lebenszyklus — GetFieldCode(), Result, Update(), Unlink(), Remove() — und können mit DocumentBuilder.InsertField(fieldCode) oder InsertField(fieldType, updateField) unter Verwendung von FieldType.FieldUserName, FieldType.FieldUserAddress oder FieldType.FieldUserInitials eingefügt werden.

Tipps und bewährte Verfahren

• Setze FieldOptions.CurrentUser bevor du Update() auf einem FieldUserName, FieldUserAddress oder FieldUserInitials Feld aufrufst, oder bevor Document.UpdateFields() — andernfalls lösen die Felder gegen das, was UserInformation gerade gilt, auf.
• UserInformation.DefaultUser ist ein praktischer gemeinsamer Standard, wenn dieselbe Identität für jedes Dokument gilt, das Ihre Anwendung verarbeitet; setzen Sie FieldOptions.CurrentUser pro Dokument, wenn verschiedene Dokumente unterschiedliche Autoren benötigen.
• Füllen Sie alle drei Name, Initials und Address zusammen aus, wenn Ihre Vorlagen mehr als eines der FieldUserName, FieldUserAddress und FieldUserInitials verwenden — lässt man eines leer, ergibt das ein leeres Feld anstelle eines Fehlers.

Häufige Probleme

FAQ

Was ist der Unterschied zwischen FieldOptions.CurrentUser und UserInformation.DefaultUser?

FieldOptions.CurrentUser ist pro Dokument — setzen Sie es in einem spezifischen Documents FieldOptions, um die benutzerbezogenen Informationsfelder dieses Dokuments zu steuern. UserInformation.DefaultUser ist ein statischer, prozessweiter Rückfall.

Welche Felder beeinflusst UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) und FieldUserInitials (USERINITIALS) — liest jeweils die entsprechende Name, Address oder Initials Eigenschaft des aktiven UserInformation.

Muss ich Update() aufrufen, nachdem ich UserInformation geändert habe?

Ja — das Ändern von Name, Initials oder Address aktualisiert Felder, die bereits im Dokument ausgewertet wurden, nicht rückwirkend; rufen Sie Update() für das spezifische Feld oder Document.UpdateFields() auf.

API Reference Zusammenfassung

Siehe auch

• Aspose.Words for .NET — Enterprise Documentation