Skip to content
Sample code referenced by the .NET documentation
C# C++ Visual Basic .NET HTML JavaScript C Other
Branch: master
Clone or download

Latest commit

dependabot-preview Bump xunit.runner.visualstudio (#3646)
Bumps [xunit.runner.visualstudio](https://github.com/xunit/visualstudio.xunit) from 2.4.1 to 2.4.2.
- [Release notes](https://github.com/xunit/visualstudio.xunit/releases)
- [Commits](https://github.com/xunit/visualstudio.xunit/commits/v2.4.2)

Signed-off-by: dependabot-preview[bot] <support@dependabot.com>

Co-authored-by: dependabot-preview[bot] <27856297+dependabot-preview[bot]@users.noreply.github.com>
Latest commit 2b3d6c8 Jun 3, 2020

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.dependabot Re-generate dependabot config file (#2882) May 13, 2020
.github Update sample-update-request.md (#3625) May 26, 2020
async/async-and-await Normalize trailing spaces (#2815) Apr 21, 2020
core Bump xunit.runner.visualstudio (#3660) Jun 3, 2020
csharp Bump xunit.runner.visualstudio (#3656) Jun 3, 2020
framework Bump xunit.runner.visualstudio (#3646) Jun 3, 2020
machine-learning Format codes based on .editorconfig, Part 3 (#2871) May 11, 2020
mef/simple-calculator/vb Bump System.ComponentModel.Composition in /mef/simple-calculator/vb (#… May 13, 2020
windowsforms Update title bar text (#3595) May 27, 2020
wpf Remove blank lines (#1901) Jan 10, 2020
.editorconfig Update .editorconfig (#1895) Jan 7, 2020
.gitattributes New in csharp7 (#1188) Nov 13, 2016
.gitignore Remove local .editorConfig Jan 7, 2020
.markdownlint.json Add markdownlint with GitHub actions (#1898) Jan 9, 2020
CODE_OF_CONDUCT.md moved period Nov 14, 2017
CONTRIBUTING.md Update link to Contributing Guide to point to new location (#3597) May 16, 2020
LICENSE Fixed smart quotes (#2147) May 14, 2017
LICENSE-CODE Legal updates from CELA (#1765) Mar 21, 2017
README.md Update README.md (#3624) May 26, 2020
SECURITY.md Fix Markdownlint issues (#2054) Mar 10, 2020
ThirdPartyNotices.md Fix Markdownlint issues (#2054) Mar 10, 2020
azure-pipelines.yml Update azure-pipelines.yml for Azure Pipelines Oct 22, 2019

README.md

.NET Samples

Markdownlint

This repo contains all the sample code that is part of any topic under the .NET documentation. There are several different projects that are organized in sub-folders. These sub-folders are organized similarly to the organization of the docs for .NET. Some of the articles will have more than one sample associated with them.

The content team tracks issues for .NET documentation in the dotnet/docs and dotnet/dotnet-api-docs repositories. Issues are turned off on this repository. File issues against existing samples and suggestions for new samples in those repositories. If you're not sure where, choose dotnet/docs. This process keeps the issues associated with the articles that explain the concepts for each sample. The best process is to file an issue from the feedback control at the bottom of each docs page:

  • For existing samples, file the issue on the page with the sample.
  • To suggest new samples, file the issue on the index page where you want to see the new sample.

The code in this repository represents programs that demonstrate application or library scenarios. These samples often use more than one technology, feature, or toolkit. Each sample has a readme.md file that explains the sample and links to resources for more information.

Samples should be buildable projects. Those projects should build and run on the widest set of platforms possible for the given sample. In practice, that means building .NET Core-based console applications where possible. Samples that are specific to the web or a UI framework should add those tools as needed. Examples include web applications, mobile apps, WPF or WinForms apps, and so on.

We are working toward having a CI system in place for all code. When you make any updates to samples, make sure each update is part of a buildable project. Ideally, add tests for correctness on samples as well.

Building a sample

Build any .NET Core sample using the .NET Core CLI, which is installed with the .NET Core SDK. Then run these commands from the CLI in the directory of any sample:

dotnet build
dotnet run

These will install any needed dependencies, build the project, and run the project respectively.

Multi-project samples have instructions in their root directory in a README.md file.

Except where noted, all samples build from the command line on any platform supported by .NET Core. There are a few samples that are specific to Visual Studio and require Visual Studio 2017 or later. In addition, some samples show platform-specific features and will require a specific platform. Other samples and snippets require the .NET Framework and will run on Windows platforms, and will need the Developer Pack for the target Framework version.

Creating new samples

If you wish to add a code sample:

  1. Your sample must be part of a buildable project. Where possible, the projects should build on all platforms supported by .NET Core. Exceptions to this are samples that demonstrate a platform-specific feature or platform-specific tool.

  2. Your sample should conform to the runtime coding style to maintain consistency.

    • Additionally, we prefer the use of static methods rather than instance methods when demonstrating something that doesn't require instantiating a new object.
  3. Your sample should include appropriate exception handling. It should handle all exceptions that are likely to be thrown in the context of the sample. For example, a sample that calls the Console.ReadLine method to retrieve user input should use appropriate exception handling when the input string is passed as an argument to a method. Similarly, if your sample expects a method call to fail, the resulting exception must be handled. Always handle the specific exceptions thrown by the method, rather than base class exceptions such as Exception or SystemException.

  4. If your sample builds a standalone package, you must include the runtimes used by our CI build system, in addition to any runtimes used by your sample:

    • win7-x64
    • win8-x64
    • win81-x64
    • ubuntu.16.04-x64

We will have a CI system in place to build these projects shortly.

To create a sample:

  1. File an issue or add a comment to an existing one that you are working on it.

  2. Write the topic that explains the concepts demonstrated in your sample (example: docs/standard/linq/where-clause.md).

  3. Write your sample (example: WhereClause-Sample1.cs).

  4. Create a Program.cs with a Main entry point that calls your samples. If there is already one there, add the call to your sample:

    public class Program
    {
        public void Main(string[] args)
        {
            WhereClause1.QuerySyntaxExample();
    
            // Add the method syntax as an example.
            WhereClause1.MethodSyntaxExample();
        }
    }
  5. Don't check in the solution file if it contains only one project.

To build and run your sample:

  1. Go to the sample folder and build to check for errors:

    dotnet build
  2. Run your sample:

    dotnet run
  3. Add a README.md to the root directory of your sample.

    This should include a brief description of the code, and refer people to the article that references the sample.

You can’t perform that action at this time.