Felhasználói információk

Felhasználói információk

Ez az útmutató bemutatja, hogyan állítható be a jelenlegi felhasználó azonosító, amely Aspose.Words FOSS a .NET jelentésekhez a felhasználóval kapcsolatos dokumentummezőkön keresztül.

UserInformation jelenti azt az azonosítót, amelyet a Aspose.Words FOSS a .NET használ a “jelenlegi felhasználó” jelentő mezők kiértékelésekor — Name, Initials és Address. Ez a dokumentum mezőértékelési beállításaihoz van csatolva a FieldOptions.CurrentUser segítségével, és egy folyamat-szintű tartalék elérhető a UserInformation.DefaultUser által.

A jelenlegi felhasználó beállítása

Document.FieldOptions (egy FieldOptions példány) elérhetővé teszi a CurrentUser objektumot, egy UserInformation objektumot. Állítsa be a Name, Initials és Address tulajdonságait, mielőtt frissítené a felhasználói információs mezőket, hogy a jelentett értékek megegyezzenek az alkalmazás által rögzítendő azonosítóval. UserInformation.DefaultUser egy statikus, folyamat-szintű UserInformation példányt biztosít, amelyre vissza lehet támaszkodni, ha egy dokumentum FieldOptions.CurrentUser értéke nincs kifejezetten beállítva.

Felhasználói információs mezők

Három Field alosztály olvassa be a jelenlegi felhasználó azonosítóját a dokumentum törzsébe: FieldUserName (a USERNAME mező, UserName tulajdonsággal), FieldUserAddress (a USERADDRESS mező, UserAddress tulajdonsággal), és FieldUserInitials (a USERINITIALS mező, UserInitials tulajdonsággal). Más mezőkhez hasonlóan a Field alap életciklust osztják meg — GetFieldCode(), Result, Update(), Unlink(), Remove() — és beilleszthetők DocumentBuilder.InsertField(fieldCode) vagy InsertField(fieldType, updateField) használatával, a FieldType.FieldUserName, FieldType.FieldUserAddress vagy FieldType.FieldUserInitials segítségével.

Tippek és legjobb gyakorlatok

• Állítsa be a FieldOptions.CurrentUser értéket, mielőtt meghívná a Update() egy FieldUserName, FieldUserAddress vagy FieldUserInitials mezőn, vagy mielőtt Document.UpdateFields() — ellenkező esetben a mezők a jelenleg érvényben lévő UserInformation alapján kerülnek feloldásra.
• UserInformation.DefaultUser egy kényelmes közös alapértelmezés, amikor ugyanaz az azonosító minden, az alkalmazása által feldolgozott dokumentumra érvényes; állítsa be a FieldOptions.CurrentUser értéket dokumentumonként, ha különböző dokumentumokhoz külön szerzők szükségesek.
• Töltse ki egyszerre a Name, Initials és Address értékeket, ha sablonjai több mint egyet használnak a FieldUserName, FieldUserAddress és FieldUserInitials közül — egy üresen hagyott mező üres mezőeredményt ad, nem hibát.

Gyakori problémák

FAQ

Mi a különbség a FieldOptions.CurrentUser és a UserInformation.DefaultUser között?

FieldOptions.CurrentUser dokumentumonkénti — állítsa be egy adott Document FieldOptions mezőjében, hogy az adott dokumentum felhasználói információs mezőit szabályozza. UserInformation.DefaultUser egy statikus, folyamat-szintű tartalék.

Mely mezőket érint a(z) UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS) és FieldUserInitials (USERINITIALS) — mindegyik a megfelelő Name, Address vagy Initials tulajdonságot olvassa az aktív UserInformationból.

Szükséges meghívni a(z) Update()t a(z) UserInformation módosítása után?

Igen — a(z) Name, Initials vagy Address módosítása nem frissíti visszamenőleg a dokumentumban már kiértékelt mezőket; hívja meg a(z) Update()t a konkrét mezőn, vagy a(z) Document.UpdateFields()t.

API Reference Összefoglaló

Lásd még:

• Aspose.Words for .NET — Enterprise Documentation