Developers like to learn by looking at code, and so the Azure SDK comes with a myriad of code samples in the form of short code snippets, sample applications, and how-to guides. This document describes where to find all these resources.
The Azure SDK repository is organized in the following folder structure, with the main sample locations highlighted using bold font.
/samples (this folder)
README.md (this file)
/sdk (folder containing sources for all SDK packages)
/<service> (e.g. storage)
/<package> (e.g. Azure.Storage.Blobs)
README.md (package READMEs contain hello world samples)
/samples (package-specific samples)
/src
/tests
Each package folder contains a package-specific README.md file. Most of these README files contain Hello World code samples illustrating basic usage of the the APIs contained in the package. For example, you can find Hello World samples for the Azure.Storage.Blobs package here.
Each package folder contains a subfolder called samples with additional code samples. These samples can be either short programs contained in *.cs files, or more complete how-to guides (code samples and some commentary) contained in *.md files. You can find shortcuts to main how-to guides in the How-To Guides List section below.
Sometimes we want to illustrate how several APIs or even packages work together in a context of a more complete program. For these cases, we created sample applications that you can look at, download, compile, and execute. These application samples are located on https://docs.microsoft.com/samples/.
This section lists main how-to guides for the most commonly used APIs and most common scenarios, i.e. this section does not attempt to be a complete directory of guides contained in this repository.
- How to access HTTP response details
- How to mock
- How to configure retries
- How to configure proxies
- How to configure, access, and analyze logging information (TODO)