Параметры, текстовый редактор, C#, дополнительно

Используйте страницу "Дополнительные параметры" для изменения параметров форматирования редактора, рефакторинг кода и комментариев xml-документации для C#. Чтобы получить доступ к этой странице параметров, выберите "Параметрыинструментов>" и выберите "Текстовый редактор>" C#>Advanced.

Анализ

Использование директив

• Сначала при сортировке поместите директивы System

  При выборе команда Remove and Sort Usings в меню правой кнопкой мыши сортирует директивы и помещает using пространства имен System в верхней части списка.

  Перед сортировкой:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  После сортировки:

  using System;
  using System.Collections.Generic;
  using System.Linq;
  using AutoMapper;
  using FluentValidation;
  using Newtonsoft.Json;
  

• Разделение групп директив using

  При выборе команда Remove and Sort Usings в меню правой кнопкой мыши разделяет using директивы, вставляя пустую строку между группами директив с одинаковым корневым пространством имен.

  Перед сортировкой:

  using AutoMapper;
  using FluentValidation;
  using System.Collections.Generic;
  using System.Linq;
  using Newtonsoft.Json;
  using System;
  

  После сортировки:

  using AutoMapper;
  
  using FluentValidation;
  
  using Newtonsoft.Json;
  
  using System;
  using System.Collections.Generic;
  using System.Linq;
  

• Предложение использования типов в сборках .NET Framework

• Предложение использования типов в пакетах NuGet

  При выборе этих параметров можно установить пакет NuGet и добавить директиву using для неуправляемых типов.

  

• Добавление отсутствующих директив using для вставки

  При выборе using этого параметра директивы автоматически добавляются в код при вставе типа в файл.

Выделение

• Выделение ссылок на символ под курсором

  При расположении курсора внутри символа или при щелчке символа выделены все экземпляры этого символа в файле кода.

Очертание

• Введите режим структурирования при открытии файлов

  При выборе автоматически описывает файл кода, который создает свертые блоки кода. При первом открытии файла #regions блоки и неактивные блоки кода свернуты.

• Показать разделители строк процедуры

  Текстовый редактор указывает визуальную область процедур. Строка рисуется в .cs исходных файлах проекта в расположениях, перечисленных в следующей таблице:

  Расположение в исходном файле .cs	Пример расположения строки
  После закрытия конструкции объявления блока	— в конце класса, структуры, модуля, интерфейса или перечисления — после свойства, функции или вложенной — не между предложениями get и set в свойстве
  После набора конструкций одной строки	— После инструкций импорта перед определением типа в файле класса — после переменных, объявленных в классе, перед любыми процедурами
  После объявлений одной строки (объявления уровня без блоков)	— после инструкций импорта наследует инструкции, объявления переменных, объявления событий, объявления делегатов и инструкции DLL

Блочные руководства по структуре

Установите эти флажки, чтобы отобразить пунктирные вертикальные линии между фигурными скобками ({}) в коде. Затем можно легко увидеть отдельные блоки кода для конструкций уровня объявления и уровня кода.

Комментарии

• Создание комментариев xml-документации для ///

  При выборе вставляет XML-элементы для примечаний XML-документации после ввода /// примечания. Дополнительные сведения о XML-документации см. в комментариях к XML-документации (руководство по программированию на C#).

Метод извлечения

• Не помещайте ссылки или не помещайте их в настраиваемую структуру

  Снимите этот флажок, чтобы избежать мощного клонирования структур путем повторного устранения существующих объектов структуры при извлечении выражения в вызов метода.

  Пример

  Предполагается следующее class и struct существует в коде:

  public struct CustomStruct
  {
      private int Count;
  
      public int Bump => ++Count;
  }
  
  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i += cs.Bump;   // select this line
      }
  }
  

  Если параметр "Не помещать ссылку или не выходить на настраиваемую структуру" снят, функция "Извлечь метод" создает следующее:

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         NewMethod(ref cs, ref i);
      }
  
      private static void NewMethod(ref CustomStruct cs, ref int i)
         => i += cs.Bump;
  }
  

  Если установлен флажок "Не помещать ссылку или не выходить на пользовательскую структуру", функция "Извлечь метод" создает следующее:

  public class CustomClass
  {
      public void DoIt()
      {
         CustomStruct cs = new CustomStruct();
         int i = 0;
  
         i = NewMethod(cs, i);
      }
  
      private static int NewMethod(CustomStruct cs, int i)
      {
         i += cs.Bump;
         return i;
      }
  }
  

Встроенные подсказки

• Указания по имени встроенных параметров

  При выборе вставляет указания имени параметра для литералы, литералы и экземпляры объектов перед каждым аргументом в вызовах функций.

  

• Встроенные подсказки типов

  При выборе вставляет подсказки типов для переменных с выводными типами и типами лямбда-параметров.

  

Поле наследования

• При выборе добавьте значки в поля, представляющие реализации и переопределения кода. Щелкнув значки поля наследования, будут отображаться параметры наследования, которые можно выбрать для перехода.

  

См. также

• Практическое руководство. Вставка XML-комментариев для создания документации
• Документируйте код с помощью xml-комментариев (руководство по C#)
• Настройка параметров редактора для конкретного языка
• C# IntelliSense