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 。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。

ピア コラボレーション セッションが の を使用してPermissionStateUnrestrictedインスタンス化されなかった場合、このメソッドはローカル コンピューター上のオブジェクトにアクセスできません。 同じことが、コラボレーション セッションに登録されているアプリケーションにも当てはまります。

ピア オブジェクトのコレクションは、このインスタンスで指定されたピアまたはエンドポイントのアプリケーション、データ オブジェクト、プレゼンス情報で構成されます。 エンドポイントのオブジェクトが見つからない場合は、サイズ 0 (0) のコレクションが返されます。 呼び出し元ピアがこのエンドポイントにサブスクライブされている場合、キャッシュは自動的に更新されます。それ以外の場合 RefreshData は、このメソッドを呼び出す前に を呼び出す必要があります。

このメソッドを正常に完了するために、呼び出し元がコラボレーション インフラストラクチャにサインインする必要はありません。 呼び出し元がこのメソッドを RefreshData 呼び出す前に Subscribe サインインしている間に、 または いずれかのメソッドの呼び出しが正常に完了している必要があります。

注: 追加のオーバーロードは、サブクラスPeerContactと PeerNearMeではなく、 クラスで定義Peerされます。

こちらもご覧ください

• 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

Guid Peerコレクションから取得するオブジェクトの 。

戻り値

PeerObjectCollection

指定された Peer に関連付けられた Guid オブジェクト。 オブジェクトが見つからない場合、サイズがゼロ (0) のコレクションが返されます。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

オブジェクトの ID が null です。

InvalidOperationException

呼び出し元が PeerEndPoint をサブスクライブしていないか、RefreshData() をまだ呼び出していません。

PeerToPeerException

ピアからオブジェクト情報を取得するときにエラーが発生しました。

注釈

この機能は、 クラスでのみ公開されます PeerContact 。 この機能は、セキュリティ上の理由から、他の種類のピアでは公開されません。

ピア オブジェクトのコレクションは、このインスタンスで指定されたピアまたはエンドポイントのアプリケーション、データ オブジェクト、プレゼンス情報で構成されます。 エンドポイントのオブジェクトが見つからない場合は、サイズ 0 (0) のコレクションが返されます。 呼び出し元ピアがこのエンドポイントにサブスクライブされると、キャッシュは自動的に更新されます。それ以外の場合 RefreshData は、このメソッドを呼び出す前に を呼び出す必要があります。

このメソッドを正常に完了するために、呼び出し元がコラボレーション インフラストラクチャにサインインする必要はありません。 呼び出し元がこのメソッドを RefreshData 呼び出す前に Subscribe サインインしている間に、 または いずれかのメソッドの呼び出しが正常に完了している必要があります。 このメソッドを呼び出す場合は、 の UnrestrictedがPermissionState必要です。 この状態は、コラボレーション セッションの開始時に作成されます。

注: 追加のオーバーロードは、派生クラスと PeerNearMeではなく、 クラスPeerContactで定義Peerされます。

こちらもご覧ください

• GetApplications
• Guid
• RefreshDataAsync(Object)