ULocale 類別

定義

命名空間:: Android.Icu.Util

組件:: Mono.Android.dll

重要

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

<強力>加護病房增強</強力> 加護病房取代 java.util.Locale了。

[Android.Runtime.Register("android/icu/util/ULocale", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class ULocale : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable

[<Android.Runtime.Register("android/icu/util/ULocale", ApiSince=24, DoNotGenerateAcw=true)>]
type ULocale = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable

繼承: Object

JavaObject

Object
ULocale

屬性: RegisterAttribute

實作: IJavaObject IJavaPeerable ISerializable IComparable IDisposable

備註

<強力>[加護病房增強]</強重> 加護病房取代 java.util.Locale. ICU特有的方法、領域及其他功能標示為「<強力>[重症監護室]</強力>」。

類似的類別 java.util.Locale 提供對ICU協定的額外支援。在 ICU 3.0 中，此類別被強化以支援 RFC 3066 語言識別碼。

ICU 中的許多類別與服務遵循工廠慣用法，工廠方法或物件會以物件回應客戶端請求。請求包含一個區域（請求的區域），回傳的物件是利用該區域的資料建構的。系統可能缺乏所請求地點的資料，此時區域備援機制將被啟動，直到找到已填滿的區域（有效區域）。此外，即使找到有人口的地點（有效地點），仍可能需要進一步的備援才能抵達包含服務所需特定資料的區域（實際區域）。

ULocale 執行 <b'normalization>'</b> 及 <b'canonicalization>'</b> 的地點識別。正規化會「清理」ICU 地區識別碼如下：ul<li 語言、文字、國家、變體及關鍵字正確標示>為 br<（分別為小寫、標題、大寫、大寫及小寫）>/li<>li<作為分隔符的連字號會轉為底線>/li<>li<三字母語言與國家識別碼在可用>時會轉換為兩字母對應的符號/<>li li<的周圍空格則從關鍵字和值中移除><></李><如果>有多個關鍵字，則會依序<排列/li></ul>。標準化還會執行以下操作：<ul><li>POSIX ID 會轉換為 ICU 格式 ID< / li><li>傳統語言標籤（在 BCP 47 中標記為「類型：祖父條款」）會轉換為 ICU 標準形式</li></ul>。所有 ULocale 建構器會自動正規化區域 ID。要處理 POSIX ID，canonicalize可以呼叫將 id 轉換成標準形式，或canonicalInstance呼叫工廠方法。

注意：實際地點會正確回傳，但大多數情況下 有效的地點不會 回傳。

的 android.icu.util.ULocaleJava 檔。

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

建構函式

名稱	Description
ULocale(String, String, String)	從由三個「欄位」a、b、c 組成的 localeID 構建 ULocale。
ULocale(String, String)	為了方便地過載 ULocale（String， String， String）與 Java 相容。
ULocale(String)	<strong>[icu]</strong> 從 RFC 3066 地點 ID 構建 ULocale。

欄位

名稱	Description
PrivateUseExtension	私有使用區域擴展（'x'）的金鑰。
UnicodeLocaleExtension	Unicode 區域擴展（'u'）的金鑰。

屬性

名稱	Description
BaseName	<strong>[icu]</strong> 回傳此位置的（正規化）基底名稱，類似 `#getName()`，但不含關鍵字。
Canada	對國家/地區來說是有用的常數。
CanadaFrench	對國家/地區來說是有用的常數。
CharacterOrientation	<strong>[icu]</strong> 回傳此地點角色的佈局方向。
China	對國家/地區來說是有用的常數。
Chinese	對語言來說是有用的常數。
Class	傳回這個 `Object`的運行時間類別。 (繼承來源 Object)
Country	回傳該地點的國家/地區代碼，可能是空字串或大寫的 ISO 3166 兩字母代碼。
Default	回傳目前預設的 ULocale。
DisplayCountry	回傳該區域的國家，並以預設 `DISPLAY` 區域顯示。
DisplayLanguage	回傳該區域的語言，並以預設 `DISPLAY` 區域顯示。
DisplayLanguageWithDialect	<strong>[icu]</strong> 回傳該區域語言，並以預設 `DISPLAY` 區域顯示。
DisplayName	會回傳這個區域名稱，並以本地化的方式顯示在預設 `DISPLAY` 區域。
DisplayNameWithDialect	<strong>[icu]</strong> 回傳此區域名稱，並以本地化的方式顯示於預設 `DISPLAY` 區域。
DisplayScript	回傳該區域的腳本，並已在預設 `DISPLAY` 區域內顯示。
DisplayVariant	回傳此區域的變體，並以預設 `DISPLAY` 區域在當地顯示。
English	對語言來說是有用的常數。
ExtensionKeys	回傳與此區域相關的擴展鍵集合，若無擴充功能則回傳空鍵。
Fallback	<strong>[icu]</strong> 回傳此區域的備用位置。
France	對國家/地區來說是有用的常數。
French	對語言來說是有用的常數。
German	對語言來說是有用的常數。
Germany	對國家/地區來說是有用的常數。
Handle	基礎Android實例的句柄。 (繼承來源 Object)
ISO3Country	回傳該地點國家/地區的三個字母縮寫。
ISO3Language	回傳一個三字母縮寫，代表該地點的語言。
IsRightToLeft	<strong>[icu]</strong> 回傳該地點的文字是否由右至左書寫。
Italian	對語言來說是有用的常數。
Italy	對國家/地區來說是有用的常數。
Japan	對國家/地區來說是有用的常數。
Japanese	對語言來說是有用的常數。
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
JniPeerMembers	取得用於存取此 Java 綁定成員的 JNI 元資料。
Keywords	<strong>[icu]</strong> 回傳該地點關鍵字的迭代器。
Korea	對國家/地區來說是有用的常數。
Korean	對語言來說是有用的常數。
Language	回傳此區域的語言代碼，該代碼可能是空字串或小寫的 ISO 639 代碼。
LineOrientation	<strong>[icu]</strong> 回傳此地點的線路佈局方向。
Name	<strong>[iccu]</strong> 回傳該地點的（正規化後）全名。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
Prc	對國家/地區來說是有用的常數。
Root	根音：ULocale。
Script	回傳這個區域的腳本程式碼，可能是空字串。
SimplifiedChinese	對語言來說是有用的常數。
Taiwan	對國家/地區來說是有用的常數。
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
TraditionalChinese	對語言來說是有用的常數。
Uk	對國家/地區來說是有用的常數。
UnicodeLocaleAttributes	回傳與該區域相關的 Unicode locale 屬性集合，或若無屬性則回傳空集合。
UnicodeLocaleKeys	回傳由該區域定義的 Unicode 區域鍵集合，若該區域沒有則回傳空鍵。
Us	對國家/地區來說是有用的常數。
Variant	回傳此區域的變體程式碼，可能是空字串。

方法

名稱	Description
AcceptLanguage(String, Boolean[])	<strong>[icu]</strong> 根據 HTTP 格式化的可接受地點清單，決定使用者可用的區域。
AcceptLanguage(String, ULocale[], Boolean[])	<strong>[icu]</strong> 根據 HTTP 格式化的可接受地點清單，決定使用者可用的區域。
AcceptLanguage(ULocale[], Boolean[])	<strong>[icu]</strong> 根據有序的可接受位置陣列，決定使用者可用的位置。
AcceptLanguage(ULocale[], ULocale[], Boolean[])	<strong>[icu]</strong> 根據可接受的地點清單，為使用者決定一個可用的地點。
AddLikelySubtags(ULocale)	<strong>[icu]</strong> 根據以下 CLDR 技術報告中描述的演算法，新增所提供地區 ID 的可能子標籤： `http://www.`
Canonicalize(String)	<strong>[iccu]</strong> 根據指定區域 ID 的 CLDR 回傳典範名稱。
Clone()	這是為了與 Locale 相容——實際上，因為 ULocale 是不可變的，沒有理由複製它，所以這個 API 回傳的是「這個」。
CompareTo(ULocale)	比較兩款 ULocale 以便訂購。
Construct(JniObjectReference, JniObjectReferenceOptions)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
CreateCanonical(String)	<強力>[ICU]</強> 力根據CLDR，先將ID標準化，從而產生一個ULocale。
CreateCanonical(ULocale)	根據 CLDR，先將該地點標準化，從而建立一個 ULocale。
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
Equals(Object)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
Equals(Object)	指出其他物件是否「等於」這個物件。 (繼承來源 Object)
ForLanguageTag(String)	回傳指定的 IETF BCP 47 語言標籤字串的區域。
ForLocale(Locale)	<strong>[iccu]</strong> 回傳一個 ULocale 物件。`java.util.Locale`
GetAvailableLocales()	<strong>[icu] 注意：</strong> 與 Locale API 不同，這裡回傳的 `ULocale`陣列為，而非 `Locale`。
GetAvailableLocalesByType(ULocale+AvailableType)	會回傳依指定類型所安裝的所有地點清單。
GetBaseName(String)	<strong>[icu]</strong> 回傳指定地點的（正規化）基底名稱，類似 `#getName(String)`，但不含關鍵字。
GetCountry(String)	<strong>[icu]</strong> 回傳該地點的國家/地區代碼，可能是空字串或大寫的 ISO 3166 兩字母代碼。
GetDefault(ULocale+Category)	回傳指定類別的目前預設 ULocale。
GetDisplayCountry(String, String)	<strong>[icu]</strong> 回傳當地國家，以便在當地顯示。
GetDisplayCountry(String, ULocale)	<strong>[icu]</strong> 回傳當地國家，以便在當地顯示。
GetDisplayCountry(ULocale)	回傳該地點的國家，並以當地提供地點顯示。
GetDisplayKeyword(String, String)	<strong>[icu]</strong> 回傳一個關鍵字，可在指定地點顯示。
GetDisplayKeyword(String, ULocale)	<strong>[icu]</strong> 回傳一個關鍵字，可在指定地點顯示。
GetDisplayKeyword(String)	<strong>[icu]</strong> 回傳一個關鍵字，可在預設 `DISPLAY` 區域內顯示。
GetDisplayKeywordValue(String, String, String)	<strong>[icu]</strong> 回傳一個關鍵字值，並可在指定地區內顯示。
GetDisplayKeywordValue(String, String, ULocale)	<strong>[icu]</strong> 回傳一個關鍵字值，並可在指定地區內顯示。
GetDisplayKeywordValue(String, ULocale)	<strong>[icu]</strong> 回傳一個關鍵字值，並可在指定地區內顯示。
GetDisplayKeywordValue(String)	<strong>[icu]</strong> 回傳一個關鍵字值，可在預設 `DISPLAY` 區域內顯示。
GetDisplayLanguage(String, String)	<strong>[icu]</strong> 回傳當地語言，並已在當地提供地點顯示。
GetDisplayLanguage(String, ULocale)	<strong>[icu]</strong> 回傳當地語言，並已在當地提供地點顯示。
GetDisplayLanguage(ULocale)	回傳該地點的語言，並以當地語言在當地顯示。
GetDisplayLanguageWithDialect(String, String)	<strong>[icu]</strong> 回傳當地語言，並已在當地提供地點顯示。
GetDisplayLanguageWithDialect(String, ULocale)	<strong>[icu]</strong> 回傳當地語言，並已在當地提供地點顯示。
GetDisplayLanguageWithDialect(ULocale)	<strong>[icu]</strong> 回傳該地點的語言，並本地化並可在所提供地點顯示。
GetDisplayName(String, String)	<strong>[icu]</strong> 回傳當地 ID 以在指定地點顯示。
GetDisplayName(String, ULocale)	<strong>[icu]</strong> 回傳當地 ID 以在指定地點顯示。
GetDisplayName(ULocale)	回傳此地點名稱，並本地化並顯示於所提供的位置。
GetDisplayNameWithDialect(String, String)	<strong>[icu]</strong> 回傳當地 ID 以在指定地點顯示。
GetDisplayNameWithDialect(String, ULocale)	<strong>[icu]</strong> 回傳當地 ID 以在指定地點顯示。
GetDisplayNameWithDialect(ULocale)	<strong>[icu]</strong> 回傳此區域名稱，並本地化並顯示於所提供的位置。
GetDisplayScript(String, String)	<strong>[icu]</strong> 回傳已在當地化的區域腳本，以便在所提供的位置顯示。
GetDisplayScript(String, ULocale)	<strong>[icu]</strong> 回傳已在當地化的區域腳本，以便在所提供的位置顯示。
GetDisplayScript(ULocale)	回傳該區域的腳本，並已在當地化，以便在所提供的區域顯示。
GetDisplayVariant(String, String)	<strong>[icu]</strong> 回傳區域的變體，並已在指定區域內顯示。
GetDisplayVariant(String, ULocale)	<strong>[icu]</strong> 回傳區域的變體，並已在指定區域內顯示。
GetDisplayVariant(ULocale)	回傳該區域的變體，並已在當地提供的位置顯示。
GetExtension(Char)	回傳與指定金鑰相關的擴充（或私人使用）值，若金鑰無相關擴展則為空值。
GetFallback(String)	<strong>[iccu]</strong> 回傳指定區域的備用區域，可能是空字串。
GetHashCode()	傳回此物件的雜湊碼值。 (繼承來源 Object)
GetISO3Country(String)	<strong>[icu]</strong> 回傳一個三個字母的縮寫，代表該地點的國家/地區。
GetISO3Language(String)	<strong>[iccu]</strong> 回傳一個三個字母的縮寫，代表該地點的語言。
GetISOCountries()	回傳ISO 3166中定義的所有兩字母國家代碼清單。
GetISOLanguages()	回傳 ISO 639 中定義的所有唯一語言代碼清單。
GetKeywords(String)	<strong>[icu]</strong> 回傳針對指定地點關鍵字的迭代器。
GetKeywordValue(String, String)	<strong>[icu]</strong> 回傳指定區域內關鍵字的值。
GetKeywordValue(String)	<strong>[icu]</strong> 回傳該地點關鍵字的值。
GetLanguage(String)	回傳區域 ID 的語言代碼，該代碼可能是空字串或小寫的 ISO 639 代碼。
GetName(String)	<strong>[icu]</strong> 回傳指定地區的（正規化）全名。
GetScript(String)	<strong>[icu]</strong> 回傳指定區域的腳本程式碼，可能是空字串。
GetUnicodeLocaleType(String)	回傳與該區域指定 Unicode 區域鍵相關的 Unicode 區域類型。
GetVariant(String)	<strong>[icu]</strong> 回傳指定區域的變體代碼，可能是空字串。
JavaFinalize()	已淘汰. 當垃圾收集決定不再參考物件時，垃圾收集行程在物件上呼叫。 (繼承來源 Object)
MinimizeSubtags(ULocale)	<strong>[icu]</strong> 根據以下 CLDR 技術報告<中描述的演算法，最小化給定地區 ID 的子標籤> `<a href="http://www.unicode.org/reports/tr35/#Likely_Subtags">http://www.unicode.org/reports/tr35/#Likely_Subtags</a></blockquote> If the provided ULocale instance is already in the minimal form, or there is no data available for minimization, it will be returned.`
Notify()	喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object)
NotifyAll()	喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object)
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetKeywordValue(String, String, String)	給定一個區域識別碼、一個關鍵字和一個值，回傳一個新的區域識別碼，並更新了關鍵字和值。
SetKeywordValue(String, String)	<strong>[icu]</strong> 給定一個關鍵字和一個值，回傳一個帶有更新關鍵字和值的新地點。
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToLanguageTag()	回傳一個代表此地點的良好 IETF BCP 47 語言標籤。
ToLegacyKey(String)	<strong>[icu]</strong> 將指定的關鍵字（BCP 47 Unicode 區域擴展鍵或舊有鍵）轉換為舊有鍵。
ToLegacyType(String, String)	<strong>[icu]</strong> 將指定的關鍵字值（BCP 47 Unicode 區域擴展類型，或舊有型別名或型別名）轉換為標準的舊有型別。
ToLocale()	<strong>[iccu]</strong> 將此 ULocale 物件 `java.util.Locale`轉換為。
ToString()	傳回物件的字串表示。 (繼承來源 Object)
ToUnicodeLocaleKey(String)	<strong>[icu]</strong> 將指定的關鍵字（legacy key，或 BCP 47 Unicode locale extension key）轉換為等效的 BCP 47 Unicode 區域擴展鍵。
ToUnicodeLocaleType(String, String)	<strong>[icu]</strong> 將指定的關鍵字值（legacy 類型，或 BCP 47 Unicode locale 擴展類型）轉換為該關鍵字（類別）的良好 BCP 47 Unicode 區域擴展類型。
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	讓目前線程等候直到喚醒為止，通常是藉由em <notified/em>或<em>interrupted</em> 來喚醒它。<> (繼承來源 Object)
Wait(Int64, Int32)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)
Wait(Int64)	讓目前的線程等到喚醒為止，通常是因為 <em>notified</em> 或 <em>interrupted</em>，或直到經過一定數量的實時為止。 (繼承來源 Object)

明確介面實作

名稱	Description
IComparable.CompareTo(Object)	將此物件與指定的物件比較排序。
IJavaPeerable.Disposed()	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.Finalized()	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。 (繼承來源 JavaObject)
IJavaPeerable.UnregisterFromRuntime()	將此實例從執行時的 Java 物件查詢中移除。

擴充方法

名稱	Description
GetJniTypeName(IJavaPeerable)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時間檢查的類型轉換。
JavaCast<TResult>(IJavaObject)	<強力>加護病房增強</強力> 加護病房取代 `java.util.Locale`了。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於