사용자 정보
사용자 정보
이 가이드는 Aspose.Words FOSS for .NET가 사용자 관련 문서 필드를 통해 보고하는 현재 사용자 신원을 설정하는 방법을 보여줍니다.
UserInformation은(는) Aspose.Words FOSS for .NET가 “현재 사용자"를 보고하는 필드—Name, Initials, Address—를 평가할 때 사용하는 신원을 나타냅니다. 이는 FieldOptions.CurrentUser를 통해 문서의 필드 평가 설정에 연결되며, 프로세스 전체에 대한 대체 옵션은 UserInformation.DefaultUser를 통해 제공됩니다.
현재 사용자 설정
Document.FieldOptions(은/는) FieldOptions 인스턴스로서 CurrentUser를 노출합니다, 이는 UserInformation 객체입니다. 사용자 정보 필드를 업데이트하기 전에 해당 Name, Initials, Address 속성을 설정하여 보고되는 값이 애플리케이션이 기록하려는 신원과 일치하도록 합니다. UserInformation.DefaultUser은 문서의 FieldOptions.CurrentUser가 명시적으로 설정되지 않았을 때 사용할 수 있는 정적이며 프로세스 전체에 적용되는 UserInformation 인스턴스를 제공합니다.
사용자 정보 필드
세 개의 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는 애플리케이션이 처리하는 모든 문서에 동일한 ID가 적용될 때 편리한 공유 기본값입니다; 서로 다른 문서에 서로 다른 작성자가 필요할 경우 문서별로FieldOptions.CurrentUser을 설정하십시오.- 템플릿이
FieldUserName,FieldUserAddress,FieldUserInitials중 두 개 이상을 사용할 경우Name,Initials,Address세 가지를 모두 함께 채우십시오 — 하나만 비워두면 오류가 아니라 빈 필드 결과가 생성됩니다.
일반적인 문제
| 문제 | 원인 | 수정 |
|---|---|---|
FieldUserName 결과가 Update() 후에 비어 있습니다 | UserInformation.Name가 활성 UserInformation에 설정되지 않았습니다 | 필드를 업데이트하기 전에 FieldOptions.CurrentUser.Name(또는 UserInformation.DefaultUser.Name)를 설정하십시오 |
| 사용자 정보 필드가 문서 전체에서 잘못된 작성자를 표시합니다 | UserInformation.DefaultUser는 프로세스 전체에 공유됩니다 | 기본값에 의존하는 대신 문서당 Document.FieldOptions.CurrentUser을 설정합니다 |
FAQ
FieldOptions.CurrentUser와 UserInformation.DefaultUser의 차이점은 무엇입니까?
FieldOptions.CurrentUser는 문서별입니다 — 특정 Document의 FieldOptions에 설정하여 해당 문서의 사용자 정보 필드를 제어하십시오. UserInformation.DefaultUser는 정적이며 프로세스 전체에 적용되는 대체값입니다.
UserInformation은(는) 어떤 필드에 영향을 줍니까?
FieldUserName (USERNAME), FieldUserAddress (USERADDRESS), 및 FieldUserInitials (USERINITIALS) — 각각 활성 UserInformation에서 해당 Name, Address, 또는 Initials 속성을 읽습니다.
UserInformation을(를) 변경한 후 Update()을(를) 호출해야 합니까?
예 — Name, Initials, 또는 Address를 변경해도 문서에서 이미 평가된 필드가 소급적으로 업데이트되지 않습니다; 특정 필드에 대해 Update()을(를) 호출하거나 Document.UpdateFields()을(를) 호출하십시오.
API Reference 요약
| 클래스 / 속성 | 설명 |
|---|---|
UserInformation | Name, Initials, Address; DefaultUser 정적 폴백 인스턴스 |
FieldOptions.CurrentUser | 사용자 정보 필드를 평가할 때 사용되는 문서별 UserInformation |
FieldUserName / FieldUserAddress / FieldUserInitials | USERNAME, USERADDRESS, USERINITIALS 필드 |