語言

AbstractPreferences.ChildSpi(String) 方法

定義

回傳該偏好節點的命名子節點,若尚未存在則建立該節點。

[Android.Runtime.Register("childSpi", "(Ljava/lang/String;)Ljava/util/prefs/AbstractPreferences;", "GetChildSpi_Ljava_lang_String_Handler")]
protected abstract Java.Util.Prefs.AbstractPreferences? ChildSpi(string? name);
[<Android.Runtime.Register("childSpi", "(Ljava/lang/String;)Ljava/util/prefs/AbstractPreferences;", "GetChildSpi_Ljava_lang_String_Handler")>]
abstract member ChildSpi : string -> Java.Util.Prefs.AbstractPreferences

參數

name
String

相對於這個偏好節點,要回傳的子節點名稱。

傳回

命名子節點。

屬性

備註

回傳該偏好節點的命名子節點,若尚未存在則建立該節點。 它保證 name 非空、非空、不含斜杠('/'),且長度不超過 #MAX_NAME_LENGTH 字元數。 此外,可以保證這個節點尚未被移除。 (實作者不需要檢查這些細節。)

最後,可以保證該命名節點在先前呼叫此方法 #getChild(String) 或上次移除後未被回傳。 換句話說,快取值總是優先使用,而非呼叫此方法。 子類別不必保留自己先前回傳子的快取。

實作者必須確保回傳的節點尚未被移除。 若先前移除了該節點的同名子節點,實作者必須回傳一個新建 AbstractPreferences 構的節點;一旦移除,該 AbstractPreferences 節點就無法被「復活」。

若此方法導致建立節點,該節點在該 flush 節點或其祖先(或後代)被呼叫前,無法保證該節點持續存在。

此方法在該節點鎖定狀態下被呼叫。

Java 文件 java.util.prefs.AbstractPreferences.childSpi(java.lang.String)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品,並依授權條款所描述的使用進行修改。

適用於