LDML データを使用したカルチャの記述

アプリケーションが Save でカルチャを保存すると、CultureAndRegionInfoBuilder オブジェクトの XML 表現は、LDML (Locale Data Markup Language) Version 1.1 の形式に従って作成されます。 CreateFromLdml メソッドは Save の逆で、この XML ファイルから読み込まれます。

カルチャを記述する意味のあるデータのほとんどは、XML ファイル内の特殊な要素に格納されています。 LDML の特殊な要素により、製品固有の注釈とデータを使用できます。

.NET Framework では、この特殊な要素に msLocale スキーマ (https://schemas.microsoft.com/globalization/2005/carib/ldml) から抽出されるデータを格納します。 通常のスキーマの場合と同様、この URI は一意の名前を示すものであり、実際のドキュメントの URL ではありません。

関連する XML 要素のほとんどは、CultureAndRegionInfoBuilder クラスや CultureInfo クラスなど、カルチャを記述するクラスのプロパティまたはメソッドの戻り値に対応します。 一部の要素は .NET Framework ではなく Windows に固有であり、CultureAndRegionInfoBuilder のプロパティとしては含まれません。

LDML 標準の詳細については、Unicode ホーム サイトの『Unicode Technical Standard #35』の「Locale Data Markup Language (LDML)」を参照してください。

Windows 専用の要素

このトピックに示す要素には、"Windows 専用" と示されているものがあります。 これらの要素は Windows のアンマネージ コードに関連するもので、.NET Framework には関連しません。 アプリケーションが .NET Framework の外部で LDML ファイルを作成し、.NET Framework を使用してファイルを登録する場合、そのファイルは Windows と .NET Framework の両方で使用できます。 .NET Framework 内でアプリケーションが既存のカルチャ定義に変更を加えてカスタムのカルチャとして保存した場合、Windows 専用の要素は、元のカルチャから保存されたカルチャにそのままの状態で渡されます。

identity 要素

identity 要素について次の表で説明します。

identity/special 要素を次に示します。 特に記載のない限り、値はすべて type 属性によって指定されます。 次に例を示します。

    <identity>
        ...
        <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
             <!-- A typical case... -->
             <msLocale:cultureAndRegionInfoName type="en-US-fabricam"/>
             ...
             <!-- ...but here are some examples that use CDATA -->
             <msLocale:geoId>244</msLocale:geoId>
             <msLocale:languageIsoName type="twoLetters">
                 en
             </msLocale:languageIsoName> 
             ...
        </special>
    </identity>

次の表は、identity 要素に対応するプロパティとメソッドについての説明です。

layout 要素

layout 要素について次の表で説明します。

次の表に示す要素は layout/special に分類されます。

characters 要素

characters 要素について次の表で説明します。

characters/special 要素について次の表で説明します。 特に記載のない限り、値はすべて type 属性によって指定されます。

次の要素は characters/special/msLocale:fontSignature に分類されます。

• msLocale:unicodeRanges

• msLocale:defaultCodePages

• msLocale:codePages

これらの要素は、いずれも厳密には msLocale スキーマから抽出される内容を格納するためのコンテナーです。

次の表に示す要素は characters/special/msLocale:fontSignature/msLocale:unicodeRanges に分類されます。 値はすべて type 属性によって指定されます。 これは Windows 専用の情報であり、一部は Windows の LOCALESIGNATURE 構造体に対応します。

次の要素は、characters/special/msLocale:fontSignature/msLocale:defaultCodePages および characters/special/msLocale:fontSignature/msLocale:codePages に分類されます。

• msLocale:ansiCodePage

• msLocale:ansiOemCodePage

• msLocale:oemCodePage

これらの要素は、いずれも厳密には msLocale:codePage 要素のコンテナーで、値は type 属性によって指定されます。

characters/special/msLocale:fontSignature/msLocale:defaultCodePages では、次のいずれかに該当する必要があります。

• 単一の msLocale:codePage 要素を含む単一の msLocale:ansiOemCodePage 要素

• 単一の msLocale:codePage 要素を含む単一の msLocale:ansiCodePage 要素、および単一の msLocale:codePage 要素を含む msLocale:oemCodePage 要素

msLocale:defaultCodePages データは Windows 専用データです。 characters/special/msLocale:fontSignature/msLocale:codePages データも Windows 専用の情報です。 指定した言語とスクリプトをサポートするすべてのコード ページが表示されます。 したがって、このリストには同じ種類の複数のコード ページを表示できます。 次に例を示します。

<msLocale:codePages>
    <msLocale:ansiCodePage>
        ...
    </msLocale:ansiCodePage>
    <msLocale:oemCodePage>
        <msLocale:codePage type="864" />
        <msLocale:codePage type="708" />
    </msLocale:oemCodePage>
</msLocale:codePages>

次の表に示す要素は characters/special/msLocale:fontSignature/msLocale:scripts に分類されます。 値はすべて type 属性によって指定されます。 これは Windows 専用の情報です。 このデータを Windows で設定する方法はありませんが、Windows GetStringScripts 関数の戻り値に対応します。

measurement 要素

次の表は、measurement に属する要素の定義を示しています。

日付要素

dates に属する要素は calendars 要素だけです。 これは単なるコンテナー要素です。

メモ
.NET Framework は、標準 LDML 要素 (msLocale スキーマではなく LDML 名前空間から取得される要素) の日付と時刻の書式を POSIX 規則に基づいて解釈します。たとえば、AM/PM のインジケーターは "a" です。msLocale スキーマ内の要素は、日付と時刻の書式については Microsoft の規則に従います。たとえば、AM/PM 指定子は "tt" 書式パターンによって指定されます。

dates/calendars に属する要素について次の表で説明します。 値はすべて type 属性によって指定されます。

次の表に示す要素は、dates/calendars/calendar に分類されます。 値はすべて type 属性によって指定されます。

dates/calendars/calendar/months では、単一の monthContext 要素です。この要素には "format" の type 属性が必要です。 dates/calendars/calendar/months/monthContext では、4 つの monthWidth 要素が必要です。

dates/calendars/calendar/months/monthContext/monthWidth には、年の月ごとに 1 つの month 要素が必要です。 要素数は、暦によって 12 または 13 となります。 各 months 要素について、type は月を示す数であり、CDATA 型は対応する文字列を示します。 次に例を示します。

...
<calendar type="Gregorian">
   <months>
      <monthContext type="format">
          <monthWidth type="wide">            
              <month type="1">January</month>
              <month type="2">February</month>
              <month type="3">March</month>
              ...
          </monthWidth>
          <monthWidth type="abbreviated">
              <month type="1">Jan</month>
              <month type="2">Feb</month>
              <month type="3">Mar</month>
              ...
          </monthWidth>
          ...
      </monthContext>
   </months>
</calendar>

dates/calendars/calendar/days では、単一の dayContext 要素です。この要素には "format" の type 属性が必要です。 dates/calendars/calendar/days/dayContext では、3 つの dayWidth 要素が必要です。

dates/calendars/calendar/days/dayContext/dayWidth には、曜日ごとに 1 つの day 要素が必要です。 各 day 要素について、type の値は "sun"、"mon"、"tue"、"wed"、"thu"、"fri"、"sat" のいずれかです。 CDATA 型は対応する文字列を示します。 次に例を示します。

...
<calendar type="Gregorian">
   <days>
      <dayContext type="format">
          <dayWidth type="wide">
              <day type="sun">Sunday</month>
              <day type="mon">Monday</month>
              <day type="tue">Tuesday</month>
              ...
          </dayWidth>
          ...
      </dayContext>
   </days>
</calendar>

次の表に示す要素は dates/calendars/calendar/week に分類されます。

次の表に示す要素は dates/calendars/calendar/week/special に分類されます。

次の表に示す要素は dates/calendars/calendar/dateformats に分類されます。

次の表に示す要素は dates/calendars/calendar/dateformats/special に分類されます。 値はすべて type 属性によって指定されます。

次の表に示す要素は dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength に分類されます。 値はすべて type 属性によって指定されます。

次の要素は、値を CDATA 型として指定する msLocale:pattern 要素のコンテナーです。

• dates/calendars/calendar/dateformats/special/msLocale:dateFormatLength /msLocale:dateformat

• dates/calendars/calendar/dateformats/special/msLocale:yearMonth

• dates/calendars/calendar/dateformats/special/msLocale:monthDay

次に例を示します。

<dateFormats>
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:dateFormatLength type="long">
            <msLocale:default type="0"/>
            <msLocale:dateFormat type="0">
                <msLocale:pattern>dddd, MMMM dd, yyyy</pattern>
            </msLocale:dateFormat>
                       
            <msLocale:dateFormat type="1">
                <msLocale:pattern>MMMM dd, yyyy</pattern>
            </msLocale:dateFormat>
            ...
        </msLocale:dateFormatLength>
        ...
        <msLocale:yearMonth type="0">
            <msLocale:pattern>MMMM, yyyy</msLocale:pattern>
        </msLocale:yearMonth>

        <msLocale:yearMonth type="1">
            <msLocale:pattern>mm, yy</msLocale:pattern>
        </msLocale:yearMonth>

        <msLocale:monthDay>
            <msLocale:pattern>MMMM dd</msLocale:pattern>
        </msLocale:monthDay>
    </special>
</dateFormats>

次の表に示す要素は dates/calendars/calendar/timeformats に分類されます。

次の表に示す要素は dates/calendars/calendar/timeformats/special に分類されます。 値はすべて type 属性によって指定されます。

次の表に示す要素は dates/calendars/calendar/dateformats/special/msLocale:durationFormats に分類されます。 値はすべて type 属性によって指定されます。

次の表に示す要素は dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength に分類されます。 値はすべて type 属性によって指定されます。

次の要素は、値を CDATA 型として指定する msLocale:pattern 要素のコンテナーです。

• dates/calendars/calendar/dateformats/special/msLocale:durationFormats/msLocale:durationFormat

• dates/calendars/calendar/dateformats/special/msLocale:timeFormatLength/msLocale:timeformat

次に例を示します。

<timeFormats>
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:durationFormats>
            <msLocale:default type="0" />
            <msLocale:durationFormat type="0">
                <msLocale:pattern>HH:mm:ss</msLocale:pattern>
            </msLocale:durationFormat>
        </msLocale:durationFormats>

        <msLocale:timeFormatLength type="long">
            <msLocale:default type="0"/>
            <msLocale:timeFormat type="0">
                <msLocale:pattern>h:mm:ss tt</msLocale:pattern>
            </msLocale:timeFormat>
            <msLocale:timeFormat type="1">
                <msLocale:pattern>h:mm:ss a</msLocale:pattern>
            </timeFormat>
            ...
        </timeFormatLength>
        ...
    </special>
</timeFormats>

次の表に示す要素は dates/calendars/calendar/eras に分類されます。

dates/calendars/calendar/eras/eraAbbr および dates/calendars/calendar/eras/eraNames には、年号ごとに 1 つの era 要素が必要です。 各 era 要素について、type は年号を示す数であり、CDATA 型は対応する文字列を示します。 次に例を示します。

<eras>
   <eraAbbr>
      <era type="0">BC</era>
      <era type="1">AD</era>
   </eraAbbr>
   <eraNames>
      <era type="0">Before Christ</era>
      <era type="1">Anno Domini</era>
   </eraNames>
</eras>

numbers 要素

次の表は、numbers に属する要素の定義を示しています。

numbers/symbols の要素

次の表に示す要素は、numbers/symbols に分類されます。 特に記載のない限り、これらの要素には CDATA 型のデータが割り当てられます。

次の表に示す要素は numbers/symbols/special に分類されます。 特に記載のない限り、これらの要素には CDATA 型のデータが割り当てられます。

次に例を示します。

<symbols>
    <decimal>.</decimal>
    <group>,</group>
    ...
    <infinity type="positive">Infinity</infinity>
    <infinity type="negative">-Infinity</infinity>
    ...
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:currencyDecimalSeparator>
            .
        </msLocale:currencyDecimalSeparator>
        <msLocale:currencyGroupSeparator>
            ,
        </msLocale:currencyGroupSeparator>
        <msLocale:leadingZero type="yes" />
    </special>
</symbols>

numbers/currencies の要素

次の表に示す要素は numbers/currencies に分類されます。

次の表に示す要素は numbers/currencies/currency に分類されます。 特に記載のない限り、これらの要素には CDATA 型のデータが割り当てられます。

次の表に示す要素は numbers/currencies/currency/special に分類されます。 特に記載のない限り、これらの要素には CDATA 型のデータが割り当てられます。

次に例を示します。

<currencies>
    <currency type="default">
        <symbol>$</symbol>
        <displayName>Dollar</displayName>
        <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
                <msLocale:isoCurrency>USD</msLocale:isoCurrency>
                <msLocale:currencyEnglishName>
                    Dollar
                </msLocale:currencyEnglishName>
    </special>
</currency>

次の表に示す要素は numbers/currencies/special に分類されます。 特に記載のない限り、値はすべて type 属性によって指定されます。

次に例を示します。

<numbers>
    ...
    <special xmlns:msLocale="https://schemas.microsoft.com/globalization/2005/carib/ldml">
        <msLocale:decimalDigits>2</msLocale:decimalDigits>     
        <msLocale:negativePattern type="1"/>
        <msLocale:currencyDecimalDigits type="2"/>
        <msLocale:currencyPositivePattern type="0"/>
        <msLocale:currencyNegativePattern type="0"/>
        <msLocale:percentNegativePattern type="0"/>
        <msLocale:percentPositivePattern type="0"/>
        <msLocale:groupSizes type="0">3</msLocale:groupSizes>
        <msLocale:currencyGroupSizes type="0">
            3
        </msLocale:currencyGroupSizes>
        <msLocale:nativeDigits type="0">0</msLocale:nativeDigits>
        <msLocale:nativeDigits type="1">1</msLocale:nativeDigits>
        ...
        <msLocale:nativeDigits type="9">9</msLocale:nativeDigits>
        <msLocale:digitSubstitution type="context"/>
    </special>
</numbers>

参照

参照

CultureAndRegionInfoBuilder