Informasi Pengguna

Informasi Pengguna

Panduan ini menunjukkan cara mengatur identitas pengguna saat ini yang Aspose.Words FOSS untuk .NET laporkan melalui bidang dokumen terkait pengguna.

UserInformation mewakili identitas Aspose.Words FOSS yang digunakan .NET saat mengevaluasi bidang yang melaporkan “pengguna saat ini” — Name, Initials, dan Address. Identitas ini dilampirkan ke pengaturan evaluasi bidang dokumen melalui FieldOptions.CurrentUser, dan fallback berskala proses tersedia melalui UserInformation.DefaultUser.

Mengatur Pengguna Saat Ini

Document.FieldOptions (sebuah instance FieldOptions) mengekspos CurrentUser, sebuah objek UserInformation. Atur properti Name, Initials, dan Addressnya sebelum memperbarui bidang informasi pengguna sehingga nilai yang mereka laporkan sesuai dengan identitas yang ingin dicatat oleh aplikasi Anda. UserInformation.DefaultUser menyediakan sebuah instance UserInformation statis berskala proses untuk dijadikan fallback ketika FieldOptions.CurrentUser pada dokumen belum diatur secara eksplisit.

Bidang Informasi Pengguna

Tiga subclass Field membaca identitas pengguna saat ini ke dalam isi dokumen: FieldUserName (bidang USERNAME, dengan properti UserName), FieldUserAddress (bidang USERADDRESS, dengan properti UserAddress), dan FieldUserInitials (bidang USERINITIALS, dengan properti UserInitials). Seperti bidang lainnya, mereka berbagi siklus hidup dasar Field — GetFieldCode(), Result, Update(), Unlink(), Remove() — dan dapat disisipkan dengan DocumentBuilder.InsertField(fieldCode) atau InsertField(fieldType, updateField) menggunakan FieldType.FieldUserName, FieldType.FieldUserAddress, atau FieldType.FieldUserInitials.

Tips dan Praktik Terbaik

• Atur FieldOptions.CurrentUser sebelum memanggil Update() pada bidang FieldUserName, FieldUserAddress, atau FieldUserInitials, atau sebelum Document.UpdateFields() — jika tidak, bidang akan diresolusikan terhadap apa pun UserInformation yang saat ini berlaku.
• UserInformation.DefaultUser adalah default bersama yang nyaman ketika identitas yang sama berlaku untuk setiap dokumen yang diproses aplikasi Anda; atur FieldOptions.CurrentUser per-dokumen ketika dokumen yang berbeda memerlukan penulis yang berbeda.
• Isi ketiga Name, Initials, dan Address secara bersamaan jika templat Anda menggunakan lebih dari satu FieldUserName, FieldUserAddress, dan FieldUserInitials — meninggalkan satu kosong menghasilkan hasil bidang kosong alih-alih error.

Masalah Umum

FAQ

Apa perbedaan antara FieldOptions.CurrentUser dan UserInformation.DefaultUser?

FieldOptions.CurrentUser bersifat per-dokumen — atur pada FieldOptions milik Document tertentu untuk mengendalikan bidang informasi pengguna dokumen tersebut. UserInformation.DefaultUser adalah fallback statis yang berlaku untuk seluruh proses.

Bidang apa yang dipengaruhi oleh UserInformation?

FieldUserName (USERNAME), FieldUserAddress (USERADDRESS), dan FieldUserInitials (USERINITIALS) — masing-masing membaca properti Name, Address, atau Initials yang sesuai dari UserInformation yang aktif.

Apakah saya perlu memanggil Update() setelah mengubah UserInformation?

Ya — mengubah Name, Initials, atau Address tidak secara retroaktif memperbarui bidang yang sudah dievaluasi dalam dokumen; panggil Update() pada bidang tertentu atau Document.UpdateFields().

API Reference Ringkasan

Lihat Juga

• Aspose.Words for .NET — Enterprise Documentation