Dataset 類別
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
Dataset
物件代表用來自動填入畫面部分的欄位群組(索引鍵/值組)。
[Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)]
public sealed class Dataset : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/service/autofill/Dataset", ApiSince=26, DoNotGenerateAcw=true)>]
type Dataset = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 繼承
- 屬性
- 實作
備註
Dataset
物件代表用來自動填入畫面部分的欄位群組(索引鍵/值組)。
如需自動填入工作流程中數據集角色的詳細資訊,請參閱建置自動填入服務和 <a href="/reference/android/service/autofill/AutofillService">AutofillService</a>
檔。
“BasicUsage”><h3>基本用法</h3>
以最簡單的形式,數據集包含一或多個字段(由、、 AutofillValue value
和 選擇性篩選Pattern regex
所組成AutofillId id
],以及這些欄位的一或多個RemoteViews presentations
欄位(每個字位可以有自己的RemoteViews presentation
欄位,或使用與整個數據集相關聯的預設值RemoteViews presentation
)。
當自動填入服務傳回 中的 FillResponse
數據集,且螢幕輸入焦點放在至少存在於其中一個數據集的檢視中時,Android 系統會顯示 UI,其中包含 RemoteViews presentation
具有該檢視 AutofillId
的所有數據集組。 然後,當使用者從UI選取數據集時,該數據集中的所有檢視都會自動填入。
如果目前的輸入法和自動填入服務都支援內嵌建議,鍵盤就可以將數據集顯示為建議。 若要使用這項功能,數據集應該包含 , InlinePresentation
代表內嵌建議 UI 的呈現方式。
“FillDialogUI”><h3>填滿對話框 UI</h3>
填滿對話框 UI 比下拉式 UI 更顯眼且有效率的介面。 如果使用者按兩下支援填入對話框UI的欄位時,可以使用自動填滿建議,則自動填滿將會快顯填滿對話框。 對話框會佔用較大的區域來顯示數據集,因此使用者可以輕鬆地注意數據集並選取數據集。 如果使用者將焦點放在建議可用之前檢視,將會回復到下拉式 UI 或內嵌建議。
“Authentication”><h3>數據集驗證</h3>
在更複雜的形式中,數據集值可以受到保護,直到使用者驗證數據集—在此情況下,當使用者選取數據集時,Android 系統會啟動服務所設定的意圖,以「解除鎖定」數據集。
例如,當數據集包含信用卡資訊時(例如號碼、到期日和驗證碼),您可以提供數據集簡報,指出「點選進行驗證」。 然後,當使用者點選該選項時,您會啟動活動,要求使用者輸入信用卡代碼,如果使用者輸入有效的代碼,您可以「解除鎖定」數據集。
您也可以使用已驗證的數據集來為使用者提供互動式 UI。 例如,如果自動填入的活動是帳戶建立畫面,您可以使用已驗證的數據集自動為用戶產生隨機密碼。
如需資料集驗證機制的詳細資訊,請參閱 Dataset.Builder#setAuthentication(IntentSender)
。
篩選“><h3>篩選</h3>
自動填滿 UI 會根據錨定它的值自動變更顯示的值,並遵循下列規則:<ol<>li>如果檢視android.view.View#getAutofillValue() autofill value
的 不是AutofillValue#isText() text
或空白,則會顯示所有數據集。 <具有篩選 regex 的 li>數據集(設定為 Field.Builder#setFilter(Pattern)
和 Dataset.Builder#setField(AutofillId, Field)
),且其 regex 符合轉換成小寫之檢視的文字值。 <li>數據集不需要驗證,具有域值,其AutofillValue#isText() text
AutofillValue#getTextValue() value
開頭為檢視文字小寫值。 <li>所有其他數據集都會隱藏。 </老>
的 android.service.autofill.Dataset
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。
屬性
Class |
傳回這個 |
Creator |
|
Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
JniIdentityHashCode |
|
JniPeerMembers |
|
PeerReference |
|
ThresholdClass |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 (繼承來源 Object) |
ThresholdType |
此 API 支援適用於 Android 的 Mono 基礎結構,並不適合直接從您的程式代碼使用。 (繼承來源 Object) |
方法
Clone() |
建立並傳回這個 對象的複本。 (繼承來源 Object) |
DescribeContents() |
|
Dispose() |
|
Dispose(Boolean) |
|
Equals(Object) |
指出其他物件是否「等於」這個物件。 (繼承來源 Object) |
GetHashCode() |
傳回此物件的雜湊碼值。 (繼承來源 Object) |
JavaFinalize() |
當垃圾收集決定不再參考物件時,垃圾收集行程在 物件上呼叫。 (繼承來源 Object) |
Notify() |
喚醒正在等候此物件監視器的單一線程。 (繼承來源 Object) |
NotifyAll() |
喚醒正在等候此物件監視器的所有線程。 (繼承來源 Object) |
SetHandle(IntPtr, JniHandleOwnership) |
設定 Handle 屬性。 (繼承來源 Object) |
ToArray<T>() |
|
ToString() |
傳回物件的字串表示。 (繼承來源 Object) |
UnregisterFromRuntime() |
|
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) |
WriteToParcel(Parcel, ParcelableWriteFlags) |
|
明確介面實作
IJavaPeerable.Disposed() |
|
IJavaPeerable.DisposeUnlessReferenced() |
|
IJavaPeerable.Finalized() |
|
IJavaPeerable.JniManagedPeerState |
|
IJavaPeerable.SetJniIdentityHashCode(Int32) |
|
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
|
IJavaPeerable.SetPeerReference(JniObjectReference) |
|
擴充方法
JavaCast<TResult>(IJavaObject) |
執行 Android 執行時間檢查的類型轉換。 |
JavaCast<TResult>(IJavaObject) |
|
GetJniTypeName(IJavaPeerable) |
|