Peer.GetObjects 方法

定義

命名空間:

System.Net.PeerToPeer.Collaboration

組件:

System.Net.dll

從本機快取中，取得對等電腦所註冊之資料物件的集合。

多載

GetObjects()	取得本機快取中資料物件的集合。
GetObjects(Guid)	從 Peer 中，取得與提供的 Guid 相關聯的 PeerObjectCollection 物件。

備註

這項功能只會在類別上 PeerContact 公開。 基於安全性考慮，這項功能不會在其他類型的對等上公開。

如果找不到端點的物件，則會傳回大小為 0 (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 (0) 的集合。 如果呼叫對等已訂閱此端點，則會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。

呼叫端不需要登入共同作業基礎結構，此方法才能順利完成。 在呼叫端先前登入呼叫此方法時，必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。

注意：類別上定義了其他多載， 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

Peer要Guid從集合中擷取之物件的 。

傳回

PeerObjectCollection

與提供的 Peer 相關聯的 Guid。 如果找不到物件，就會傳回大小為零 (0) 的集合。

屬性

SecurityCriticalAttribute

例外狀況

ArgumentNullException

物件 ID 為 null。

InvalidOperationException

呼叫端未訂閱 PeerEndPoint，或尚未對它呼叫 RefreshData()。

PeerToPeerException

從對等電腦擷取物件資訊時發生錯誤。

備註

這項功能只會在類別上 PeerContact 公開。 基於安全性考慮，這項功能不會在其他類型的對等上公開。

對等物件的集合包含應用程式、數據物件，以及這個實例所指定之對等或端點的狀態資訊。 如果找不到端點的物件，則會傳回大小為 0 (0) 的集合。 當呼叫對等訂閱此端點時，會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。

呼叫端不需要登入共同作業基礎結構，此方法才能順利完成。 在呼叫端先前登入呼叫此方法時，必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。 呼叫這個方法需要 PermissionState 的 Unrestricted。 當共同作業會話開始時，就會建立此狀態。

注意：類別上會定義其他多載， Peer 而不是衍生類別 PeerContact 和 PeerNearMe。

另請參閱

• GetApplications
• Guid
• RefreshDataAsync(Object)