MessageFormat 类

定义

[Android.Runtime.Register("java/text/MessageFormat", DoNotGenerateAcw=true)]
public class MessageFormat : Java.Text._Format

[<Android.Runtime.Register("java/text/MessageFormat", DoNotGenerateAcw=true)>]
type MessageFormat = class
    inherit _Format

继承

Object

Object

_Format

MessageFormat

属性

RegisterAttribute

注解

MessageFormat 提供一种以非特定语言方式生成串联消息的方法。 使用此方法可构造为最终用户显示的消息。

MessageFormat 获取一组对象，设置这些对象的格式，然后将格式化字符串插入到相应位置的模式中。

<strong Note：</strong>MessageFormat> 与其他Format类不同，即使用其构造函数之一（而不是getInstance样式工厂方法）创建MessageFormat对象。 工厂方法不是必需的，因为 MessageFormat 本身不实现区域设置特定的行为。 任何区域设置特定行为都由你提供的模式以及用于插入参数的子格式定义。

<h2>“patterns”>Patterns and Their Interpretation</h2>

MessageFormat 使用以下格式的模式： <blockquote>

<i>MessageFormatPattern:</i>
<i>String</i>
<i>MessageFormatPattern</i> <i>FormatElement</i> <i>String</i>

<i>FormatElement:</i>
                    { <i>ArgumentIndex</i> }
                    { <i>ArgumentIndex</i> , <i>FormatType</i> }
                    { <i>ArgumentIndex</i> , <i>FormatType</i> , <i>FormatStyle</i> }

<i>FormatType: one of </i>
                    number date time choice

<i>FormatStyle:</i>
                    short
                    medium
                    long
                    full
                    integer
                    currency
                    percent
<i>SubformatPattern</i>

</blockquote>

在 字符串中，可以使用一对单引号来引用除单引号以外的任意字符。 例如，模式字符串 "'{0}'" 表示字符串 "{0}"，而不是 FormatElement。 单引号 '' 本身必须由 字符串中的双引号表示。 例如，模式字符串 "'{''}'" 被解释为一个序列 '{ （引号开头和左大括号）、 '' （单引号）和 }' （右大括号和引号的结尾）、 <em>not</em>'{' 和 '}' （左大括号和右大括号）：表示字符串 "{'}"， <em>not</em>"{}"。

SubformatPattern 由其相应的子格式解释，并应用子格式依赖模式规则。 例如，模式字符串"{1,number,<u>$'#',##</u>}"（带下划线的 SubformatPattern）将生成带井号引号的数字格式，结果如下： "$#31,45" 有关详细信息，请参阅每个 Format 子类文档。

任何不匹配的引号在给定模式的末尾被视为已关闭。 例如，模式字符串 "'{0“}被视为模式 "'{0'”}。

非引号模式中的任何大括号都必须保持平衡。 例如，"ab {0} de"并且"ab '}' de"是有效的模式，但"''{''""ab {0'}' de""ab } de"不是。

<dl><dt><b>Warning：</b><dd>消息格式模式中使用引号的规则似乎有些令人困惑。 具体而言，本地化人员是否需要加倍单引号并不总是显而易见的。 请确保通知本地化人员有关规则的信息，并告诉它们（例如，通过使用资源捆绑源文件中的注释）将处理 MessageFormat哪些字符串。 请注意，本地化人员可能需要在原始版本没有单引号的已翻译字符串中使用单引号。 </dl>

ArgumentIndex 值是使用数字'0''9'写入的非负整数，表示传递给format方法或方法返回parse的结果数组中的索引arguments。

FormatType 和 FormatStyle 值用于为 format 元素创建Format实例。 下表显示了值如何映射到 Format 实例。 表中未显示的组合是非法的。 SubformatPattern 必须是所用子类的有效模式字符串Format。

<table class=“plain”><caption style=“display：none”>显示 FormatType 和 FormatStyle 值如何映射到 Format instances</caption><thead<>tr><th scope=“col” class=“TableHeadingColor”>FormatType <th scope=“col” class=“TableHeadingColor”>FormatStyle <th scope=“col” class=“TableHeadingColor”>Subformat Created </thead<>tbody<>tr><th scope=“row” style=“text-weight： normal”>（无）<th scope=“row” style=“text-weight： normal”>（none）<td>null<tr th scope=“row” style=“text-weight： normal” rowspan=5><numberth scope=“row” style=“text-weight： normal”>（none）<td tr th scope=“row” style=“text-weight： normal”><integertd tr<><>><th scope=“row” style=“text-weight： normal”currency><td(getLocale())NumberFormat#getIntegerInstance(Locale) NumberFormat.getIntegerInstance<>td>NumberFormat#getInstance(Locale) NumberFormat.getInstance(getLocale())<>NumberFormat#getCurrencyInstance(Locale) NumberFormat.getCurrencyInstance(getLocale())<tr><th scope=“row” style=“text-weight： normal”>percent<td>(getLocale())<NumberFormat#getPercentInstance(Locale) NumberFormat.getPercentInstancetr><th scope=“row” style=“text-weight： normal”>SubformatPattern<td tr th scope=“row” style=“text-weight： normal” rowspan=date<>“row” style=“text-weight： normal”>（none）<td><DecimalFormat#DecimalFormat(String,DecimalFormatSymbols) DecimalFormat(getLocale()))new(subformatPattern,DecimalFormatSymbols#getInstance(Locale) DecimalFormatSymbols.getInstance<DateFormat#DEFAULT>DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance, getLocale())(tr><><th scope=“row” style=“text-weight：normal“><shorttd>(, getLocale())<DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstanceDateFormat#SHORTtr><th scope=”row“ style=”text-weight： normal“><mediumtd>DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstanceDateFormat#DEFAULT(, getLocale())<tr><th scope=”row“ style=”text-weight： normal“><longtd tr><th scope=”row“ style=”text-weight： normal“>full<td>DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance(>DateFormat#LONG, getLocale()), getLocale())DateFormat#FULL<DateFormat#getDateInstance(int,Locale) DateFormat.getDateInstance(<tr th><scope=“row” style=“text-weight： normal”>SubformatPattern<td><newSimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat(subformatPattern, getLocale())tr th scope=“row” style=“text-weight： normal” rowspan=6<time>th scope=“row” style=“text-weight： normal”>（none）<td tr><th scope=“row” style=“text-weight： normal”><shorttd tr<<>>>DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance(DateFormat#DEFAULT, getLocale())<>DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance(DateFormat#SHORT, getLocale())<th scope=“row” style=“text-weight： normal”><mediumtd>, getLocale())DateFormat#DEFAULT(DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstance<tr th scope=“row” style=“text-weight： normal”><longtd>(, getLocale())<DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstanceDateFormat#LONGtr><th scope=“row” style=“text-weight： normal”><fulltd>(DateFormat#getTimeInstance(int,Locale) DateFormat.getTimeInstanceDateFormat#FULL<, getLocale())tr><<>th scope=“row” style=“text-weight： normal”>SubformatPattern<td>newSimpleDateFormat#SimpleDateFormat(String,Locale) SimpleDateFormat(subformatPattern, getLocale())<tr><th scope=“row” style=“text-weight： normal”><choiceth scope=“row” style=“text-weight： normal”>SubformatPattern<td>(subformatPattern)ChoiceFormat#ChoiceFormat(String) ChoiceFormat<new/tbody></table>

<h3>使用情况信息</h3>

下面是一些用法示例。 在实际的国际化程序中，消息格式模式和其他静态字符串当然将从资源捆绑包获取。 其他参数将在运行时动态确定。

第一个示例使用静态方法 MessageFormat.format，该方法在内部创建 MessageFormat 一次性使用： <blockquote>

int planet = 7;
            String event = "a disturbance in the Force";

            String result = MessageFormat.format(
                "At {1,time} on {1,date}, there was {2} on planet {0,number,integer}.",
                planet, new Date(), event);

</blockquote> 输出为： <blockquote>

At 12:30 PM on Jul 3, 2053, there was a disturbance in the Force on planet 7.

</blockquote>

以下示例创建 MessageFormat 可以重复使用的实例： <blockquote>

int fileCount = 1273;
            String diskName = "MyDisk";
            Object[] testArgs = {new Long(fileCount), diskName};

            MessageFormat form = new MessageFormat(
                "The disk \"{1}\" contains {0} file(s).");

            System.out.println(form.format(testArgs));

</blockquote> ：具有不同值的 fileCount输出： <blockquote>

The disk "MyDisk" contains 0 file(s).
            The disk "MyDisk" contains 1 file(s).
            The disk "MyDisk" contains 1,273 file(s).

</blockquote>

对于更复杂的模式，可以使用 a ChoiceFormat 为单数和复数形式生成正确的形式： <块>

MessageFormat form = new MessageFormat("The disk \"{1}\" contains {0}.");
            double[] filelimits = {0,1,2};
            String[] filepart = {"no files","one file","{0,number} files"};
            ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
            form.setFormatByArgumentIndex(0, fileform);

            int fileCount = 1273;
            String diskName = "MyDisk";
            Object[] testArgs = {new Long(fileCount), diskName};

            System.out.println(form.format(testArgs));

</blockquote> ：具有不同值的 fileCount输出： <blockquote>

The disk "MyDisk" contains no files.
            The disk "MyDisk" contains one file.
            The disk "MyDisk" contains 1,273 files.

</blockquote>

可以按上述示例或模式以编程方式创建 ChoiceFormat 。 有关详细信息，请参阅 ChoiceFormat。 <blockquote>

{@code
            form.applyPattern(
               "There {0,choice,0#are no files|1#is one file|1<are {0,number,integer} files}.");
            }

</blockquote>

<strong Note：</strong>> 如上所述，由 ChoiceFormat in MessageFormat 生成的字符串被视为特殊;“{”的出现用于指示子窗体，并导致递归。 如果同时创建和MessageFormatChoiceFormat编程方式（而不是使用字符串模式），请注意不要生成一种在自身上递归的格式，这将导致无限循环。

在字符串中多次分析单个参数时，最后一个匹配项将是分析的最终结果。 例如， <blockquote>

MessageFormat mf = new MessageFormat("{0,number,#.##}, {0,number,#.#}");
            Object[] objs = {new Double(3.1415)};
            String result = mf.format( objs );
            // result now equals "3.14, 3.1"
            objs = null;
            objs = mf.parse(result, new ParsePosition(0));
            // objs now equals {new Double(3.1)}

</blockquote>

同样，使用包含相同参数的多个匹配项的模式分析 MessageFormat 对象将返回最后一个匹配项。 例如， <blockquote>

MessageFormat mf = new MessageFormat("{0}, {0}, {0}");
            String forParsing = "x, y, z";
            Object[] objs = mf.parse(forParsing, new ParsePosition(0));
            // result now equals {new String("z")}

</blockquote>

<h3>“synchronization”>Synchronization</h3>

消息格式未同步。 建议为每个线程创建单独的格式实例。 如果多个线程同时访问格式，则必须在外部同步。

在 1.1 中添加。

Java文档java.text.MessageFormat。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。