Примеры и руководства .NET.NET samples and tutorials

Документация по .NET содержит набор примеров и руководств, которые помогают изучить .NET.The .NET documentation contains a set of samples and tutorials that teach you about .NET. Из этой статьи вы узнаете, как находить, просматривать и скачивать примеры и руководства для .NET Core, ASP.NET Core и C#.This topic describes how to find, view, and download .NET Core, ASP.NET Core, and C# samples and tutorials. Ресурсы, посвященные языку программирования F#, доступны на сайте F# Foundation.Find resources to learn the F# programming language on the F# Foundation's site. Если вы хотите изучать язык C# в интерактивном редакторе кода, ознакомьтесь с этим интерактивным руководством, а затем переходите к следующему.If you're interested in exploring C# using an online code editor, start with this interactive tutorial and continue with C# interactive tutorial. Инструкции по просмотру и скачиванию примеров кода см. в разделе Просмотр и скачивание примеров.For instructions on how to view and download sample code, see the Viewing and downloading samples section.

.NET Core.NET Core

ПримерыSamples

Тестирование модулей в .NET Core с помощью команды dotnet-testUnit Testing in .NET Core using dotnet test

Из этого руководства вы узнаете, как создать веб-приложение ASP.NET Core и соответствующие модульные тесты.This guide shows you how to create an ASP.NET Core web app and associated unit tests. Сначала создается простое приложение веб-службы, а потом добавляются тесты.It starts by creating a simple web service app and then adds tests. Затем создаются дополнительные тесты для внедрения новых функций.It continues with creating more tests to guide implementing new features. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

УчебникиTutorials

Написание консольных приложений .NET Core с помощью средств командной строки: пошаговое руководствоWriting .NET Core console apps using the CLI tools: A step-by-step guide

В этом руководстве показано, как с помощью средств интерфейса командной строки в .NET Core создавать кроссплатформенные консольные приложения.This guide shows you how to use the .NET Core CLI tooling to build cross-platform console apps. Мы начнем с самого простого консольного приложения, а затем охватим несколько проектов, включая тестирование.It starts with a basic console app and eventually spans multiple projects, including testing. Пошаговое добавление функций позволит наращивать знания в ходе работы.You add features step-by-step, building your knowledge as you go. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Написание библиотек с помощью кроссплатформенных средствWriting Libraries with Cross Platform Tools

В этом примере рассматривается создание библиотек для .NET с помощью кроссплатформенных средств интерфейса командной строки.This sample covers how to write libraries for .NET using cross-platform CLI tools. Они предоставляют эффективный и низкоуровневый интерфейс, работающий в любых поддерживаемых операционных системах.These tools provide an efficient and low-level experience that works across any supported operating system. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

ASP.NET CoreASP.NET Core

См. руководства по ASP.NET Core.See the ASP.NET Core tutorials. Многие статьи по ASP.NET Core содержат ссылки на специально созданные примеры.Many articles in the ASP.NET Core documentation have links to samples written for them.

C# - языкC# language

ПримерыSamples

ИтераторыIterators

В этом примере демонстрируется синтаксис и функции для создания и использования итераторов C#.This sample demonstrates the syntax and features for creating and consuming C# iterators. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

ИндексаторыIndexers

В этом примере демонстрируется синтаксис и функции для индексаторов C#.This sample demonstrates the syntax and features for C# indexers. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Делегаты и событияDelegates and Events

В этом примере демонстрируется синтаксис и функции для делегатов и событий C#.This sample demonstrates the syntax and features for C# delegates and events. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub. Второй пример, посвященный событиям, находится в том же репозитории.A second sample focused on events is also in the same repository.

Деревья выраженийExpression Trees

В этом примере демонстрируется ряд проблем, которые можно устранить с помощью деревьев выражений.This sample demonstrates many of the problems that can be solved by using Expression Trees. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Примеры LINQLINQ Samples

В этой серии примеров демонстрируются многие функции встроенного языка запросов (LINQ).This series of samples demonstrate many of the features of Language Integrated Query (LINQ). Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Пример управляемого COM-сервераManaged COM server Sample

В примере COM-сервера показано создание управляемого COM-сервера, его глобальная регистрация и использование через RegFree COM.The COM server sample demonstrates the creation of a managed COM server and how it can be globally registered or consumed via RegFree COM.

Пример Microsoft Office PIAMicrosoft Office PIA Sample

В примере ExcelDemo демонстрируется использование Microsoft Office PIA в .NET Core.The ExcelDemo sample demonstrates the consumption of Microsoft Office PIAs in .NET Core.

УчебникиTutorials

Консольное приложениеConsole Application

В этом руководстве демонстрируется консольный ввод-вывод, структура консольного приложения и основные сведения о модели асинхронного программирования на основе задач.This tutorial demonstrates Console I/O, the structure of a console app, and the basics of the task-based asynchronous programming model. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Клиент RESTREST Client

В этом руководстве демонстрируется веб-взаимодействие, сериализация JSON и объектно-ориентированные функции языка C#.This tutorial demonstrates web communications, JSON serialization, and object-oriented features of the C# language. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Работа с LINQWorking with LINQ

В этом учебнике демонстрируется множество функций LINQ и элементы языка, которые их поддерживают.This tutorial demonstrates many of the features of LINQ and the language elements that support it. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Начало работы с .NET Core в macOS с помощью Visual Studio для MacGetting started with .NET Core on macOS using Visual Studio for Mac

В этом руководстве показано, как создать простое консольное приложение .NET Core с помощью Visual Studio для Mac.This tutorial shows you how to build a simple .NET Core console app using Visual Studio for Mac.

Создание полноценного решения .NET Core на базе macOS с помощью Visual Studio для MacBuilding a complete .NET Core solution on macOS using Visual Studio for Mac

Этот учебник описывает, как выполнить сборку полноценного решения .NET Core, включающего многоразовую библиотеку и модульное тестирование.This tutorial shows you how to build a complete .NET Core solution that includes a reusable library and unit testing.

Создание приложения .NET Core, поддерживающего подключаемые модулиCreating a .NET Core application that supports plugins

В этом руководстве показано, как создать простое приложение в .NET Core, которое поддерживает архитектуру подключаемых модулей.This tutorial shows you how to build a simple application on .NET Core that supports a plugin architecture. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Развертывание в контейнерыDeploying to containers

Запуск приложений ASP.NET MVC в контейнерах WindowsRunning ASP.NET MVC Applications in Windows Docker Containers

В этом руководстве показано, как развернуть существующее приложение ASP.NET MVC в контейнер Windows Docker.This tutorial demonstrates how to deploy an existing ASP.NET MVC app in a Windows Docker Container. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Запуск консольных приложений .NET Framework в контейнерах WindowsRunning .NET Framework Console Applications in Windows Containers

В этом руководстве показано, как развернуть существующее консольное приложение в контейнер Windows.This tutorial demonstrates how to deploy an existing console app in a Windows container. Готовый пример доступен в репозитории dotnet/samples на сайте GitHub.The completed sample is available in the dotnet/samples repository on GitHub.

Просмотр и скачивание примеровViewing and downloading samples

Во многих статьях показан исходный код и примеры, которые можно просмотреть и скачать на сайте GitHub.Many topics show source code and samples that are available for viewing or download from GitHub. Чтобы просмотреть пример, просто перейдите по ссылке на него.To view a sample, just follow the sample link. Чтобы скачать код, выполните следующие действия:To download the code, follow these instructions:

  1. Скачайте репозиторий, содержащий пример кода, выполнив одну из следующих процедур:Download the repository that contains the sample code by performing one of the following procedures:
    • Загрузите ZIP-файл репозитория на свой компьютер.Download a ZIP of the repository to your local system. Распакуйте архив.Un-ZIP the compressed archive.
    • Создайте ответвление репозитория и клонируйте его на свой компьютер.Fork the repository and clone the fork to your local system. Создание и клонирование ответвления позволяет участвовать в работе над документами путем сохранения изменений в ответвлении с последующим созданием запроса на включение внесенных изменений в официальный репозиторий docs.Forking and cloning permits you to make contributions to the documentation by committing changes to your fork and then creating a pull request for the official docs repository. Дополнительные сведения см. в руководстве по участию в работе над документацией .NET и руководстве по участию в работе над документацией ASP.NET.For more information, see the .NET Documentation Contributing Guide and the ASP.NET Docs Contributing Guide.
    • Клонируйте репозиторий локально.Clone the repository locally. Если вы клонируете репозиторий docs непосредственно на свой компьютер, вы не сможете сохранять изменения напрямую в официальном репозитории и, соответственно, не сможете участвовать в работе над документацией в дальнейшем.If you clone a docs repository directly to your local system, you won't be able to make commits directly against the official repository, so you won't be able to make documentation contributions later. Чтобы сохранить возможность последующего участия в работе над документацией, используйте описанную выше процедуру ответвления и клонирования.Use the fork and clone procedure previously described if you want to preserve the opportunity to contribute to the documentation later.
  2. Откройте в репозитории папку с примером.Navigate within the repository's folders to the sample's location. Относительный путь к папке с примером отображается в адресной строке браузера при переходе по ссылке на пример.The relative path to the sample's location appears in your browser's address bar when you follow the link to the sample.
  3. Запустить пример можно несколькими способами:To run a sample, you have several options:
    • Используйте средства интерфейса командной строки dotnet: в окне консоли перейдите в папку с примером и используйте команды интерфейса командной строки dotnet.Use the dotnet CLI tools: In a console window, navigate to the sample's folder and use dotnet CLI commands.
    • Воспользуйтесь программой Visual Studio или Visual Studio для Mac: откройте пример, последовательно щелкнув "Файл" > "Открыть" > "Проект/решение", перейдите в папку проекта, содержащую пример, и выберите файл проекта (.csproj или .fsproj).Use Visual Studio or Visual Studio for Mac: Open the sample by selecting File > Open > Project/Solution from the menu bar, navigate to the sample project folder, and select the project file (.csproj or .fsproj).
    • Воспользуйтесь программой Visual Studio Code: откройте пример, последовательно щелкнув "Файл" > "Открыть папку" и выбрав папку проекта, содержащую пример.Use Visual Studio Code: Open the sample by selecting File > Open Folder from the menu bar and selecting the sample's project folder.
    • Воспользуйтесь другой средой IDE, которая поддерживает проекты .NET Core.Use a different IDE that supports .NET Core projects.