PeerNameRegistration.Start Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Registreert de PeerName in de Cloud. Als er geen EndPointCollection is opgegeven, wordt automatische adresselectie gebruikt met de poortwaarde die is opgegeven door de Port eigenschap.
public:
void Start();[System.Security.SecurityCritical]
public void Start();[<System.Security.SecurityCritical>]
member this.Start : unit -> unitPublic Sub Start ()- Kenmerken
Uitzonderingen
De eigenschap PeerName is ingesteld op null.
Dit object had Dispose() eerder aangeroepen.
De PeerName opgegeven is al geregistreerd. De Update() methode moet worden gebruikt om een registratie bij te werken.
De externe peer is niet de eigenaar van de AuthorityPeerName opgegeven.
PeerName De of de Data is niet opgegeven. Er moet ten minste één worden opgegeven.
Het bericht of de gegevenselementen zijn ongeldig. Of, UseAutoEndPointSelection is niet ingesteld en geen gegevensblob of IPEndPoint is opgegeven.
Voorbeelden
In het volgende codevoorbeeld wordt een PeerName bestand gemaakt en geregistreerd, samen met de opgegeven metagegevens.
// 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);
}
}
Opmerkingen
De methode registreert de peernaam die is opgegeven in de PeerName eigenschap met alle bronadressen en de Port opgegeven in de constructor. De standaardpoort wordt alleen door deze methode gebruikt wanneer er geen eindpunten zijn opgegeven.
Als de Cloud eigenschap is null, registreert deze methode de peernaam die is opgegeven in de PeerName eigenschap met behulp van het Available veld, waarmee standaardwaarden voor de Name, Scopeen ScopeId.
Nadat een PeerNameRegistration object is gestart, wordt de Stop methode gebruikt om het te stoppen.
Als u een registratie wilt bijwerken, moet de Update methode worden gebruikt.