Getting Started with Azure Search using .NET

Data ultimo aggiornamento: 10/11/2017
Modifica in GitHub

This sample includes three projects that are meant to help when getting started with Azure Search and .NET. It leverages the Azure Search .NET SDK as well as many best practices. The first sample DotNetHowTo is a simple .NET Core console application that shows how to:

  • Create and Delete an Azure Search index
  • Upload Documents to an Azure Search index
  • Search & Filter documents within an index

The second sample DotNetHowToIndexers is a simple .NET Core console application that shows how to:

  • Create and Delete an Azure Search index
  • Create an Azure Search indexer for Azure SQL

The third sample DotNetHowToSynonyms demonstrates how to incorporate the Synonyms feature in your application step by step:

  • Create an Azure Search index
  • Search documents using terms that do not appear in the indexed documents
  • Define and upload synonym rules
  • Repeat the search

Lastly, the sample AzureSearchDotNetSample is a more detailed example that demonstrates:

  • How to use the Azure Search Indexer to ingest data from common stores (such as Azure SQL) to populate an Azure Search index
  • A simple ASP.net MVC application that allow you to search and view results from an Azure Search index

Running the DotNetHowTo sample

  • Open the DotNetHowTo.sln project in Visual Studio
  • Update the appsettings.json with the service and api details of your Azure Search service
  • Compile and Run the project

Running the DotNetHowToIndexers sample

  • Open the DotNetHowToIndexers.csproj project in Visual Studio.
  • Update the appsettings.json with your service name, api key, and connection string to your Azure SQL database.
  • Run the data\hotels.sql script against your Azure SQL database.
  • Compile and Run the project using Visual Studio 2017.
  • Alternatively, download the .NET Core SDK at https://www.microsoft.com/net/core and issue a dotnet run command from the DotNetHowToIndexers directory.

Running the DotNetHowToSynonyms sample

  • Open the DotNetHowToSynonyms.sln project in Visual Studio
  • Update the App.config with the service and api details of your Azure Search service
  • Compile and Run the project

Running the AzureSearchDotNetSample sample

  • Open the AzureSearchDotNetSample.sln project in Visual Studio
  • Update the Web.config in the SimpleSearchMVCApp project with the service and api details of your Azure Search service
  • Update the App.config in the DataIndexer project with the service and api details of your Azure Search service
  • Compile and Run the DataIndexer project to create an Azure Search and populate it with content from an Azure SQL database
  • Compile and Run the SimpleSearchMVCApp project to search and view the results from this index

More information

For more details on the "how-to" sample, please refer to this article:

For more details on the "how-to" sample for synonyms, please refer to this article:


This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.