適用於 Azure AI 搜尋服務的 C# 範例
了解示範 Azure AI 搜尋服務解決方案功能和工作流程的 C# 程式碼範例。 這些範例會使用適用於 Azure SDK for .NET 的 Azure AI 搜尋服務用戶端程式庫，您可以透過下列連結加以探索。
SDK 範例
Azure SDK 開發小組示範 API 使用方式的程式碼範例。 您可以在 GitHub 上的 Azure/azure-sdk-for-net/tree/main/sdk/search/Azure.Search.Documents/samples 中找到這些範例。
| 範例 | 描述 |
|---|---|
| "Hello world" (同步) | 示範如何使用同步方法來建立用戶端、進行驗證及處理錯誤。 |
| "Hello world" (非同步) | 示範如何使用非同步方法來建立用戶端、進行驗證及處理錯誤。 |
| 服務層級作業 | 示範如何建立索引、索引子、資料來源、技能集和同義字對應。 此範例也會示範如何取得服務統計資料，以及如何查詢索引。 |
| 索引作業 | 示範如何在現有索引上執行動作，在此例中，會示範如何取得儲存在索引中的文件計數。 |
| FieldBuilderIgnore | 示範使用不受支援資料類型的技術。 |
| 為文件編製索引 (推送模型) | 「推送」模型的索引編製，您可以從中將 JSON 承載傳送至服務上的索引。 |
| 加密金鑰範例 | 示範如何使用客戶自控加密金鑰來提升對於敏感性內容的保護能力。 |
| 向量搜尋範例 | 說明如何使用 Azure SDK for .NET 為向量欄位編製索引，並執行向量搜尋。 |
| 語意排名範例 | 說明如何使用 Azure SDK for .NET 在索引中設定語意排名，並叫用語意查詢。 |
文件範例
來自 Azure AI 搜尋服務小組的程式碼範例會示範功能和工作流程。 在教學課程、快速入門，以及詳細說明程式碼的作法文章中會參考下列所有範例。 您可以在 GitHub 上的 Azure-Samples/azure-search-dotnet-samples 中和 Azure-Samples/search-dotnet-getting-started 中找到這些範例。
提示
請嘗試利用範例瀏覽器在 GitHub 中搜尋 Microsoft 程式碼範例，並依產品、服務和語言進行篩選。
| 程式碼範例 | 相關文章 | 目的 |
|---|---|---|
| create-mvc-app | 教學課程：將搜尋新增至 ASP.NET Core (MVC) 應用程式 | 雖然大部分範例都是主控台應用程式，但此 MVC 範例會使用網頁來處理範例 Hotels 索引，以示範基本搜尋、分頁，以及其他伺服器端行為。 |
| 快速入門 | 快速入門：使用 Azure SDK 進行全文檢索搜尋 | 涵蓋使用範例資料在 C# 建立、載入和查詢搜尋索引的基本工作流程。 |
| quickstart-semantic-search | 快速入門：使用 Azure SDK 進行語意排名 | 顯示用於叫用語意排名的索引結構描述和查詢要求。 |
| search-website | 教學課程：將搜尋新增至 Web 應用程式 | 示範端對端搜尋應用程式，其中包含豐富的用戶端加上裝載應用程式和處理搜尋要求的元件。 |
| tutorial-ai-enrichment | 教學課程：使用 AI 從 Azure Blob 產生可搜尋的內容 | 說明如何設定索引子和技能集。 |
| multiple-data-sources | 教學課程：從多個資料來源編製索引。 | 將來自兩個資料來源的內容合併成一個搜尋索引。 |
| Optimize-data-indexing | 教學課程：使用推送 API 將索引編製最佳化。 | 示範將資料推送至搜尋索引的最佳化技術。 |
| DotNetHowTo | 如何使用.NET 用戶端程式庫 | 逐步講述基本工作流程，但內容更加深入，並且會討論 API 的使用方式。 |
| DotNetToIndexers | 教學課程：編製 Azure SQL 資料索引 | 說明如何設定具有排程、欄位對應和參數的 Azure SQL 索引子。 |
| DotNetHowToEncryptionUsingCMK | 如何設定客戶自控金鑰以進行資料加密 | 說明如何建立使用客戶金鑰加密的物件。 |
| DotNetVectorDemo | 讀我檔案 | 建立、載入及查詢向量索引。 |
| DotNetIntegratedVectorizationDemo | 讀我檔案 | 擴充向量工作流程，以包含用於資料區塊化和內嵌的技能型自動化。 |
加速器
加速器是端對端解決方案，其中包含您可以調整的程式碼和文件，以適合您自行實作的特定案例。
| 範例 | 存放庫 | 描述 |
|---|---|---|
| 搜尋 + QnA Maker 加速器 | search-qna-maker-accelerator | 結合搜尋和 QnA Maker 功能的解決方案。 請參閱即時示範網站。 |
| 知識採礦解決方案加速器 | azure-search-knowledge-mining | 包含範本、支援檔案和分析報告，可協助您為端對端知識採礦解決方案建立原型。 |
示範
示範存放庫會為示範中顯示的範例或案例，提供概念證明原始程式碼。 示範解決方案並非專為客戶調整而設計。
| 範例 | 存放庫 | 描述 |
|---|---|---|
| Covid-19 搜尋應用程式 | covid19search | Azure AI 搜尋服務型 Covid-19 搜尋應用程式的原始程式碼存放庫 |
| JFK 示範 | AzureSearch_JFK_Files | 深入了解 JFK 解決方案。 |
其他範例
下列範例也是由 Azure AI 搜尋服務小組發佈，但文件中不會參考。 相關聯的讀我檔案會提供使用指示。
| 範例 | 存放庫 | 描述 |
|---|---|---|
| 查詢多個服務 | azure-search-dotnet-scale | 跨多個搜尋服務發出單一查詢，並將結果合併成單一頁面。 |
| 檢查儲存體 | azure-search-dotnet-utilities | 叫用 Azure 函式，依排程檢查搜尋服務儲存體。 |
| 匯出索引 | azure-search-dotnet-utilities | 分割和匯出大型索引的 C# 主控台應用程式。 |
| 備份與還原索引 | azure-search-dotnet-utilities | 將索引從某個服務複製到另一個服務的 C# 主控台應用程式，其會在過程中，使用索引結構描述和文件在電腦上建立 JSON 檔案。 |
| 使用 Microsoft Entra ID 編製 Data Lake Gen2 索引 | azure-search-dotnet-utilities | 此原始程式碼會示範透過 Microsoft Entra ID 和角色型存取控制來加以保護的 Azure Data Lake Gen2 檔案和資料夾，其索引子連線和索引編製。 |
| 搜尋彙總 | azure-search-dotnet-utilities | 概念證明原始程式碼，其會示範如何從搜尋索引取得彙總，然後依這些彙總進行篩選。 |
| 進階技能 | azure-search-power-skills | 可以納入自有解決方案中的可取用自訂技能原始程式碼。 |