PeerNameRegistration.Start メソッド

定義

名前空間:

System.Net.PeerToPeer

アセンブリ:

System.Net.dll

PeerName を Cloud に登録します。 EndPointCollection がまったく指定されないと、Port プロパティで指定したポート値を使用して、自動アドレス選択が使用されます。

public:
 void Start();

[System.Security.SecurityCritical]
public void Start ();

[<System.Security.SecurityCritical>]
member this.Start : unit -> unit

Public Sub Start ()

属性

SecurityCriticalAttribute

例外

ArgumentNullException

PeerName プロパティが null に設定されています。

ObjectDisposedException

このオブジェクトでは、Dispose() が既に呼び出されました。

PeerToPeerException

• 指定された PeerName は既に登録されています。 登録更新には Update() メソッドを使用する必要があります。

• リモート ピアには、指定した Authority に対する PeerName がありません。

• PeerName または Data が指定されていません。少なくとも 1 つは指定する必要があります。

• メッセージ要素またはデータ要素が無効です。 または、UseAutoEndPointSelection が設定されておらず、データ BLOB または IPEndPoint が指定されていません。

例

次のコード例では、 を PeerName 作成し、指定されたメタデータと共に登録します。

// Creates a PeerName and registers it along with the metadata specified
// The parameters used to register the name are static types that are set
// from user input (command-line or user dialog).
// These parameters include the following:
//   static String peerName
//   static PeerNameType peerNameType
//   static int portNumber
//   static String comment
//   static Cloud cloudName

public static void CreateAndPublishPeerName()
{
    try{
        // Creates a the PeerName to register using the classifier and type provided
        PeerName peerName = new PeerName(peerNameClassifier, peerNameType);

        // Create a registration object which represents the registration
        // of the PeerName in a Cloud
        PeerNameRegistration peerNameRegistration = new PeerNameRegistration();
        peerNameRegistration.PeerName = peerName;
        peerNameRegistration.Port = portNumber;
        peerNameRegistration.Comment = comment;
        peerNameRegistration.Cloud = cloudName;
        // Since the peerNameRegistration.EndPointCollection is not specified,
        // all (IPv4&IPv6) addresses assigned to the local host will
        // automatically be associated with the peerNameRegistration instance.
        // This behavior can be control using peerNameRegistration.UseAutoEndPointSelection

        //Note: Additional information may be specified on the PeerNameRegistration
        // object, which is not shown in this example.

        // Starting the registration means the name is published for
        // other peers to resolve
        peerNameRegistration.Start();
        Console.WriteLine("Registration of Peer Name: {0} complete.", peerName.ToString(), cloudName);
        Console.WriteLine();

        Console.WriteLine("Press any key to stop the registration and close the program");
        Console.ReadKey();

        // Stopping the registration means the name is no longer published
        peerNameRegistration.Stop();
    } catch(Exception e){
        Console.WriteLine("Error creating and registering the PeerName: {0} \n", e.Message);
        Console.WriteLine(e.StackTrace);
    }
}

注釈

メソッドは、 プロパティで指定されたピア名を PeerName 、すべてのソース アドレスとコンストラクターで指定された に Port 登録します。 このメソッドでは、エンドポイントが指定されていない場合にのみ、既定のポートが使用されます。

プロパティが のCloud場合、このメソッドはnull、 フィールドを使用してプロパティでPeerName指定されたピア名をAvailable登録します。これにより、、Scope、および ScopeIdの既定値がName初期化されます。

オブジェクトが PeerNameRegistration 開始されると、 メソッドを Stop 使用して停止します。

登録を更新するには、 メソッドを Update 使用する必要があります。