Peer.GetObjects 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
取得節點已從本地快取註冊的資料物件集合。
多載
| 名稱 | Description |
|---|---|
| GetObjects() |
從本地快取取得資料物件的集合。 |
| GetObjects(Guid) |
從 中取得Peer與 所提供的GuidPeerObjectCollection物件相關聯。 |
備註
此功能僅在 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 必須先呼叫，才能呼叫此方法。
呼叫者無需登入協作基礎設施即可成功完成此方法。 成功呼叫RefreshDataSubscribe或其中一個方法必須在呼叫者登入後才呼叫該方法。
注意：額外的重載定義在 Peer 類別上，而非子類別 PeerContact 和 PeerNearMe。
另請參閱
適用於
GetObjects(Guid)
從 中取得Peer與 所提供的GuidPeerObjectCollection物件相關聯。
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 必須先呼叫，才能呼叫此方法。
呼叫者無需登入協作基礎設施即可成功完成此方法。 成功呼叫RefreshDataSubscribe或其中一個方法必須在呼叫者登入後才呼叫該方法。 呼叫此方法需要一個 PermissionState 。Unrestricted 此狀態是在協作會話開始時建立的。
注意：額外的超載定義在 Peer 類別上，而非衍生類別 PeerContact 和 PeerNearMe。
