PeerContact.GetObjects 方法

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

从本地缓存中获取对等对象的集合。

重载

GetObjects(PeerEndPoint)	获取由指定 PeerObjectCollection 注册并存储在本地缓存中的 PeerEndPoint。
GetObjects(PeerEndPoint, Guid)	获取指定的 PeerEndPoint 在由指定 PeerApplication 标识的 Guid 中注册的对等对象的集合。

GetObjects(PeerEndPoint)

获取由指定 PeerObjectCollection 注册并存储在本地缓存中的 PeerEndPoint。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);

[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection

Public Function GetObjects (peerEndPoint As PeerEndPoint) As PeerObjectCollection

参数

peerEndPoint

PeerEndPoint

要从中检索对象的终结点。

返回

PeerObjectCollection

与指定 PeerObjectCollection 关联的 PeerEndPoint。 如果没有与该终结点关联的应用程序，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint 不能为 null。

InvalidOperationException

• 调用对等方未订阅与 PeerContactPeerEndPoint关联的 。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetObjects 操作。

注解

如果调用对等方未订阅与 PeerContact 指定的 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用 方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

调用方说明

其他重载是在 类上定义的， Peer 而不是子类 PeerContact 和 PeerNearMe。

调用此方法需要 PermissionState 的 Unrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• PeerChangeType
• PeerScope

GetObjects(PeerEndPoint, Guid)

获取指定的 PeerEndPoint 在由指定 PeerApplication 标识的 Guid 中注册的对等对象的集合。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, Guid objectId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, Guid objectId);

[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint * Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection

Public Function GetObjects (peerEndPoint As PeerEndPoint, objectId As Guid) As PeerObjectCollection

参数

peerEndPoint

PeerEndPoint

要从中检索对象的终结点。

objectId

Guid

要检索的 Guid 的 PeerObject。

返回

PeerObjectCollection

与指定 PeerObjectCollection 关联的 PeerEndPoint。 如果没有与该终结点关联的应用程序，则返回一个大小为零 (0) 的集合。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerEndPoint 不能为 null。

InvalidOperationException

• 调用对等方未订阅 PeerEndPoint。

• 调用对等方尚未调用 RefreshData() 方法。

PeerToPeerException

无法完成 GetObjects 操作。

注解

如果调用对等方未订阅与 PeerContact 指定的 PeerEndPointRefreshData 关联的 ，则必须在调用此方法之前调用 方法。

虽然调用方无需登录到协作基础结构即可成功完成此方法，但对 或方法之Subscribe一的成功调用RefreshData必须在调用方之前登录时完成。

调用方说明

其他重载是在 类上定义的， Peer 而不是子类 PeerContact 和 PeerNearMe。

调用此方法需要 PermissionState 的 Unrestricted。 此状态是在对等协作会话开始时创建的。

另请参阅

• PeerChangeType
• PeerScope