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 den PeerName in der Cloud. Wenn keine EndPointCollection 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 festgelegt.
Für dieses Objekt wurde „Dispose()“ bereits aufgerufen.
Der angegebene PeerName wurde bereits registriert. Die Update()-Methode muss zum Aktualisieren einer Registrierung verwendet werden.
Der Remotepeer besitzt nicht die Authority für den angegebenen PeerName.
Entweder ist der PeerName oder sind die Data nicht angegeben; mindestens eines muss angegeben werden.
Die Nachrichten- oder Datenelemente sind ungültig. Oder UseAutoEndPointSelection ist nicht festgelegt, und weder ein Datenblob noch ein IPEndPoint ist angegeben.
Beispiele
Im folgenden Codebeispiel wird ein 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 der Port im -Konstruktor angegebenen. Der Standardport wird von dieser Methode nur verwendet, wenn keine Endpunkte angegeben sind.
Wenn die Cloud -Eigenschaft istnull, registriert diese Methode den in der PeerName -Eigenschaft angegebenen Peernamen mithilfe des Available Felds, das Standardwerte für , NameScopeund ScopeIdinitialisiert.
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.
