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 登入對等共同作業基礎結構。 所有其他作業都不需要登入。

建構函式

PeerContact(SerializationInfo, StreamingContext)

這個類別沒有定義任何公用建構函式。

屬性

Credentials	取得或設定由這個 PeerContact 執行個體所識別之對等電腦的 X509Certificate (公開金鑰 (Public Key))。
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)	釋放 Unmanaged 資源，並選擇性釋放 PeerApplication 物件所使用的 Managed 資源。
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 字串，以便用於持續性儲存體 (Persistent Storage) 或網路傳輸。
Unsubscribe()	移除 PeerContact 的訂閱，使呼叫的對等不會再收到與 PeerContact關聯的 PeerCollaboration 事件。

事件

ApplicationChanged	與 PeerContact 相關聯的應用程式變更時，就會引發這個事件。
InviteCompleted	當遠端對等電腦的邀請程序完成時引發。 (繼承來源 Peer)
ObjectChanged	與 PeerObject 相關聯的 PeerContact 變更時，這個事件就會收到信號。
PresenceChanged	當 PeerContact 變更狀態時，就會引發這個事件。
SubscribeCompleted	訂閱作業完成時引發。

明確介面實作

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

實作 ISerializable 介面，並傳回序列化 PeerContact 執行個體所需的資料。

另請參閱

• ContactManager
• PeerScope