Peer.GetObjects 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
從本機快取中，取得對等電腦所註冊之資料物件的集合。
多載
| 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.PeerObjectCollectionPublic Function GetObjects () As PeerObjectCollection傳回
這個執行個體所指定的對等電腦或端點的 PeerObject 集合。
- 屬性
例外狀況
呼叫端未訂閱端點，或尚未呼叫 RefreshData()。
這個方法無法完成，因為基礎對等共同作業基礎結構中發生錯誤。
備註
這項功能只會在類別上 PeerContact 公開。 基於安全性考慮，這項功能不會在其他類型的對等上公開。
如果對等共同作業會話未使用 PermissionState 的 Unrestricted具現化，這個方法就無法存取本機計算機上的物件。 在共同作業會話中註冊的應用程式也是如此。
對等物件的集合包含應用程式、數據物件，以及這個實例所指定之對等或端點的狀態資訊。 如果找不到端點的物件，則會傳回大小為 0 (0) 的集合。 如果呼叫對等已訂閱此端點，則會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。
呼叫端不需要登入共同作業基礎結構，此方法才能順利完成。 在呼叫端先前登入呼叫此方法時，必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。
注意：類別上定義了其他多載， 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 (0) 的集合。 當呼叫對等訂閱此端點時，會自動更新快取;否則 RefreshData 必須在呼叫這個方法之前呼叫。
呼叫端不需要登入共同作業基礎結構，此方法才能順利完成。 在呼叫端先前登入呼叫此方法時，必須已完成呼叫或其中一個Subscribe方法的成功呼叫RefreshData。 呼叫這個方法需要 PermissionState 的 Unrestricted。 當共同作業會話開始時，就會建立此狀態。
注意：類別上會定義其他多載， Peer 而不是衍生類別 PeerContact 和 PeerNearMe。
