Pair à pair, exemple de technologie
Mise à jour : novembre 2007
Cet exemple explique comment utiliser les nouvelles classes dans l'espace de noms System.Net.PeerToPeer pour enregistrer et publier un nom de pair, puis résoudre un nom de pair.
Pour plus d'informations sur l'utilisation des exemples, consultez les rubriques suivantes :
Pour générer l'exemple à partir de l'invite de commandes
Ouvrez une fenêtre d'invite de commandes et accédez au sous-répertoire \CS du répertoire PNRPSample. Pour plus d'informations sur les paramètres requis et l'invite de commandes du Kit de développement logiciel (SDK), consultez Comment : définir des paramètres d'exemple.
Tapez msbuild PNRPSample.sln sur la ligne de commande. Cette commande générera les applications PublishPeerName et ResolvePeerName.
Pour générer l'exemple à l'aide de Visual Studio :
Ouvrez l'Explorateur Windows et accédez au sous-répertoire \CS du répertoire PNRPSample.
Double-cliquez sur l'icône de PNRPSample.sln pour ouvrir le fichier dans Visual Studio.
Dans le menu Générer, sélectionnez Générer la solution.
Les applications PublishPeerName et ResolvePeerName sont générées dans le répertoire par défaut \bin ou \bin\Debug.
Pour exécuter l'exemple
Accédez au répertoire qui contient les fichiers exécutables générés, à l'aide de la fenêtre d'invite de commandes.
Tapez PublishPeerName.exe sur la ligne de commande avec les arguments de ligne de commande appropriés pour exécuter l'application PublishPeerName.
Tapez ResolvePeerName.exe sur la ligne de commande avec les paramètres appropriés pour exécuter l'application ResolvePeerName afin de tester l'application PublishPeerName.
Configuration requise
Cet exemple requiert le .NET Framework v2.0 SP1, SP1 v3.0 ou v3.5. Cet exemple est pris en charge sur Windows Vista (tous les SKU sauf Windows Vista Starter Edition), Windows Server 2008 et Windows XP (consultez https://support.microsoft.com/default.aspx/kb/920342).
Démonstrations
Une série de nouvelles classes a été ajoutée aux espaces de noms System.Net.PeerToPeer et System.Net.PeerToPeer.Collaboration qui prennent en charge la collaboration et le réseau pair à pair pour partager les ressources entre les pairs.
Cet exemple illustre l'utilisation du protocole PNRP (Peer Name Resolution Protocol), une technologie de résolution de noms sans serveur, pour publier et résoudre un PeerName. Cela permet à une application de créer un identificateur (appelé nom de pair), d'associer celui-ci à des données (par exemple, une adresse IP, un numéro de port et un blob binaire de données) et de publier ces informations pour permettre à d'autres pairs d'effectuer une résolution. L'exemple contient deux projets. L'exemple PublishPeerName explique comment créer et publier un nom de pair. L'exemple ResolvePeerName indique comment résoudre un nom de pair.
L'application PublishPeerName requiert cinq paramètres de ligne de commande.
PublishPeerName.exe <peerNameClassifier> <peerNameType> <portNum> <comment> <cloudName:Available|AllLinkLocal|Global>
Les paramètres sont les suivants :
peerNameClassifier - Chaîne définie par l'utilisateur qui sera utilisée comme classifieur dans le nom de pair à publier.
PeerNameType - Détermine le type d'instance de nom de pair à créer et enregistrer. Les valeurs prises en charge sont Secured et Unsecured.
portNum - Numéro de port local qui sera associé au nom de pair lors de son enregistrement.
comment - Chaîne de commentaire à associer au nom de pair. Cette chaîne est également publiée et résoluble pour les clients PNRP.
cloudName - Portée dans laquelle le nom de pair sera publié. Les valeurs prises en charge sont Available, AllLinkLocal et Global.
Voici un exemple d'utilisation :
PublishPeerName.exe MyClassifier Secured 8000 CommentString Available
L'application ResolvePeerName requiert un paramètre de ligne de commande.
ResolvePeerName.exe <peerNameToResolve>
Les paramètres sont les suivants :
- peerNameToResolve - Nom de pair que l'application tentera de résoudre.
Si l'exécution de l'application ResolvePeerName aboutit, les résultats de la résolution du nom de pair sont affichés.