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() 方法必须用于更新注册。

• 远程对等方不具有指定 PeerName 的 Authority。

• 未指定 PeerName 或 Data；必须提供其中一个。

• 消息或数据元素均无效。 或者，未设置 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，则此方法使用 Available 字段注册属性中指定的PeerName对等名称，该字段初始化 、 Scope和 ScopeId的Name默认值。

PeerNameRegistration对象启动后，Stop使用 方法停止它。

若要更新注册， Update 必须使用 方法。