Peer.GetObjects 方法

定义

从本地缓存中获取由对等方注册的数据对象的集合。

重载

GetObjects()

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

GetObjects(Guid)

Peer 中获取与提供的 Guid 关联的 PeerObjectCollection 对象。

注解

此功能仅在 类上 PeerContact 公开。 出于安全原因,此功能不会在任何其他类型的对等上公开。

如果未找到终结点的对象,则返回大小为零 (0) 的集合。

GetObjects()

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

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects();
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects ();
[<System.Security.SecurityCritical>]
member this.GetObjects : unit -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects () As PeerObjectCollection

返回

由此实例指定的对等方或终结点的 PeerObject 集合。

属性

例外

调用方未订阅终结点或尚未调用 RefreshData()

此方法因基础对等方协作基础结构中的错误而无法完成。

注解

此功能仅在 类上 PeerContact 公开。 出于安全原因,此功能不会在任何其他类型的对等上公开。

如果对等协作会话未使用 PermissionStateUnrestricted实例化,则此方法无法访问本地计算机上的对象。 注册到协作会话的应用程序也是如此。

对等对象的集合由应用程序、数据对象以及此实例指定的对等或终结点的状态信息组成。 如果未找到终结点的对象,则返回大小为零 (0) 的集合。 如果调用对等方订阅了此终结点,则缓存会自动更新;否则 RefreshData ,必须在调用此方法之前调用 。

调用方无需登录到协作基础结构即可成功完成此方法。 在调用方在调用 RefreshData 此方法之前登录时,必须已完成对 或其中 Subscribe 一个方法的成功调用。

注意:其他重载是在 类上定义的, Peer 而不是子类 PeerContactPeerNearMe

另请参阅

适用于

GetObjects(Guid)

Peer 中获取与提供的 Guid 关联的 PeerObjectCollection 对象。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(Guid objectId);
[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects (Guid objectId);
[<System.Security.SecurityCritical>]
member this.GetObjects : Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection
Public Function GetObjects (objectId As Guid) As PeerObjectCollection

参数

objectId
Guid

Guid Peer要从集合中检索的 对象的 。

返回

与所提供的 Peer 关联的 Guid 对象。 如果未找到对象,则返回一个大小为零 (0) 的集合。

属性

例外

对象 ID 为 null

调用方未订阅 PeerEndPoint 或尚未对其调用 RefreshData()

从对等方获取对象信息时出错。

注解

此功能仅在 类上 PeerContact 公开。 出于安全原因,此功能不会在任何其他类型的对等上公开。

对等对象的集合由应用程序、数据对象以及此实例指定的对等或终结点的状态信息组成。 如果未找到终结点的对象,则返回大小为零 (0) 的集合。 当调用对等方订阅此终结点时,缓存会自动更新;否则 RefreshData ,必须在调用此方法之前调用 。

调用方无需登录到协作基础结构即可成功完成此方法。 在调用方在调用 RefreshData 此方法之前登录时,必须已完成对 或其中 Subscribe 一个方法的成功调用。 调用此方法需要 的 PermissionStateUnrestricted。 此状态是在协作会话开始时创建的。

注意:其他重载是在 类上定义的, Peer 而不是在派生类 PeerContactPeerNearMe上定义的。

另请参阅

适用于