共用方式為

檔案共用資料處理延伸模組範例

  • 發行項

更新： 2005 年 12 月 5 日

FsiDataExtension 是 Windows 檔案系統的範例資料處理延伸模組。它使用 Microsoft .NET Framework 程式庫類別 DirectoryInfo 和 FileSystemInfo，來查詢任何有效的網路檔案共用內容。此範例使用資料處理延伸模組介面以及其他的 .NET Framework 類別。「檔案共用資訊」的範例命名慣例是以 "Fsi" 開頭。以 Itanium 為基礎的作業系統不支援這個範例。

安裝期間不會自動安裝 SQL Server 範例。如需有關如何安裝範例的指示，請參閱＜安裝範例＞。

ms160918.note(zh-tw,SQL.90).gif重要事項：
範例只供教育目的之用。它們不能用於實際執行環境，而且從來沒有在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。若沒有系統管理員的權限，就不應該在實際 SQL Server 資料庫或報表伺服器上，連接或使用範例應用程式及組件。

需求

您應該熟悉 Microsoft Visual Studio 和 Microsoft Visual C# 或 Microsoft Visual Basic，而且您應該安裝下列環境，才能使用 FsiDataExtension 範例：

  • Microsoft Visual Studio 2005 或相容的開發環境 (適用於檢視專案檔案)。
  • Microsoft SQL Server 2005，包括 Reporting Services。
  • Microsoft .NET Framework 2.0 版。
  • Reporting Services 範例。您可以選擇在 SQL Server 2005 安裝期間安裝範例。在此版本中，當您選擇安裝範例時會在電腦上安裝個別安裝程式，您只要啟動它就可以解壓縮並安裝範例。您可以從 Microsoft SQL Server 2005 程式群組中的 [開始] 功能表執行此安裝程式。
  • 如果您計劃使用範例延伸模組，將其他資料處理功能加到您的伺服器，您必須具有在網路上存取報表伺服器的權限。

位置

此範例位於 Reporting Services 範例目錄的 [Extension Samples\FsiDataExtension Sample] 子目錄中。

例如：

C:\Program Files\Microsoft SQL Server\90\Samples\Reporting Services\Extension Samples\FindRenderSave Sample

建立範例

使用下列步驟來建立範例。

如果您尚未建立強式名稱金鑰檔，請利用下列指示產生金鑰檔。

若要產生強式名稱金鑰檔

  1. 開啟 Microsoft Visual Studio 2005 命令提示字元。按一下 [開始]，依序指向 [程式集] 和 [Microsoft .NET Framework SDK 2.0]，然後按一下 [SDK 命令提示字元]。

    -- 或 --

    開啟 Microsoft .NET Framework 命令提示字元。按一下 [開始]，依序指向 [所有程式] 和 [Microsoft .NET Framework SDK 2.0]，然後按一下 [SDK 命令提示字元]。

  2. 使用變更目錄命令 (CD)，將命令提示字元視窗的現行目錄切換到範例的安裝資料夾。

    ms160918.note(zh-tw,SQL.90).gif附註：
    若要判斷範例所在的資料夾，按一下 [開始] 按鈕，依序指向 [所有程式]、[Microsoft SQL Server] 和 [文件集和教學課程]，然後按一下 [範例目錄]。如果是使用預設安裝位置，則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\100\Samples。

  3. 在命令提示字元中，執行下列其中一個命令來產生金鑰檔：

    sn -k SampleKey.snk

    ms160918.note(zh-tw,SQL.90).gif重要事項：
    如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要使用 .NET Framework SDK 編譯範例

  1. 從報表伺服器 \bin 目錄將 Microsoft.ReportingServices.Interfaces.dll 複製到您的範例資料夾。

  2. 執行下列命令以建立範例資料處理延伸模組 Microsoft.Samples.ReportingServices.FsiDataExtension.dll。

    csc.exe /t:library /out:Microsoft.Samples.ReportingServices.FsiDataExtension.dll *.cs .\properties\*.cs /res:.\properties\Resources.resx  /r:Microsoft.ReportingServices.Interfaces.dll

若要使用 Visual Studio .NET 編譯範例

  1. 開啟 Visual Studio 2005 中的 FsiDataExtension 方案檔 (FsiDataExtensionCS.sln 或 FsiDataExtensionVB.sln)。

  2. 在 [方案總管] 中選取 FsiDataExtension 專案。

  3. 在 [專案] 功能表上，按一下 [加入參考]。

    此時會開啟 [加入參考] 對話方塊。

  4. 按一下 [.NET] 索引標籤。

  5. 按一下 [瀏覽]，然後在本機磁碟機中巡覽，以尋找 Microsoft.ReportingServices.Interfaces。依預設，該組件位於 [ReportServer\bin] 目錄。按一下 [確定]。

    選取的參考即會加入您的專案中。

  6. 在 [建立] 功能表上，按一下 [建置方案]。

部署範例

當您完成前述的步驟後，即可將 Microsoft.Samples.ReportingServices.FsiDataExtension.dll 部署到報表伺服器或「報表設計師」中，以供對自訂資料來源執行報表之用。

若要部署範例

  1. 將 Microsoft.Samples.ReportingServices.FsiDataExtension.dll 複製至報表伺服器。報表伺服器延伸模組的預設位置是 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin。

  2. 將組件複製到「報表設計師」。「報表設計師」延伸模組的預設位置是 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies。

  3. 在 RSReportServer.config 和 RSReportDesigner.config 檔案的 [Data] 項目之下加入下列項目 (RSReportDesigner.config 檔案的預設位置是 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies，而 RSReportServer.config 檔案的預設位置是 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer)：

    <Extension Name="FSI" Type="Microsoft.Samples.ReportingServices.FsiDataExtension.FsiConnection,Microsoft.Samples.ReportingServices.FsiDataExtension"/>

  4. 若要為範例資料處理延伸模組啟用一般查詢設計師，請在 RSReportDesigner.config 檔案的 <Designer> 元素之下加入下列項目。

    <Extension Name="FSI" Type="Microsoft.ReportingServices.QueryDesigners.VDTQueryDesigner,Microsoft.ReportingServices.QueryDesigners"/>

如需有關部署資料處理延伸模組的詳細資訊，請參閱＜Deploying a Data Processing Extension＞。

若要設定範例的程式碼存取安全性

  1. 開啟報表伺服器原則組態檔 (rssrvpolicy.config)。此檔案的預設位置是 C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer。

  2. 資料處理延伸模組必須被授與完全的信任。若要這麼做，請將下列程式碼群組資訊加入組態檔的程式碼群組區段尾端：

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft SQL Server\MSSQL.3\Reporting Services\ReportServer\bin\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

  3. 如果您在「報表設計師」中使用範例資料處理延伸模組，請使用「報表設計師」預覽原則組態檔 (rspreviewpolicy.config) 和下列程式碼群組重複步驟 1 和 2：

    <CodeGroup class="UnionCodeGroup"
   version="1"
   PermissionSetName="FullTrust"
   Name="FSICodeGroup"
   Description="Code group for my FSI data processing extension">
      <IMembershipCondition class="UrlMembershipCondition"
         version="1"
         Url="C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies\Microsoft.Samples.ReportingServices.FsiDataExtension.dll"
       />
</CodeGroup>

    rspreviewpolicy.config 檔的預設位置是 C:\Program Files\Microsoft Visual Studio 8\Common7\IDE\PrivateAssemblies。

    如需有關 .NET Framework 安全性與 Reporting Services 的詳細資訊，請參閱＜Understanding Code Access Security in Reporting Services＞。

建立使用 FsiDataExtension 的報表

此章節包含一個簡略的逐步解說，示範如何建立一個使用範例資料延伸模組的範例報表。

ms160918.note(zh-tw,SQL.90).gif附註：
您必須在「報表設計師」及報表伺服器中，部署範例檔案共用資料延伸模組，然後才能建立報表。您還必須為延伸模組啟用一般查詢設計師。如需詳細資訊，請參閱本主題前文中的「部署 FsiDataExtension」。

若要建立報表專案

  1. 按一下 [開始]，依序指向 [所有程式] 和 [Microsoft SQL Server 2005]，再按一下 [Business Intelligence Development Studio]。

  2. 在 [檔案] 功能表上，指向 [新增]，然後按一下 [專案]。

  3. 在 [專案類型] 清單中，按一下 [商務智慧專案]。

  4. 在 [範本] 清單中，按一下 [報表伺服器專案]。

  5. 在 [名稱] 中輸入 FsiReportProject。

  6. 按一下 [確定] 以建立報表專案。

若要建立報表

  1. 在 [專案] 功能表上，按一下 [加入新項目]。

  2. 在 [分類] 清單中，按一下 [報表專案]。

  3. 在 [範本] 清單中，按一下 [報表]。

  4. 在 [名稱] 方塊中，輸入 FsiReport，然後按一下 [開啟]。

若要加入使用範例資料延伸模組的資料來源

  1. 在 [資料] 檢視中，從 [資料集] 選取 [<新增資料集…>]。

    [資料來源] 對話方塊隨即開啟。

  2. 在 [一般] 索引標籤的 [名稱] 文字方塊中，輸入 FsiDataSource。

  3. 在 [類型] 清單中，選取 [檔案共用資訊]。

  4. 保留 [ConnectionString] 為空白。範例資料延伸模組不使用連接字串。

  5. 在 [認證] 索引標籤中，按一下其中一個伺服器登入類型。您可以輸入範例資料延伸模組將要存取之檔案共用的使用者名稱和密碼。依次按一下 [使用 Windows 驗證 (整合式安全性)]、[使用特定的使用者名稱和密碼]，然後輸入認證，或按一下 [提示認證]，然後輸入提示字串。

    ms160918.security(zh-tw,SQL.90).gif安全性注意事項：
    可能的話，請使用 Windows 驗證。除非已經快取您的認證，否則每次您嘗試存取網路檔案共同時，就會提示您輸入網路認證。

  6. 按一下 [確定] 以儲存資料來源。

若要檢視資料集

  1. 在 [資料] 檢視中，會顯示一般查詢設計師。從 [命令類型] 選取 [文字]。

  2. 在一般查詢設計師工具列正下方的查詢窗格，輸入網路上可用的網路檔案共用路徑。例如，輸入 \\Computer1\Public。

  3. 在一般查詢設計師的工具列上，按一下 [執行] (!) 按鈕。

    檔案共用資料應該顯示在下方的結果窗格。

若要設計報表配置

  1. 在 [配置] 檢視中，按一下 [工具箱] 中的 [資料表]。

  2. 將 [資料表] 控制項拖曳至設計介面。

  3. 從 [欄位] 視窗，將 [名稱] 方塊拖曳至 [詳細資料] 資料列的第一個資料格。視需要將其他欄位加入至資料表。

若要預覽報表

  1. 按一下 [預覽] 索引標籤預覽報表。依據 FsiDataSource 認證設定的不同，可能需要輸入使用者名稱和密碼。

請參閱

工作

編譯和執行程式碼範例
SQL Server Reporting Services 範例

其他資源

延伸模組範例 (Reporting Services)
Implementing a Data Processing Extension

說明及資訊

取得 SQL Server 2005 協助

變更歷程記錄

版本 歷程記錄

2005 年 12 月 5 日
變更的內容：
  • 已變更產生金鑰檔的指示，包括金鑰檔的名稱和位置。