Peer.GetObjects 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
从本地缓存中获取由对等方注册的数据对象的集合。
重载
| 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.PeerObjectCollectionPublic Function GetObjects () As PeerObjectCollection返回
由此实例指定的对等方或终结点的 PeerObject 集合。
- 属性
例外
调用方未订阅终结点或尚未调用 RefreshData()。
此方法因基础对等方协作基础结构中的错误而无法完成。
注解
此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。
如果对等协作会话未使用 PermissionState 的 Unrestricted实例化，则此方法无法访问本地计算机上的对象。 注册到协作会话的应用程序也是如此。
对等对象的集合由应用程序、数据对象以及此实例指定的对等或终结点的状态信息组成。 如果未找到终结点的对象，则返回大小为零 (0) 的集合。 如果调用对等方订阅了此终结点，则缓存会自动更新;否则 RefreshData ，必须在调用此方法之前调用 。
调用方无需登录到协作基础结构即可成功完成此方法。 在调用方在调用 RefreshData 此方法之前登录时，必须已完成对 或其中 Subscribe 一个方法的成功调用。
注意：其他重载是在 类上定义的， Peer 而不是子类 PeerContact 和 PeerNearMe。
另请参阅
适用于
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.PeerObjectCollectionPublic Function GetObjects (objectId As Guid) As PeerObjectCollection参数
返回
与所提供的 Peer 关联的 Guid 对象。 如果未找到对象，则返回一个大小为零 (0) 的集合。
- 属性
例外
对象 ID 为 null。
调用方未订阅 PeerEndPoint 或尚未对其调用 RefreshData()。
从对等方获取对象信息时出错。
注解
此功能仅在 类上 PeerContact 公开。 出于安全原因，此功能不会在任何其他类型的对等上公开。
对等对象的集合由应用程序、数据对象以及此实例指定的对等或终结点的状态信息组成。 如果未找到终结点的对象，则返回大小为零 (0) 的集合。 当调用对等方订阅此终结点时，缓存会自动更新;否则 RefreshData ，必须在调用此方法之前调用 。
调用方无需登录到协作基础结构即可成功完成此方法。 在调用方在调用 RefreshData 此方法之前登录时，必须已完成对 或其中 Subscribe 一个方法的成功调用。 调用此方法需要 的 PermissionStateUnrestricted。 此状态是在协作会话开始时创建的。
注意：其他重载是在 类上定义的， Peer 而不是在派生类 PeerContact 和 PeerNearMe上定义的。
