dotnet/samples

This repository holds all the code examples that accompany the official .NET documentation. .NET is Microsoft's platform for building software applications, and the documentation explains how to use it. The samples in this repo are the runnable programs that readers can download and try alongside the written explanations. The collection covers a wide range of topics and is organized to mirror the structure of the documentation itself. Many articles link to one or more sample programs. Each sample has its own readme file explaining what it demonstrates and pointing back to the relevant documentation page. The samples are written primarily in C#, but the repo also contains F# and Visual Basic examples. Most of them are designed to work on any operating system that .NET supports, since they are built as console applications. Some samples are specific to Windows or to particular frameworks like web or desktop applications, and those include their own requirements. Contributors who want to add new samples are expected to make sure the code compiles and runs, follows the project's coding style, and handles errors appropriately. Issues and feature requests are tracked in the dotnet/docs repository rather than this one, and the recommended way to report a problem with a sample is through the feedback link at the bottom of the documentation page it belongs to. Running any sample is straightforward: download the folder, open a terminal, and run two commands to build and start the program. The .NET tooling handles fetching any additional pieces the sample depends on.