PeerContact.GetObjects 方法

定義

命名空間:

System.Net.PeerToPeer.Collaboration

組件:

System.Net.dll

取得本機快取中對等物件的集合。

多載

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 則必須在呼叫這個方法之前呼叫方法。

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

給呼叫者的注意事項

類別上會定義其他多載， Peer 而不是子類別 PeerContact 和 PeerNearMe。

呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時，就會建立此狀態。

另請參閱

• PeerChangeType
• PeerScope

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

要從中擷取物件的端點。

objectId

Guid

要擷取之 Guid 的 PeerObject。

傳回

PeerObjectCollection

與指定 PeerObjectCollection 相關聯的 PeerEndPoint。 如果沒有應用程式與端點相關聯，就會傳回大小為零 (0) 的集合。

屬性

SecurityCriticalAttribute

例外狀況

ArgumentNullException

PeerEndPoint 不可以是 null。

InvalidOperationException

• 通話對等未訂閱 PeerEndPoint。

• 呼叫對等尚未呼叫 RefreshData() 方法。

PeerToPeerException

無法完成 GetObjects 作業。

備註

如果呼叫對等未訂閱 PeerContact 與指定 PeerEndPoint 之 相關聯的 ， RefreshData 則必須在呼叫這個方法之前呼叫方法。

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

給呼叫者的注意事項

類別上會定義其他多載， Peer 而不是子類別 PeerContact 和 PeerNearMe。

呼叫這個方法需要 PermissionState 的 Unrestricted。 當對等共同作業會話開始時，就會建立此狀態。

另請參閱

• PeerChangeType
• PeerScope