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 或内联建议。
“身份验证”><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() text ，其 AutofillValue#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 <通知/em> 或 <em>interrupted</em>。<> (继承自 Object) |
| Wait(Int64) |
导致当前线程等待，直到它被唤醒，通常是通过 em <通知/em> 或 <em>interrupted</em>，或直到经过一定数量的实时。<> (继承自 Object) |
| Wait(Int64, Int32) |
导致当前线程等待，直到它被唤醒，通常是通过 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) |
对象 |