PeerNameRegistration.Start Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.