PeerNameResolver.ResolveAsync メソッド

定義

名前空間:

System.Net.PeerToPeer

アセンブリ:

System.Net.dll

これらのメソッドは、呼び出し元のピアに認識されているすべてのクラウド内で、指定した PeerName の非同期解決操作を開始します。

オーバーロード

ResolveAsync(PeerName, Object)	呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。
ResolveAsync(PeerName, Int32, Object)	maxRecords 未満のピア名エントリを返して、呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。
ResolveAsync(PeerName, Cloud, Object)	指定された Cloud で、指定された PeerName の非同期のピア名解決操作を開始します。
ResolveAsync(PeerName, Cloud, Int32, Object)	指定された Cloud で、指定された PeerName の非同期のピア名解決操作を開始します。 この解決操作では、指定したピア名に対し maxRecords エントリ以下の解決が行われます。

注釈

すべての Resolve メソッドに対して、非同期処理が必要な場合に使用される同等 ResolveAsync のメソッドがあります。 ResolveAsync にイベント処理用のシステム トークンがパラメーター リストに含まれていることを除き、渡されるパラメーターでは同じです。

Resolve メソッドと ResolveAsync メソッドの間でパラメーターの不一致が発生し Cloud 、パラメーターが指定されていない場合、メソッドはショートカットを Available 使用してクラウド パラメーターを入力します。

ResolveAsync(PeerName, Object)

呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。

public:
 void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Object ^ userState);

public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, object userState);

member this.ResolveAsync : System.Net.PeerToPeer.PeerName * obj -> unit

Public Sub ResolveAsync (peerName As PeerName, userState As Object)

パラメーター

peerName

PeerName

解決する PeerName。

userState

Object

ピア名解決操作に関する状態情報を格納するユーザー定義のオブジェクト。

例外

ArgumentNullException

peerName と userState のパラメーターの一方または両方が null に設定されます。

注釈

このメソッドは、ピア名をクラウドに非同期的に関連付けます。 すべてのクラウドに 対して クエリが実行 PeerNameされます。 イベントが発生し ResolveCompleted 、 メソッドが呼び出されます OnResolveCompleted 。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。

ピア名を解決できない場合は、 PeerToPeerException がスローされます。

セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。

メソッドの PeerNameResolver 呼び出しは、 内の ResolveAsync ピア名レコードごとに メソッドを呼び出すのと PeerNameRecordCollection似ています。 個々のピア名レコードで Resolve メソッドを使用しても、複数のピア名の解決は無効にならないことに注意してください。

すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。

リゾルバー オブジェクトへの非同期参照はすべて、一意の識別子トークンと調整されます。 この userState トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。

解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。

ResolveAsync(PeerName, Int32, Object)

maxRecords 未満のピア名エントリを返して、呼び出し元のピアに既知のすべてのクラウドで、指定された PeerName の非同期のピア名解決操作を開始します。

public:
 void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, int maxRecords, System::Object ^ userState);

public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, int maxRecords, object userState);

member this.ResolveAsync : System.Net.PeerToPeer.PeerName * int * obj -> unit

Public Sub ResolveAsync (peerName As PeerName, maxRecords As Integer, userState As Object)

パラメーター

peerName

PeerName

解決する PeerName。

maxRecords

Int32

取得するピア名のレコードの最大数。

userState

Object

解決操作に関する情報を格納するユーザー定義のオブジェクト。

例外

ArgumentNullException

peerName と userState のパラメーターの一方または両方が null に設定されます。

ArgumentOutOfRangeException

maxRecords パラメーターが 0 以下です。

注釈

このメソッドは、ピア名をクラウドに非同期的に関連付けます。 すべてのクラウドに 対して クエリが実行 PeerNameされます。 セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。 ピア名を解決できない場合、または が である場合は null、 PeerToPeerException がスローされます。

このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。

すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。

リゾルバー オブジェクトへの非同期参照はすべて、一意識別子トークン Objectと連携します。 この userState トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。

解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。

ResolveAsync(PeerName, Cloud, Object)

指定された Cloud で、指定された PeerName の非同期のピア名解決操作を開始します。

public:
 void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud, System::Object ^ userState);

public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud, object userState);

member this.ResolveAsync : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * obj -> unit

Public Sub ResolveAsync (peerName As PeerName, cloud As Cloud, userState As Object)

パラメーター

peerName

PeerName

解決する PeerName。

cloud

Cloud

peerName を解決する対象の Cloud。

userState

Object

ピア名解決操作に関する情報を格納するユーザー定義の Object。

例外

ArgumentNullException

peerName と userState のパラメーターの一方または両方が null に設定されます。

注釈

このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。

セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。

パラメーターが のCloud場合、名前はショートカットをAvailable使用して解決されます。これにより、、Scope、および ScopeId プロパティの既定値がName初期化nullされます。

すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。

リゾルバー オブジェクトへの非同期参照はすべて、一意の識別子トークンと調整されます。 この userState トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。

解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。

ResolveAsync(PeerName, Cloud, Int32, Object)

指定された Cloud で、指定された PeerName の非同期のピア名解決操作を開始します。 この解決操作では、指定したピア名に対し maxRecords エントリ以下の解決が行われます。

public:
 void ResolveAsync(System::Net::PeerToPeer::PeerName ^ peerName, System::Net::PeerToPeer::Cloud ^ cloud, int maxRecords, System::Object ^ userState);

[System.Security.SecurityCritical]
public void ResolveAsync (System.Net.PeerToPeer.PeerName peerName, System.Net.PeerToPeer.Cloud cloud, int maxRecords, object userState);

[<System.Security.SecurityCritical>]
member this.ResolveAsync : System.Net.PeerToPeer.PeerName * System.Net.PeerToPeer.Cloud * int * obj -> unit

Public Sub ResolveAsync (peerName As PeerName, cloud As Cloud, maxRecords As Integer, userState As Object)

パラメーター

peerName

PeerName

解決する peerName。

cloud

Cloud

peerName を解決する対象の cloud。

maxRecords

Int32

peerName に対して cloud から取得するレコードの最大数。

userState

Object

ピア名解決操作に関する情報を格納するユーザー定義のオブジェクト。

属性

SecurityCriticalAttribute

例外

ArgumentNullException

peerName と userState のパラメーターの一方または両方が null に設定されます。

ArgumentException

指定された 1 つ以上のパラメーターが無効です。

PeerToPeerException

この操作を正常に完了するには、少なくとも 1 つのイベント ハンドラーが必要です。

ArgumentOutOfRangeException

maxRecords パラメーターが 0 以下です。

注釈

セキュリティで保護されていないピア名の場合、同じ名前を同じクラウド内の異なるピアによって登録 (および異なるエンドポイントに関連付けることができます)。

このメソッドは、 イベントを ResolveCompleted 発生させ、 メソッドを OnResolveCompleted 呼び出します。 または、 メソッドを ResolveProgressChanged 呼び出す イベントを OnResolveProgressChanged 発生させます。

パラメーターが のCloud場合、名前はショートカットをAvailable使用して解決されます。これにより、、Scope、および ScopeId プロパティの既定値がName初期化nullされます。

すべての ResolveAsync メソッドに対して、同等 Resolve のメソッドがあります。 パラメーター リストは同じですが、ResolveAsync メソッドには非同期イベント処理用のシステム トークンが含まれており、Resolve メソッドは同期処理を目的としています。

ピア リゾルバー オブジェクトへのすべての非同期参照は、一意の識別子トークン Objectと調整されます。 この userState トークンまたはメッセージ識別子を使用すると、オペレーティング システムは、メッセージがメッセージ キューに配置された後に、1 つの受信プロセスにメッセージを配信できます。

解決 ResolveCompleted 操作がエラーで完了した場合、または取り消された場合、イベントが発生します。