CollationKey 類別

定義

命名空間:: Java.Text

組件:: Mono.Android.dll

重要

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

A CollationKey 代表 a String 在特定 Collator 物件的規則下。

[Android.Runtime.Register("java/text/CollationKey", DoNotGenerateAcw=true)]
public abstract class CollationKey : Java.Lang.Object, IDisposable, Java.Lang.IComparable

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

繼承: Object

JavaObject

Object
CollationKey

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable IComparable IDisposable

備註

A CollationKey 代表 a String 在特定 Collator 物件的規則下。比較兩個 CollationKeys 會回傳它們所代表 s 的 String相對順序。使用 CollationKeyS 來比較 Strings 通常比使用 Collator.compareS 更快。因此，當 Strings 必須多次比較時，例如在排序 s 的列表 String時，使用 CollationKeys 會更有效率。

你不能直接創建 CollationKeys。相反地，透過呼叫 Collator.getCollationKey來生成。你只能比較 CollationKey由同一 Collator 物件產生的 s。

產生 a CollationKey for a String 涉及檢視整個 String 資料並將其轉換為可逐位比較的一系列位元。這讓金鑰產生後能快速比較。當 Strings 需要多次比較時，產生金鑰的成本可透過更快的比較回收。另一方面，比較結果通常由每個 String的前幾個字元決定。 Collator.compare 只檢查所需的字元數量，使得單次比較時速度更快。

以下範例展示了如何使用 CollationKeys 來排序 s 的列表 String。 <引用>

{@code
            // Create an array of CollationKeys for the Strings to be sorted.
            Collator myCollator = Collator.getInstance();
            CollationKey[] keys = new CollationKey[3];
            keys[0] = myCollator.getCollationKey("Tom");
            keys[1] = myCollator.getCollationKey("Dick");
            keys[2] = myCollator.getCollationKey("Harry");
            sort(keys);

            //...

            // Inside body of sort routine, compare keys this way
            if (keys[i].compareTo(keys[j]) > 0)
               // swap keys[i] and keys[j]

            //...

            // Finally, when we've returned from sort.
            System.out.println(keys[0].getSourceString());
            System.out.println(keys[1].getSourceString());
            System.out.println(keys[2].getSourceString());
            }

</區塊引用>

在 1.1 版本中加入。

的 java.text.CollationKeyJava 檔。

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

建構函式

名稱	Description
CollationKey(IntPtr, JniHandleOwnership)	用於建立 JNI 物件受管理表示的建構器;由執行時呼叫。
CollationKey(String)	CollationKey 建構器。

屬性

名稱	Description
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
JniPeerMembers	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
SourceString	回傳此 CollationKey 所代表的字串。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
CompareTo(CollationKey)	將此 CollationKey 與目標 CollationKey 進行比較。
Construct(JniObjectReference, JniObjectReferenceOptions)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
Equals(Object)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToByteArray()	將 CollationKey 轉換為一連串位元。
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
IComparable.CompareTo(Object)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。
IJavaPeerable.Disposed()	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	A `CollationKey` 代表 a `String` 在特定 `Collator` 物件的規則下。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於