MessageFormat.Format 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| Format(String, Object[]) | |
| Format(String, IDictionary<String,Object>) |
建立一個包含該模式的 MessageFormat,並用它來格式化給定的參數。 |
| Format(Object, StringBuffer, FieldPosition) |
格式化物件的映射或陣列,並將格式元素替換為格式化物件後,附加 |
| Format(Object[], StringBuffer, FieldPosition) |
格式化物件陣列,並將 的模式附加 |
| Format(IDictionary<String,Object>, StringBuffer, FieldPosition) |
格式化物件的映射,並將 的模式附加 |
Format(String, Object[])
[Android.Runtime.Register("format", "(Ljava/lang/String;[Ljava/lang/Object;)Ljava/lang/String;", "", ApiSince=24)]
public static string? Format(string? pattern, params Java.Lang.Object[]? arguments);
[<Android.Runtime.Register("format", "(Ljava/lang/String;[Ljava/lang/Object;)Ljava/lang/String;", "", ApiSince=24)>]
static member Format : string * Java.Lang.Object[] -> string
參數
- pattern
- String
- arguments
- Object[]
傳回
- 屬性
備註
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
Format(String, IDictionary<String,Object>)
建立一個包含該模式的 MessageFormat,並用它來格式化給定的參數。
[Android.Runtime.Register("format", "(Ljava/lang/String;Ljava/util/Map;)Ljava/lang/String;", "", ApiSince=24)]
public static string? Format(string? pattern, System.Collections.Generic.IDictionary<string,Java.Lang.Object>? arguments);
[<Android.Runtime.Register("format", "(Ljava/lang/String;Ljava/util/Map;)Ljava/lang/String;", "", ApiSince=24)>]
static member Format : string * System.Collections.Generic.IDictionary<string, Java.Lang.Object> -> string
參數
- pattern
- String
- arguments
- IDictionary<String,Object>
傳回
- 屬性
備註
建立一個包含該模式的 MessageFormat,並用它來格式化給定的參數。 該模式必須以名稱而非編號來識別參數。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
Format(Object, StringBuffer, FieldPosition)
格式化物件的映射或陣列,並將格式元素替換為格式化物件後,附加 MessageFormat於所提供的 StringBuffer。
[Android.Runtime.Register("format", "(Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)]
public override sealed Java.Lang.StringBuffer? Format(Java.Lang.Object? arguments, Java.Lang.StringBuffer? result, Java.Text.FieldPosition? pos);
[<Android.Runtime.Register("format", "(Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)>]
override this.Format : Java.Lang.Object * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer
參數
- arguments
- Object
一個要格式化的物件的映射或陣列
- result
- StringBuffer
其中文字會被附加
- pos
- FieldPosition
輸入時:對齊場(如需要);輸出時:對齊場的偏移量
傳回
- 屬性
備註
格式化物件的映射或陣列,並將格式元素替換為格式化物件後,附加 MessageFormat於所提供的 StringBuffer。 這等同於 blockquote>{@link #format(java.util.Map, java.lang.StringBuffer, java.text.FieldPosition) format}((Map) arguments, result, pos){@link #format(java.lang.Object[], java.lang.StringBuffer, java.text.FieldPosition) format}((Object[]) arguments, result, pos)</blockquote> 中的任一種<。如果此格式使用命名參數,必須提供映射,否則會拋出 IllegalArgumentException。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
Format(Object[], StringBuffer, FieldPosition)
格式化物件陣列,並將 的模式附加 MessageFormat於 ,參數被格式化物件取代,並附加於提供的 StringBuffer。
[Android.Runtime.Register("format", "([Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)]
public Java.Lang.StringBuffer? Format(Java.Lang.Object[]? arguments, Java.Lang.StringBuffer? result, Java.Text.FieldPosition? pos);
[<Android.Runtime.Register("format", "([Ljava/lang/Object;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)>]
override this.Format : Java.Lang.Object[] * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer
參數
- arguments
- Object[]
一個待格式化與替換的物件陣列。
- result
- StringBuffer
其中文字會被附加。
- pos
- FieldPosition
輸入時:如果需要,可以設定一個對齊欄位。 輸出時:對齊場的偏移量。
傳回
- 屬性
備註
格式化物件陣列,並將 的模式附加 MessageFormat於 ,參數被格式化物件取代,並附加於提供的 StringBuffer。
替換成個別格式元素的文字,是根據格式元素目前的子格式以及 arguments 格式元素參數索引中的元素,如下表第一行匹配所示。 若 arguments 或 的null元素少於 argumentIndex+1,則該參數不可用。 當論元不可用時,則不進行替換。
<表格邊框=1><tr><th>argType 或格式 <th>值物件 <th>格式化文字 <tr<>td> 任意 <td>不可用<td><><"{" + argNameOrNumber + "}"td<> td 任何 td><nulltd"null"><tr><td>自訂 格式<!= null td> 任意 <tdcustomFormat.format(argument)><tr><td>noneArg,或自訂格式 == null<td>td>NumberFormat.getInstance(getLocale()).format(argument)<tr<>td>noneArg,或自訂格式<== null tdinstanceof Date><td<>DateFormat.getDateTimeInstance(DateFormat.SHORT, DateFormat.SHORT, getLocale()).format(argument)tr<>td>noneArg,或自訂格式 == null<td<instanceof String>tdargument><tr><td>noneArg,或自訂格式<== null td> 任意 <tdargument.toString()<>tr<>td>複雜 Argtd<>< 任何 td>所選遞迴格式化的結果instanceof Number<子訊息 </表格>
若 pos 非空,且指的是 Field.ARGUMENT,則會回傳第一個格式化字串的位置。
此方法僅在格式不使用命名參數時支援,否則會拋出 IllegalArgumentException。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。
適用於
Format(IDictionary<String,Object>, StringBuffer, FieldPosition)
格式化物件的映射,並將 的模式附加 MessageFormat於 ,參數被格式化的物件取代,附加於所提供的 StringBuffer。
[Android.Runtime.Register("format", "(Ljava/util/Map;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)]
public Java.Lang.StringBuffer? Format(System.Collections.Generic.IDictionary<string,Java.Lang.Object>? arguments, Java.Lang.StringBuffer? result, Java.Text.FieldPosition? pos);
[<Android.Runtime.Register("format", "(Ljava/util/Map;Ljava/lang/StringBuffer;Ljava/text/FieldPosition;)Ljava/lang/StringBuffer;", "", ApiSince=24)>]
override this.Format : System.Collections.Generic.IDictionary<string, Java.Lang.Object> * Java.Lang.StringBuffer * Java.Text.FieldPosition -> Java.Lang.StringBuffer
參數
- arguments
- IDictionary<String,Object>
一個要格式化並替換的物件映射。
- result
- StringBuffer
其中文字會被附加。
- pos
- FieldPosition
輸入時:如果需要,可以設定一個對齊欄位。 輸出時:對齊場的偏移量。
傳回
傳入的 StringBuffer
- 屬性
備註
格式化物件的映射,並將 的模式附加 MessageFormat於 ,參數被格式化的物件取代,附加於所提供的 StringBuffer。
替換成個別格式元素的文字,是從格式元素目前的子格式及其 arguments 參數名稱的值中衍生出來的。
編號模式參數會與包含該數字的 ASCII 十進位數字字串(無前置零)的映射金鑰匹配。
若 arguments 是null或不對應於模式中的參數名稱,則該參數不可用。 當論元不可用時,則不進行替換。
本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。