PeerNameRegistration.Start Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Registriert die PeerName Datei in der Cloud. Wenn kein EndPointCollection Wert angegeben ist, wird die automatische Adressauswahl mit dem durch die Port Eigenschaft angegebenen Portwert verwendet.
public:
void Start();[System.Security.SecurityCritical]
public void Start();[<System.Security.SecurityCritical>]
member this.Start : unit -> unitPublic Sub Start ()- Attribute
Ausnahmen
Die PeerName-Eigenschaft ist auf null gesetzt.
Dieses Objekt hatte Dispose() zuvor aufgerufen.
Die PeerName angegebene Datei wurde bereits registriert. Die Update() Methode muss zum Aktualisieren einer Registrierung verwendet werden.
Der Remote-Peer besitzt nicht den Authority für den PeerName angegebenen Wert.
Entweder die PeerName oder die Data nicht angegeben ist; mindestens eine muss bereitgestellt werden.
Die Nachrichten- oder Datenelemente sind ungültig. UseAutoEndPointSelection Oder ist nicht festgelegt, und es wird kein Daten-BLOB angegeben oder IPEndPoint angegeben.
Beispiele
Im folgenden Codebeispiel wird ein Code PeerName erstellt und zusammen mit den angegebenen Metadaten registriert.
// 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);
}
}
Hinweise
Die Methode registriert den in der PeerName Eigenschaft angegebenen Peernamen mit allen Quelladressen und dem Port im Konstruktor angegebenen. Der Standardport wird von dieser Methode nur verwendet, wenn keine Endpunkte angegeben werden.
Wenn die Cloud Eigenschaft lautet null, registriert diese Methode den in der PeerName Eigenschaft angegebenen Peernamen mithilfe des Available Felds, das Standardwerte für das Name, Scopeund ScopeId.
Nachdem ein PeerNameRegistration Objekt gestartet wurde, wird die Stop Methode verwendet, um es zu beenden.
Um eine Registrierung zu aktualisieren, muss die Update Methode verwendet werden.
