PeerNameRegistration.Start Methode

Definition

Namespace:

System.Net.PeerToPeer

Assembly:

System.Net.dll

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 -> unit

Public Sub Start ()

Attribute

SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

Die PeerName-Eigenschaft ist auf null festgelegt.

ObjectDisposedException

Für dieses Objekt wurde „Dispose()“ bereits aufgerufen.

PeerToPeerException

• 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.