Peer.GetObjects 方法

定义

命名空间:

System.Net.PeerToPeer.Collaboration

程序集:

System.Net.dll

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

重载

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

返回

PeerObjectCollection

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

属性

SecurityCriticalAttribute

例外

InvalidOperationException

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

PeerToPeerException

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

注解

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

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

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

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

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

另请参阅

• RefreshDataAsync(Object)
• RequestCachePolicy

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

GuidPeer要从集合中检索的 对象的 。

返回

PeerObjectCollection

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

属性

SecurityCriticalAttribute

例外

ArgumentNullException

对象 ID 为 null。

InvalidOperationException

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

PeerToPeerException

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

注解

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

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

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

注意：其他重载是在 类上定义的， Peer 而不是在派生类 PeerContact 和 PeerNearMe上定义的。

另请参阅

• GetApplications
• Guid
• RefreshDataAsync(Object)