This sample includes several 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 DotNetHowTo sample 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 DotNetETagsExplainer sample shows how to use ETags to update Azure Search resources safely in the presence of concurrency.

The DotNetHowToIndexers sample 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 DotNetHowToSynonyms sample 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

The DotNetHowToSecurityTrimming sample demonstrates how to implement document-level security in Azure Search using filters.

The DotNetSample project 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

The DotNetHowToAutocomplete sample demonstrates several techniques for adding auto-complete and suggestions to your search experience. It demonstrates the following:

• Implement a search input box
• Add support for an auto-complete list that pulls from a remote source
• Retrieve suggestions and auto-complete using the .Net SDK and REST API
• Support client-side caching to improve performance

• 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

• Open the DotNetETagsExplainer.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

• 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.

• 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

See Security filters for trimming Azure Search results using Active Directory identities

• 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

• Open the DotNetHowToAutocomplete.sln project in Visual Studio
• Compile and Run the project

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

• How to use Azure Search from a .NET Application.

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

• Synonym C# tutorial for Azure Search.

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.