PeerToPeer 技術範例
更新:2007 年 11 月
這個範例說明如何使用 System.Net.PeerToPeer 命名空間內的新類別來註冊及發行對等名稱,然後再解析對等名稱。
如需使用這些範例的詳細資訊,請參閱下列主題:
若要使用命令提示字元建置範例
開啟 [命令提示字元] 視窗,巡覽至 PNRPSample 目錄下的 CS 子目錄。如需必要設定和 SDK 命令提示字元的詳細資訊,請參閱 HOW TO:設定範例設定。
在命令列中輸入 msbuild PNRPSample.sln。這個命令將會建置 PublishPeerName 和 ResolvePeerName 應用程式。
若要使用 Visual Studio 建置範例
開啟 [Windows 檔案總管],然後巡覽至 PNRPSample 目錄下的 CS 子目錄。
按兩下 PNRPSample.sln 的圖示,即可在 Visual Studio 中開啟這個檔案。
在 [建置] 功能表中,選取 [建置方案]。
PublishPeerName 和 ResolvePeerName 應用程式都會建置在預設的 \bin 或 \bin\Debug 目錄中。
若要執行範例
使用 [命令提示字元] 視窗巡覽至新建立之可執行檔的所在目錄。
在命令列中輸入 PublishPeerName.exe 和適當的命令列引數,即可執行 PublishPeerName 應用程式。
在命令列中輸入 ResolvePeerName.exe 和適當的參數,即可執行用於測試 PublishPeerName 應用程式的 ResolvePeerName 應用程式。
需求
這個範例需要使用 .NET Framework v2.0 SP1、v3.0 SP1 或 v3.5。Windows Vista (除了 Windows Vista Starter Edition 之外的所有 SKU)、Windows Server 2008 和 Windows XP 支援這個範例 (請參閱 https://support.microsoft.com/default.aspx/kb/920342)。
示範
支援對等網路和共同作業而可在對等電腦之間共用資源的 System.Net.PeerToPeer 和 System.Net.PeerToPeer.Collaboration 命名空間內已加入一系列新類別。
這個範例將示範使用對等名稱解析通訊協定 (Peer Name Resolution Protocol,PNRP) 和無伺服器名稱解析技術來發行及解析 PeerName。它允許應用程式建立識別項 (稱為對等名稱)、將該識別項與資料 (例如,IP 位址、通訊埠編號、資料的二進位大型物件 (BLOB)) 產生關聯,以及發行此項資訊以使其他對等電腦可以加以解析。本範例包含兩個專案。PublishPeerName 範例會概述如何建立及發行對等名稱。ResolvePeerName 範例會示範如何解析對等名稱。
PublishPeerName 應用程式需要 5 個命令列參數。
PublishPeerName.exe <peerNameClassifier> <peerNameType> <portNum> <comment> <cloudName:Available|AllLinkLocal|Global>
參數如下:
peerNameClassifier - 使用者定義的字串,用來做為要發行之對等名稱中的 Classifier 使用。
PeerNameType - 這個參數會判斷要建立及註冊之對等名稱執行個體 (Instance) 的型別。支援的值為 Secured 和 Unsecured。
portNum - 將在註冊時與對等名稱產生關聯的本機通訊埠編號。
comment - 要與對等名稱產生關聯的註解字串。這個字串也會發行,並可由 PNRP 用戶端解析。
cloudName - 對等名稱將發行至其中的範圍。支援的值為 Available、AllLinkLocal 和 Global。
下列是使用方式範例:
PublishPeerName.exe MyClassifier Secured 8000 CommentString Available
ResolvePeerName 應用程式需要 1 個命令列參數。
ResolvePeerName.exe <peerNameToResolve>
參數如下:
- peerNameToResolve - 應用程式將嘗試解析的對等名稱。
如果 ResolvePeerName 應用程式成功執行,則會顯示解析對等名稱的結果。