PeerContact 类

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

表示用户已检索其扩展信息的对等方。

public ref class PeerContact : System::Net::PeerToPeer::Collaboration::Peer, IEquatable<System::Net::PeerToPeer::Collaboration::PeerContact ^>, System::Runtime::Serialization::ISerializable

[System.Serializable]
public class PeerContact : System.Net.PeerToPeer.Collaboration.Peer, IEquatable<System.Net.PeerToPeer.Collaboration.PeerContact>, System.Runtime.Serialization.ISerializable

[<System.Serializable>]
type PeerContact = class
    inherit Peer
    interface IEquatable<PeerContact>
    interface ISerializable

Public Class PeerContact
Inherits Peer
Implements IEquatable(Of PeerContact), ISerializable

继承

Object

Peer

PeerContact

属性

SerializableAttribute

实现

IEquatable<PeerContact> ISerializable

注解

联系人表示受信任的对等方。 PeerContact当远程对等方超出“人员近我”范围时，必须为远程对等方或PeerNearMe用户创建对象以与远程对等方协作。 对象 PeerContact 可以作为在远程计算机上运行的应用程序或远程计算机的用户存在。 可以将此类的实例添加到 以 ContactManager 持久方式存储联系人信息的 。

来自 PeerContact 的应用程序邀请已经过身份验证和加密。 用于接受或拒绝来自对等联系人的邀请的 UI 对话框还指示邀请者受信任。

订阅 PeerContact 对象意味着远程对等方可以查看其注册的应用程序、对象和状态信息。 若要订阅 ， PeerContact调用方必须通过 SignIn Windows UI 登录到对等协作基础结构，或通过 Windows UI 登录。 所有其他操作不需要登录。

构造函数

PeerContact(SerializationInfo, StreamingContext)

不为此类定义公共构造函数。

属性

Credentials	获取或设置由此 PeerContact 实例标识的对等方的 X509Certificate（公钥）。
DisplayName	获取或设置一个字符串，该字符串表示 PeerContact 的显示名称。
EmailAddress	获取或设置与 PeerContact 关联的电子邮件地址。
IsOnline	获取一个值，该值指定 Peer 当前是否处于“联机状态”。 (继承自 Peer)
IsSubscribed	获取或设置一个值，该值指定当前 PeerContact 是已订阅终结点，还是已取消对终结点的订阅。 此属性还会获取或设置另一个值，该值指定当前对等主机或宿主应用程序是已订阅此 PeerContact，还是已取消对它的订阅。
Nickname	获取或设置一个字符串，该字符串表示 PeerContact 的 Nickname。
PeerEndPoints	获取与此 PeerEndPointCollection 关联的 PeerContact。
PeerName	获取或设置与 PeerName 关联的 PeerContact。
SubscribeAllowed	获取或设置一个值，该值指定是否将 PeerContact 公开给特定的协作事件，这些事件与拥有此 ContactManager 对象所驻留的 PeerContact 的对等方或应用程序关联。
SynchronizingObject	设置此属性值后，将在创建特定 SynchronizingObject 的线程上为因异步操作而未激发的所有事件回调关联的事件处理程序。 (继承自 Peer)

方法

Dispose()	释放由 Peer 对象使用的所有资源。 (继承自 Peer)
Dispose(Boolean)	释放非托管资源，并（可选）释放由 PeerApplication 对象占用的托管资源。
Equals(Object)	将 PeerContact 实例与指定对象进行比较。
Equals(Object, Object)	确定指定的 PeerContact 实例是否可视为相等的实例。
Equals(Peer)	对当前的 Peer 和指定对等方执行区分大小写的比较。 (继承自 Peer)
Equals(PeerContact)	将 PeerContact 与指定的 PeerContact 实例进行比较。
FromXml(String)	基于提供的 XML 数据创建一个 PeerContact 实例。
GetApplications()	检索远程对等方在本地缓存中注册的 PeerApplication 对象。
GetApplications(Guid)	从本地缓存中获取具有指定 PeerApplication 的 Guid 对象的集合。
GetApplications(PeerEndPoint)	获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。
GetApplications(PeerEndPoint, Guid)	获取与指定 PeerApplicationCollection 关联的 PeerEndPoint。
GetHashCode()	返回 PeerContact 实例的哈希代码。
GetObjectData(SerializationInfo, StreamingContext)	使用序列化 PeerContact 时所需的数据填充 SerializationInfo 对象。
GetObjects()	从本地缓存中获取数据对象的集合。 (继承自 Peer)
GetObjects(Guid)	从 Peer 中获取与提供的 Guid 关联的 PeerObjectCollection 对象。 (继承自 Peer)
GetObjects(PeerEndPoint)	获取由指定 PeerObjectCollection 注册并存储在本地缓存中的 PeerEndPoint。
GetObjects(PeerEndPoint, Guid)	获取指定的 PeerEndPoint 在由指定 PeerApplication 标识的 Guid 中注册的对等对象的集合。
GetPresenceInfo(PeerEndPoint)	获取 PeerEndPoint 的可用状态信息。 (继承自 Peer)
GetType()	获取当前实例的 Type。 (继承自 Object)
Invite()	发送加入由发送方发起的对等方协作的邀请。
Invite(PeerApplication, String, Byte[])	发送加入由发送方发起的指定 PeerApplication 的指定邀请。
Invite(PeerEndPoint)	向特定终结点发送邀请，以使之加入与邀请发送方之间的对等方协作。
Invite(PeerEndPoint, PeerApplication, String, Byte[])	向指定 PeerEndPoint 发送指定的邀请，以使之加入由发送方发起的指定 PeerCollaboration 应用程序。
InviteAsync(Object)	为一个终结点开始一个异步邀请操作，以加入由邀请的发件人赞助的 PeerCollaboration 应用程序。 使用指定的 Object 标识邀请。
InviteAsync(PeerApplication, String, Byte[], Object)	为指定的对等终结点开始异步邀请操作，以加入由邀请的发件人赞助的指定协作 PeerApplication。
InviteAsync(PeerEndPoint, Object)	为指定的对等终结点开始异步邀请操作，以加入由邀请的发件人赞助的 PeerCollaboration 应用程序。 使用指定的 Object 标识邀请。
InviteAsync(PeerEndPoint, String, Byte[], PeerApplication, Object)	为指定的 peerEndPoint 开始一个异步邀请操作，以加入由邀请的发件人赞助的指定协作 PeerApplication。
InviteAsyncCancel(Object)	取消使用 InviteAsync(PeerApplication, String, Byte[], Object) 方法发送的邀请。 (继承自 Peer)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnApplicationChanged(ApplicationChangedEventArgs)	引发 ApplicationChanged 事件。
OnInviteCompleted(InviteCompletedEventArgs)	引发 InviteCompleted 事件。 (继承自 Peer)
OnObjectChanged(ObjectChangedEventArgs)	当远程对等添加、更新或删除 PeerObject 时将引发 ObjectChanged 事件。
OnPresenceChanged(PresenceChangedEventArgs)	当对等的 PeerPresenceInfo 发生更改时，引发 PresenceChanged 事件。
OnSubscribeCompleted(SubscribeCompletedEventArgs)	引发 SubscribeCompleted 事件。
Subscribe()	订阅 PeerContact 的调用对等方，这样对等方就可接收此后所有与 PeerContact 相关联的 PeerCollaboration 事件。
SubscribeAsync(Object)	异步订阅调用对等方到 PeerContact，这样对等方就可接收此后与 PeerContact 相关联的 PeerCollaboration 事件。
ToString()	返回与 String 关联的 DisplayName 的 PeerContact 表示形式。
ToXml()	将 PeerContact 序列化为一个 XML 字符串，以供持久存储或网络传输时使用。
Unsubscribe()	删除对 PeerContact 的订阅，其结果为调用对等方不再接收与 PeerContact 关联的 PeerCollaboration 事件。

事件

ApplicationChanged	只要与 PeerContact 关联的应用程序发生更改，就会引发此事件。
InviteCompleted	在完成对远程对等方的邀请过程时引发。 (继承自 Peer)
ObjectChanged	只要与 PeerObject 关联的 PeerContact 发生更改，就会发出此事件信号。
PresenceChanged	只要 PeerContact 的状态发生更改，就会引发此事件。
SubscribeCompleted	在完成订阅操作时引发。

显式接口实现

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

实现 ISerializable 接口，并返回序列化 PeerContact 实例所需的数据。

另请参阅

• ContactManager
• PeerScope