필드 결과 형식 지정

필드 결과 서식

이 가이드는 Aspose.Words FOSS for .NET에서 필드의 계산된 결과에 적용되는 숫자, 날짜/시간 및 일반 서식을 FieldFormat 클래스, GeneralFormat 열거형, 그리고 GeneralFormatCollection를 사용하여 제어하는 방법을 보여줍니다. 모든 Field 인스턴스는 해당 Format 속성을 통해 이러한 서식 스위치를 노출합니다; 이 페이지는 해당 속성이 제공하는 내용을 자세히 살펴봅니다.

필드 서식에 접근하기

모든 Field — 그리고 FieldDate, FieldCreateDate, FieldSymbol와 같은 타입화된 하위 클래스 — 는 FieldFormat 타입의 Format 속성을 노출하며, 이는 필드의 숫자, 날짜 및 시간, 일반 서식에 타입화된 접근을 위해 사용됩니다. Field.Format을 읽어 필드 코드에 연결된 스위치를 원시 필드 코드 텍스트를 직접 편집하지 않고 검사하거나 변경할 수 있습니다.

숫자 및 날짜/시간 서식 그림

FieldFormat.NumericFormat은(는) 숫자 필드 결과에 적용되는 서식을 보관하는 쓰기 가능한 string 속성입니다. FieldFormat.DateTimeFormat은(는) 날짜 및 시간 필드 결과에 적용되는 서식을 보관하는 쓰기 가능한 string 속성입니다. 두 속성 중 하나를 설정하면 해당 필드 유형이 계산된 값을 표시하는 방식을 변경할 수 있습니다.

일반 서식

FieldFormat.GeneralFormats은(는) GeneralFormatCollection을(를) 반환합니다 — 숫자, 텍스트 또는 모든 필드 결과에 적용되는 범용 포맷입니다. 그 구성원은 GeneralFormat 열거형에서 가져오며, 여기에는 대소문자 변환(Upper, Lower, FirstCap, Caps), 로마 숫자 및 서수(UppercaseRoman, LowercaseRoman, Ordinal, OrdText), 통화 및 기수 텍스트(DollarText, BahtText, CardText), 로케일별 번호 체계(Aiueo, Arabic, ArabicAbjad, ArabicAlpha, ArabicDash, ChineseNum1–ChineseNum3, KanjiNum1–KanjiNum3, Hebrew1, Hebrew2, Ganada, Chosung, Zodiac1–Zodiac3, ThaiArabic, ThaiCardText, ThaiLetter, HindiArabic, HindiCardText, HindiLetter1, HindiLetter2, VietCardText, DBNum1–DBNum4, DBChar, SBChar, GB1–GB4, Hex, CircleNum, UppercaseAlphabetic, LowercaseAlphabetic) 및 병합 필드 전용 값 CharFormat, MergeFormat, MergeFormatInet을(를) 포함합니다. None은(는) 일반 포맷을 지웁니다.

GeneralFormatCollection 관리

GeneralFormatCollection은(는) IEnumerable<GeneralFormat>을 구현하므로, foreach 루프에서 GetEnumerator()로 반복할 수 있습니다. Add(item)를 호출하여 GeneralFormat 값을 추가하고, Remove(item)를 사용하여 값의 모든 발생을 제거하거나, RemoveAt(index)를 사용하여 특정 위치의 값을 제거합니다. Count은(는) 현재 적용된 일반 포맷 수를 보고합니다.

팁 및 모범 사례

필드 코드 문자열에 포맷팅 그림을 직접 삽입하는 대신 Field.Format.NumericFormat 또는 Field.Format.DateTimeFormat을 설정하십시오 — 입력된 속성이 필드 코드와 해당 포맷 전환을 동기화합니다.
여러 GeneralFormat 값(예: Upper 및 MergeFormat)을 각각 GeneralFormats에 개별적으로 추가하여 결합합니다; 컬렉션은 하나 이상의 항목을 허용합니다.
어떤 FieldFormat 속성을 변경한 후에는 소유 필드에서 Update()을 호출하여 새로운 포맷이 Result / DisplayResult에 반영되도록 합니다.
컬렉션에 오래된 포맷 값이 남지 않도록 GeneralFormat.None을 사용하여 일반 포맷 항목을 명시적으로 삭제하십시오.
GeneralFormatCollection.Count를 확인한 후에 필드에 일반 서식이 적용되지 않았다고 가정하세요 — 빈 컬렉션과 None을 포함하는 컬렉션은 서로 다른 상태입니다.

일반적인 문제

문제	원인	해결 방법
`NumericFormat`를 변경해도 눈에 보이는 효과가 없습니다	변경 후 필드가 다시 계산되지 않았습니다	어떤 `FieldFormat` 속성을 편집한 후 필드에 `Update()`를 호출하십시오
중복된 일반 형식이 `GeneralFormats`에 나타납니다	동일한 `GeneralFormat` 값에 대해 `Add(item)`가 여러 번 호출되었습니다	추가하기 전에 `GeneralFormatCollection.Count`를 확인하거나 반복하고, 먼저 `Remove(item)`을 호출하십시오.
잘못된 항목이 `GeneralFormats`에서 제거되었습니다.	`RemoveAt(index)`가 이전 제거 후 이동된 인덱스로 호출되었습니다.	인덱스로 제거하기 전에 `Count`를 확인하고 컬렉션을 다시 반복하십시오.

FAQ

`FieldFormat`는 무엇에 사용됩니까?

이는 Field.Format에서 노출되는 형식화된 객체이며, 필드의 숫자 서식(NumericFormat), 날짜/시간 서식(DateTimeFormat), 그리고 일반 서식(GeneralFormats)에 접근할 수 있게 합니다.

필드에 여러 개의 일반 서식이 적용될 수 있나요?

예 — GeneralFormats는 GeneralFormatCollection이며, Add를 사용해 하나 이상의 GeneralFormat 값을 할당할 수 있습니다.

필드에서 모든 일반 서식을 제거하려면 어떻게 해야 하나요?

각 값을 위해 GeneralFormats를 반복하고 Remove(item)을 호출하거나, 특정 항목에 대해서는 RemoveAt(index)를 사용합니다.

`FieldFormat` 속성을 설정하면 필드에 표시된 텍스트가 자동으로 새로 고쳐지나요?

아니요 — Format 속성을 변경한 후 필드에 Update()을 호출하여 Result와 DisplayResult가 새로운 서식을 반영하도록 하세요.

API Reference 요약

클래스/메서드	설명
`FieldFormat`	필드의 숫자, 날짜/시간 및 일반 서식에 대한 유형화된 접근; `Field.Format`를 통해 제공됩니다.
`FieldFormat.NumericFormat`	숫자 필드 결과에 적용된 서식 그림
`FieldFormat.DateTimeFormat`	날짜/시간 필드 결과에 적용된 서식 그림
`FieldFormat.GeneralFormats`	`GeneralFormatCollection` 일반 서식이 필드 결과에 적용됨
`GeneralFormat`	일반 서식 스위치 열거형 (대소문자 변환, 번호 매기기 시스템, 병합 필드 서식)
`GeneralFormatCollection`	타입이 지정된 `GeneralFormat` 값 컬렉션; `Add`, `Remove`, `RemoveAt`, `Count`, `GetEnumerator`

참조

Aspose.Words for .NET — Enterprise Documentation