Technologiebeispiel für PeerToPeer
Aktualisiert: November 2007
In diesem Beispiel wird gezeigt, wie neue Klassen im System.Net.PeerToPeer-Namespace zum Registrieren und Veröffentlichen von Peernamen und zum Auflösen von Peernamen verwendet werden.
Informationen zum Verwenden der Beispiele finden Sie in folgenden Themen:
So erstellen Sie das Beispiel mithilfe der Eingabeaufforderung
Öffnen Sie ein Eingabeaufforderungsfenster, und navigieren Sie zum CS-Unterverzeichnis im PNRPSample-Verzeichnis. Informationen zu erforderlichen Einstellungen sowie zur SDK-Eingabeaufforderung finden Sie unter Gewusst wie: Festlegen der Beispieleinstellungen.
Geben Sie in der Befehlszeile msbuild PNRPSample.sln ein. Mit diesem Befehl wird sowohl die PublishPeerName-Anwendung als auch die ResolvePeerName-Anwendung erstellt.
So erstellen Sie das Beispiel mithilfe von Visual Studio
Öffnen Sie Windows Explorer, und navigieren Sie zum CS-Unterverzeichnis im PNRPSample-Verzeichnis.
Doppelklicken Sie auf das Symbol für PNRPSample.sln, um die Datei in Visual Studio zu öffnen.
Wählen Sie im Menü Erstellen die Option Projektmappe erstellen aus.
Sowohl die PublishPeerName-Anwendung als auch die ResolvePeerName-Anwendung werden im Standardverzeichnis \bin oder \bin\Debug erstellt.
So führen Sie das Beispiel aus
Navigieren Sie im Befehlszeilenfenster zu dem Verzeichnis, das die neuen ausführbaren Dateien enthält.
Geben Sie PublishPeerName.exe in der Befehlszeile mit entsprechenden Befehlszeilenargumenten ein, um die PublishPeerName-Anwendung auszuführen.
Geben Sie ResolvePeerName.exe in der Befehlszeile mit entsprechenden Parametern ein, um die ResolvePeerName-Anwendung zum Testen der PublishPeerName-Anwendung auszuführen.
Anforderungen
Dieses Beispiel erfordert .NET Framework 2.0 SP1, 3.0 SP1 oder 3.5. Dieses Beispiel wird unter Windows Vista (alle SKUs außer Windows Vista Starter Edition), Windows Server 2008 und Windows XP (siehe ) unterstützt.
Veranschaulicht
Eine Reihe neuer Klassen wurden dem System.Net.PeerToPeer-Namespace und dem System.Net.PeerToPeer.Collaboration-Namespace hinzugefügt, die Peer-To-Peer-Netzwerk- und Zusammenarbeitsfunktionen unterstützen, sodass Ressourcen von den Peers gemeinsam genutzt werden können.
In diesem Beispiel wird die Verwendung des PNRP (Peer Name Resolution Protocol), einer serverlosen Namensauflösungstechnologie, zum Veröffentlichen und Auflösen eines Peernamens veranschaulicht. Sie ermöglicht einer Anwendung, einen Bezeichner (auch als Peername bezeichnet) zu erstellen, diesem Bezeichner Daten zuzuordnen (z. B. eine IP-Adresse, eine Portnummer und ein binäres Daten-Blob) und diese Informationen für andere Peers zu veröffentlichen, sodass die Auflösung durchgeführt werden kann. Dieses Beispiel enthält zwei Projekte. Im PublishPeerName-Beispiel wird gezeigt, wie ein Peername erstellt und veröffentlicht wird. Im ResolvePeerName-Beispiel wird gezeigt, wie ein Peername aufgelöst wird.
Die PublishPeerName-Anwendung erfordert fünf Befehlszeilenparameter.
PublishPeerName.exe <peerNameClassifier> <peerNameType> <portNum> <comment> <cloudName:Available|AllLinkLocal|Global>
Sie lauten wie folgt:
peerNameClassifier - Eine benutzerdefinierte Zeichenfolge, die als Klassifizierung im zu veröffentlichenden Peernamen verwendet wird.
PeerNameType - Dies bestimmt, welche Peernamensinstanz erstellt und registriert werden soll. Unterstützte Werte sind Secured und Unsecured.
portNum - Die lokale Portnummer, die dem Peernamen zugeordnet wird, wenn er registriert wird.
comment - Eine Kommentarzeichenfolge, die dem Peernamen zugeordnet werden soll. Diese Zeichenfolge wird auch für PNRP-Clients veröffentlicht und aufgelöst.
cloudName - Der Bereich, in dem der Peername veröffentlicht wird. Unterstützte Werte sind Available, AllLinkLocal und Global.
Im Folgenden ein Verwendungsbeispiel:
PublishPeerName.exe MyClassifier Secured 8000 CommentString Available
Die ResolvePeerName-Anwendung erfordert einen Befehlszeilenparameter.
ResolvePeerName.exe <peerNameToResolve>
Er lautet wie folgt:
- peerNameToResolve - Der Peername, den die Anwendung versucht aufzulösen.
Wenn die ResolvePeerName-Anwendung erfolgreich ist, werden die Ergebnisse aus der Auflösung des Peernamens angezeigt.