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>
在最简单的形式中，数据集包含一个或多个字段（由一 AutofillId id个字段、一 AutofillValue value个和一个可选筛选器 Pattern regex组成），以及一个或多个 RemoteViews presentations 字段（每个字段可以有自己的 RemoteViews presentation字段，或使用与整个数据集关联的默认值 RemoteViews presentation ）。
当自动填充服务返回数据集 FillResponse 时，屏幕输入集中在至少存在于其中一个数据集的视图中时，Android 系统将显示一个 UI，其中包含 RemoteViews presentation 具有该视图 AutofillId的所有数据集对。 然后，当用户从 UI 中选择数据集时，将自动填充该数据集中的所有视图。
如果当前输入法和自动填充服务都支持内联建议，则可以通过键盘将数据集显示为建议。 若要使用此功能，数据集应包含表示 InlinePresentation 内联建议 UI 的呈现方式。
“FillDialogUI”><h3>填充对话框 UI</h3>
填充对话框 UI 是一个比下拉 UI 更显眼、更高效的界面。 如果用户单击支持填充对话框 UI 的字段时，自动填充建议可用，则自动填充将弹出填充对话框。 对话框将占用更大的区域来显示数据集，因此用户可以轻松注意数据集并选择数据集。 如果用户在提供建议之前关注视图，将回退到下拉 UI 或内联建议。
“身份验证”><h3>数据集身份验证</h3>
在更复杂的形式中，可以保护数据集值，直到用户对数据集进行身份验证& mdash;在这种情况下，当用户选择数据集时，Android 系统会启动服务设置的意向来“解锁”数据集。
例如，当数据集包含信用卡信息（如号码、到期日期和验证码）时，可以提供一个数据集演示文稿，表示“点击进行身份验证”。 然后，当用户点击该选项时，将启动一个活动，要求用户输入信用卡代码，如果用户输入有效的代码，则可以“解锁”数据集。
还可以使用经过身份验证的数据集为用户提供交互式 UI。 例如，如果自动填充的活动是帐户创建屏幕，则可以使用经过身份验证的数据集为用户自动生成随机密码。
有关数据集身份验证机制的更多详细信息，请参阅 Dataset.Builder#setAuthentication(IntentSender) 。
“筛选”><h3>筛选</h3>
自动填充 UI 会根据定位视图的值自动更改显示哪些值，并遵循以下规则： <ol><li>如果视图 android.view.View#getAutofillValue() autofill value 不为或为 AutofillValue#isText() text 空，则显示所有数据集。 <显示具有筛选器正则表达式（设置和Field.Builder#setFilter(Pattern)）的 Dataset.Builder#setField(AutofillId, Field)li>数据集，其正则表达式与转换为小写的视图的文本值匹配。 <>li 数据集不需要身份验证，具有字段值，其AutofillValue#isText() textAutofillValue#getTextValue() value开头为视图文本的小写值。 <li>所有其他数据集均处于隐藏状态。 </老>
适用于 . 的 android.service.autofill.DatasetJava 文档
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。
属性
| 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 通知/em> 或 <em>interrupted</em>。<>< (继承自 Object) |
| Wait(Int64, Int32) |
使当前线程等待直到唤醒，通常是通过 <em>通知</em> 或 <em interrupted</em>>，或直到经过一定数量的实时。 (继承自 Object) |
| Wait(Int64) |
使当前线程等待直到唤醒，通常是通过 <em>通知</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) |
对象 |