Idioma

PeerNameRegistration.Start Método

Definição

Regista o PeerName no Cloud. Se não EndPointCollection for especificado, a seleção automática de endereços é usada com o valor da porta especificado pela Port propriedade.

public:
 void Start();
[System.Security.SecurityCritical]
public void Start();
[<System.Security.SecurityCritical>]
member this.Start : unit -> unit
Public Sub Start ()
Atributos

Exceções

A propriedade PeerName está definida como null.

Este objeto já tinha chamado Dispose() anteriormente.

  • O PeerName especificado já foi registado. O Update() método deve ser usado para atualizar um registo.

  • O par remoto não detém o Authority para o PeerName especificado.

  • Ou o PeerName ou o Data não é especificado; pelo menos um precisa de ser fornecido.

  • A mensagem ou os elementos de dados são inválidos. Ou, UseAutoEndPointSelection não está definido e não tem blob de dados ou IPEndPoint é especificado.

Exemplos

O exemplo de código seguinte cria um PeerName e regista-o juntamente com os metadados especificados.

// 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);
    }
}

Observações

O método regista o nome do par especificado na PeerName propriedade com todos os endereços de origem e o Port especificado no construtor. A porta padrão é usada por este método apenas quando não são especificados endpoints.

Se a propriedade for Cloud, este método regista o nome do par especificado na null propriedade usando o PeerName campo, que inicializa os valores padrão para , AvailableName, e Scope.ScopeId

Depois de um PeerNameRegistration objeto ter sido iniciado, o Stop método é usado para o parar.

Para atualizar um registo, deve ser utilizado o Update método.

Aplica-se a