PeerContact.GetObjects 方法

定義

命名空間:: System.Net.PeerToPeer.Collaboration

組件:: System.Net.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

從本地快取取得對等物件的集合。

多載

名稱	Description
GetObjects(PeerEndPoint)	會依指定PeerObjectCollection方式註冊PeerEndPoint並儲存在本地快取中。
GetObjects(PeerEndPoint, Guid)	取得由指定 PeerEndPoint 對象註冊且註冊於 PeerApplication 指定 Guid對象的對等物件集合。

GetObjects(PeerEndPoint)

會依指定PeerObjectCollection方式註冊PeerEndPoint並儲存在本地快取中。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects(System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint);

[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection

Public Function GetObjects (peerEndPoint As PeerEndPoint) As PeerObjectCollection

參數

peerEndPoint: PeerEndPoint

取回物件的端點。

傳回

PeerObjectCollection

與 PeerObjectCollection 指定的 PeerEndPoint相關聯。若終端點無相關應用，則回傳大小為零（0）的集合。

屬性: SecurityCriticalAttribute

例外狀況

ArgumentNullException

PeerEndPoint 不可以是 null。

InvalidOperationException

呼叫的對等端並未訂閱與 PeerContact相關聯的 PeerEndPoint 。
呼叫的對等端尚未呼叫該 RefreshData() 方法。

PeerToPeerException

無法完成 GetObjects 運作。

備註

若呼叫的對等端未訂閱與指定PeerContact PeerEndPoint方法相關的，RefreshData則必須先呼叫該方法。

雖然呼叫者不必登入協作基礎設施才能成功完成，但成功呼叫或RefreshData Subscribe其中一個方法必須在呼叫者先前登入時完成。

給呼叫者的注意事項

額外的重載定義在 Peer 類別上，而非子類別 PeerContact 和 PeerNearMe。

呼叫此方法需要一個 PermissionState 。Unrestricted 此狀態是在對等協作會話開始時建立的。

另請參閱

適用於

GetObjects(PeerEndPoint, Guid)

取得由指定 PeerEndPoint 對象註冊且註冊於 PeerApplication 指定 Guid對象的對等物件集合。

public:
 System::Net::PeerToPeer::Collaboration::PeerObjectCollection ^ GetObjects(System::Net::PeerToPeer::Collaboration::PeerEndPoint ^ peerEndPoint, Guid objectId);

[System.Security.SecurityCritical]
public System.Net.PeerToPeer.Collaboration.PeerObjectCollection GetObjects(System.Net.PeerToPeer.Collaboration.PeerEndPoint peerEndPoint, Guid objectId);

[<System.Security.SecurityCritical>]
override this.GetObjects : System.Net.PeerToPeer.Collaboration.PeerEndPoint * Guid -> System.Net.PeerToPeer.Collaboration.PeerObjectCollection

Public Function GetObjects (peerEndPoint As PeerEndPoint, objectId As Guid) As PeerObjectCollection

參數

peerEndPoint: PeerEndPoint