PeerNameRegistration.Start Méthode

Définition

Espace de noms:

System.Net.PeerToPeer

Assembly:

System.Net.dll

Inscrit le PeerName dans le Cloud. Si aucun EndPointCollection n’est spécifié, la sélection automatique des adresses est utilisée avec la valeur de port spécifiée par la propriété Port.

public:
 void Start();

[System.Security.SecurityCritical]
public void Start ();

[<System.Security.SecurityCritical>]
member this.Start : unit -> unit

Public Sub Start ()

Attributs

SecurityCriticalAttribute

Exceptions

ArgumentNullException

La propriété PeerName est définie sur null.

ObjectDisposedException

Dispose() a déjà été appelé pour cet objet.

PeerToPeerException

• Le PeerName spécifié a déjà été enregistré. Le méthode Update() doit être utilisée pour mettre à jour une inscription.

• L’homologue distant ne possède pas Authority pour le PeerName spécifié.

• Le PeerName ou le Data n’est pas spécifié ; au moins un des deux doit être fourni.

• Les éléments de message ou de données ne sont pas valides. Ou bien UseAutoEndPointSelection n’est pas défini et aucun objet blob de données ou IPEndPoint n’est spécifié.

Exemples

L’exemple de code suivant crée un PeerName et l’inscrit avec les métadonnées spécifiées.

// 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);
    }
}

Remarques

La méthode inscrit le nom d’homologue spécifié dans la PeerName propriété avec toutes les adresses sources et le Port spécifié dans le constructeur. Le port par défaut est utilisé par cette méthode uniquement lorsqu’aucun point de terminaison n’est spécifié.

Si la Cloud propriété est null, cette méthode inscrit le nom d’homologue spécifié dans la propriété à l’aide du AvailablePeerName champ , qui initialise les valeurs par défaut pour , NameScopeet ScopeId.

Une fois qu’un PeerNameRegistration objet a été démarré, la Stop méthode est utilisée pour l’arrêter.

Pour mettre à jour une inscription, la Update méthode doit être utilisée.