_Format 類別

定義

命名空間:: Java.Text

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

Format 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。

[Android.Runtime.Register("java/text/Format", DoNotGenerateAcw=true)]
public abstract class _Format : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.ICloneable

[<Android.Runtime.Register("java/text/Format", DoNotGenerateAcw=true)>]
type _Format = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICloneable

繼承: Object

JavaObject

Object
_Format

衍生: Android.Icu.Text.SelectFormat

Android.Icu.Text.UFormat

Java.Text.DateFormat

Java.Text.MessageFormat

Java.Text.NumberFormat

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable ICloneable IDisposable

備註

Format 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。

Format 定義將位置敏感物件格式化為 StringS（方法） format 及將 StringS 解析回物件（方法） parseObject 的程式介面。

一般來說，格式 parseObject 的方法必須能夠解析其方法格式化的任何 format 字串。然而，也可能有特殊情況無法做到這點。例如，一種 format 方法可能會產生兩個相鄰的整數，中間沒有分隔符，在這種情況下，無法 parseObject 判斷哪些數字屬於哪個數字。

Java 平台提供三個專門的子類別，Format-- 分別DateFormatMessageFormatNumberFormat用於日期、訊息和數字的格式化。

具體子類必須實作三種方法：<ol><li>format(Object obj, StringBuffer toAppendTo, FieldPosition pos)<li li>formatToCharacterIterator(Object obj)<>parseObject(String source, ParsePosition pos)</ol> 這些一般方法允許物件的多態解析與格式化，例如。MessageFormat 子類別通常也會針對特定輸入類型提供額外 format 方法，以及 parse 針對特定結果類型的方法。任何 parse 不接受 ParsePosition 參數的方法，都應該在輸入文字開頭沒有所需格式文字時拋出 ParseException 參數。

大多數子類別也會實作以下工廠方法：<ol><li>getInstance 用於取得適用於當前區域<>getInstance(Locale)的有用格式物件 li 用於取得適合指定區域<的有用格式物件 /ol>。此外，有些子類別也可能實作其他getXxxxInstance方法以進行更專門化的控制。例如，課程NumberFormat提供了getPercentInstancegetCurrencyInstance取得專用數字格式化工具的方法。

允許程式設計師為區域建立物件的子類別 Format （例如） getInstance(Locale) 也必須實作以下類別方法： <blockquote>

public static Locale[] getAvailableLocales()

</區塊引用>

最後，子類別可定義一組常數，以識別格式化輸出中的各種欄位。這些常數用來建立一個 FieldPosition 物件，用以識別欄位中包含的資訊及其在格式化結果中的位置。這些常數應命名 <em>item</em>_FIELD 為，其中 <em>item</em> 代表域。關於這些常數的例子，請參見 ERA_FIELD 及其 friends 在 DateFormat。

格式通常不會同步。建議為每個執行緒建立獨立格式實例。若多個執行緒同時存取同一格式，必須在外部同步。

在 1.1 版本中加入。

的 java.text.FormatJava 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

建構函式

名稱	Description
_Format()	唯一的製造者。
_Format(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
JniPeerMembers	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。
Construct(JniObjectReference, JniObjectReferenceOptions)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
Equals(Object)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
Format(Object, StringBuffer, FieldPosition)	格式化物件並將產生的文字附加到指定的字串緩衝區。
Format(Object)	格式化物件以產生字串。
FormatToCharacterIterator(Object)	格式化物件產生 `AttributedCharacterIterator`。
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
ParseObject(String, ParsePosition)	從字串中解析文字以產生物件。
ParseObject(String)	解析給定字串開頭的文字以產生物件。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	Description
IJavaPeerable.Disposed()	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	`Format` 是一個抽象基底類別，用於格式化區域敏感資訊，如日期、訊息和數字。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於