PeerNameRegistration.Start Método
Definição
Registra o PeerName na Cloud.Registers the PeerName into the Cloud. Se nenhuma EndPointCollection for especificada, a seleção automática de endereço será usada com o valor da porta especificado pela propriedade Port.If no EndPointCollection is specified, automatic address selection is used with the port value specified by the Port property.
public:
void Start();
[System.Security.SecurityCritical]
public void Start ();
[<System.Security.SecurityCritical>]
member this.Start : unit -> unit
Public Sub Start ()
- Atributos
Exceções
Este objeto tinha Dispose() chamado nele anteriormente.This object had Dispose() called on it previously.
- O PeerName especificado já foi registrado.- The PeerName specified has already been registered. O método Update() deve ser usado para atualizar um registro.The Update() method must be used to update a registration.
- O par remoto não possui a Authority para o PeerName especificado.- The remote peer does not own the Authority for the PeerName specified.
- O PeerName ou Data não está especificado; pelo menos um deve ser fornecido.- Either the PeerName or the Data is not specified; at least one needs to be provided.
- Os elementos de dados ou da mensagem são inválidos.- The message or data elements are invalid. Ou UseAutoEndPointSelection não está definida e nenhum blob de dados ou IPEndPoint foi especificado.Or, UseAutoEndPointSelection is not set and no data blob or IPEndPoint is specified.
Exemplos
O exemplo de código a seguir cria um PeerName e registra-o junto com os metadados especificados.The following code example creates a PeerName and registers it along with the metadata specified.
// 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);
}
}
Comentários
O método registra o nome de par especificado na PeerName propriedade com todos os endereços de origem e o Port especificado no construtor.The method registers the peer name specified in the PeerName property with all source addresses and the Port specified in the constructor. A porta padrão é usada por esse método somente quando nenhum ponto de extremidade é especificado.The default port is used by this method only when no endpoints are specified.
Se a Cloud propriedade for null , esse método registrará o nome de par especificado na PeerName propriedade usando o Available campo, que inicializa os valores padrão para Name , Scope e ScopeId .If the Cloud property is null, this method registers the peer name specified in the PeerName property using the Available field, which initializes default values for the Name, Scope, and ScopeId.
Depois PeerNameRegistration que um objeto é iniciado, o Stop método é usado para interrompê-lo.After a PeerNameRegistration object has been started, the Stop method is used to stop it.
Para atualizar um registro, o Update método deve ser usado.To update a registration, the Update method must be used.