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>
在最簡單的形式中，數據集包含一或多個字段， (由 、a 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>
在更複雜的形式中，數據集值可以受到保護，直到使用者驗證數據集&mdash 為止;在此情況下，當使用者選取數據集時，Android 系統會啟動服務設定為「解除鎖定」數據集的意圖。
例如，當數據集包含信用卡資訊 (例如號碼、到期日和驗證碼) 時，您可以提供數據集簡報，指出「點選進行驗證」。 然後當使用者點選該選項時，您會啟動活動，要求使用者輸入信用卡碼，如果使用者輸入有效的代碼，您可以接著「解除鎖定」數據集。
您也可以使用已驗證的數據集來為使用者提供互動式 UI。 例如，如果自動填入的活動是帳戶建立畫面，您可以使用已驗證的數據集來自動為用戶產生隨機密碼。
如需數據集驗證機制的詳細資訊，請參閱 Dataset.Builder#setAuthentication(IntentSender) 。
篩選“><h3>篩選</h3>
自動填入UI會自動根據錨定檢視的值來變更其顯示的值，並遵循下列規則：<ol<>li>如果檢視的 android.view.View#getAutofillValue() autofill value 不是AutofillValue#isText() text或空白，則會顯示所有數據集。 <顯示篩選 regex (設定Field.Builder#setFilter(Pattern)為 Dataset.Builder#setField(AutofillId, Field)) 且 regex 符合轉換成小寫之檢視文字值的 li>數據集。 <li>數據集不需要驗證、具有域值，其AutofillValue#isText() textAutofillValue#getTextValue() value開頭為檢視文字小寫值的欄位值。 <li>所有其他數據集都會隱藏。 </老>
的 android.service.autofill.DatasetJava 檔。
此頁面的部分是根據 原始碼專案所建立和共用的工作進行修改，並根據 中所述的詞彙使用。
屬性
| Class |
傳回這個 |
| Creator |
|
| Handle |
基礎Android實例的句柄。 (繼承來源 Object) |
| JniIdentityHashCode |
|
| JniPeerMembers |
|
| PeerReference |
|
| ThresholdClass |
此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 Object) |
| ThresholdType |
此 API 支援 Mono for Android 基礎結構，並不適合直接從您的程式代碼使用。 (繼承來源 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) |
讓目前的線程等到喚醒為止，通常是<透過em>notified</em或em>interrupted</em>>，或<直到經過一定數量的實時為止。 (繼承來源 Object) |
| Wait(Int64, Int32) |
讓目前的線程等到喚醒為止，通常是<透過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) |
|