ABAddressBook 类

定义

命名空间:

AddressBook

程序集:

Xamarin.iOS.dll

提供对系统通讯簿的访问。

[ObjCRuntime.Deprecated(ObjCRuntime.PlatformName.iOS, 9, 0, ObjCRuntime.PlatformArchitecture.None, "Use the 'Contacts' API instead.")]
public class ABAddressBook : IDisposable, ObjCRuntime.INativeObject, System.Collections.Generic.IEnumerable<AddressBook.ABRecord>

type ABAddressBook = class
    interface INativeObject
    interface IDisposable
    interface seq<ABRecord>
    interface IEnumerable

继承

Object

ABAddressBook

属性

DeprecatedAttribute

实现

INativeObject IEnumerable<ABRecord> IEnumerable IDisposable

注解

通讯簿是一个集中式数据库，用于存储联系人（如人员和企业）的信息。 还支持包含一个或多个联系人的“组”概念。 ABAddressBook 支持：

• 管理通讯簿： ABAddressBook()、 HasUnsavedChanges、 Save()、 Revert()。
• 访问通讯簿： RequestAccess(Action<Boolean,NSError>)。
• 管理通讯簿记录：Add(ABRecord)、、Remove(ABRecord)、PeopleCount、GetPerson(Int32)GetPeopleWithName(String)、GroupCount、GetGroups(ABRecord)、GetGroup(Int32)、 。 IEnumerable.GetEnumerator()
• 更改通知 ExternalChange。
• 本地化文本： LocalizedLabel(NSString)。

构造函数

ABAddressBook()

开发人员不应使用此已弃用的构造函数。 开发人员应改用静态 Create 方法

字段

ErrorDomain

标识对通讯簿错误进行分组的错误域。

属性

GroupCount	获取通讯簿中的组数。
Handle	处理指向非托管对象表示形式的 (指针) 。
HasUnsavedChanges	指示此实例是否有尚未保存到全局通讯簿的更改。
PeopleCount	获取通讯簿中的记录数 ABPerson 。

方法

Add(ABRecord)	将记录添加到通讯簿。
Create(NSError)	提供对系统通讯簿的访问。
Dispose()	释放 ABAddressBook 对象使用的资源。
Dispose(Boolean)	释放 ABAddressBook 对象使用的资源。
Finalize()	ABAddressBook 对象的终结器
GetAllSources()	返回系统上可用的所有 addresbook 源。
GetAuthorizationStatus()	用户允许应用拥有哪些权限。
GetDefaultSource()	返回系统的默认通讯簿源。
GetEnumerator()	返回一个枚举器，该枚举器循环访问通讯簿中的所有记录和组。
GetGroup(Int32)	返回 ABGroup 具有给定记录 ID 的 。
GetGroups()	获取通讯簿中的所有组。
GetGroups(ABRecord)	提供对系统通讯簿的访问。
GetPeople()	获取通讯簿中的所有人员。
GetPeople(ABRecord)	提供对系统通讯簿的访问。
GetPeople(ABRecord, ABPersonSortBy)	提供对系统通讯簿的访问。
GetPeopleWithName(String)	获取包含 ABPerson 名称匹配的所有记录的所有数组。
GetPerson(Int32)	返回 ABPerson 具有给定记录 ID 的 。
GetSource(Int32)	返回特定的通讯簿源
LocalizedLabel(NSString)	将记录属性标签本地化为当前 UI 语言。
OnExternalChange(ExternalChangeEventArgs)	引发 ExternalChange 事件。
Remove(ABRecord)	从通讯簿中删除记录。
RequestAccess(Action<Boolean,NSError>)	向用户提供一个标准权限对话框，请求访问通讯簿。
Revert()	放弃对通讯簿的未保存更改。
Save()	将当前实例所做的未保存更改保存到全局通讯簿数据库。

事件

ExternalChange

修改通讯簿时发生。

显式接口实现

IEnumerable.GetEnumerator()

返回一个枚举器，该枚举器循环访问通讯簿中的所有记录和组。