Значения этого типа выглядят следующим образом: "01234567-89AB-CDEF-0123-456789ABCDEF" или "{01234567-89AB-CDEF-0123-456789ABCDEF}". Допустимый идентификатор C++. Задает, какое максимальное число элементов коллекции может показываться одновременно. Если число элементов коллекции превысит это значение, в конце будет создан специальный узел, который можно развернуть и просмотреть больше элементов. Максимальное число показываемых элементов в представлении можно настраивать. Большее значение позволяет показать больше элементов за один раз, а меньшее значение увеличивает производительность Visual Studio при разворачивании пользовательского списка объектов. В целом, чем более сложна логика обхода, тем меньшее число элементов стоит показывать в одном представлении, чтобы сохранить скорость реагирования интерфейса IDE. Допустимое максимальное число элементов в представлении — от 1 до 50 000. Если этот атрибут не указан, будет использоваться значение по умолчанию — 5 000. Указывает условие, при котором этого элемент является активным. Результатом вычисления этого выражения должно быть логическое значение. Задает необязательность элемента. Если не получится проанализировать необязательный элемент, то можно использовать оставшиеся элементы во вложенной записи <Тип>. Если не удастся проанализировать обязательный элемент, это приведет к тому, что весь вложенный элемент <Type> будет считаться недопустимыми. Все элементы по умолчанию считаются обязательными, до тех пор пока не указано значение Optional="true". Задает разделенный точками с запятыми список представлений, в которых должен быть показан этот элемент. Представление объекта управляется через указатель формата ",view(<name>)". Задает разделенный точками с запятыми список представлений, в которых должен быть скрыт этот элемент. Представление объекта управляется через указатель формата ",view(<name>)". Указывает полное имя визуализируемого типа. Если тип является классом шаблона, он может содержать символ "*" как подстановочный знак для параметров шаблона. С определениями UIVisualizer разрешается использовать только примитивные типы данных. Указывает имя модуля. Оно должно включать только имя модуля без абсолютного или относительного пути. Разрешен формат 1.2.3.4 или 1.2. Указывает альтернативный HRESULT, который будет использовать тот же визуализатор. Указывает тип параметра для заданной встроенной функции. Если выражение задано, указывает имя, по которому оно может ссылаться на параметр. Если функция реализована посредством расширения отладчика, этот атрибут можно опустить. Описывает настраиваемую встроенную функцию, которую можно вызвать из выражения. Элемент <Intrinsic> должен сопровождаться компонентом отладчика, который реализует функцию с помощью интерфейса IDkmIntrinsicFunctionEvaluator140. Название встроенной функции. Должно являться действительным идентификатором C++. Указывает, какой значок категории должен назначаться результатам выражений, вызывающих эту функцию. Определяет, какой значок используется в окне контрольных значений для выражений, вызывающих функцию. Значение категории по умолчанию — Method. Тип возвращаемого значения встроенной функции. Если задано выражение, тип возвращаемого значения можно опустить (он будет определяться типом выражения). Выражение, которое вычисляется в тип возвращаемого значения для функции. Указывает идентификатор источника, который служит для определения компонента отладки, реализующего функцию. Должен совпадать с условиями фильтрации при реализации IDkmIntrinsicFunctionEvaluator140. Указывает идентификатор языка, который служит для определения компонента отладки, реализующего функцию. Должен совпадать с условиями фильтрации при реализации IDkmIntrinsicFunctionEvaluator140. Указывает уникальный идентификатор для этой функции с учетом идентификаторов источника и языка. Используется реализующим компонентом для определения того, вызов какой функции выполнялся в случае реализации нескольких встроенных функций. Если значение равно "true", указывает, что эта функция может иметь побочные действия. Если значение равно "true", вызовы этой функции будут отключены в сценариях, где неожиданные побочные действия могут запутать пользователя. Для изменяющих состояние функций внутри отлаживаемого объекта или внутри Visual Studio следует задать значение "true". Значение по умолчанию — "false". Если значение равно "true", указывает, что функция является функцией varargs и что можно передать дополнительные аргументы после перечисленных явным образом параметров. Значение по умолчанию — "false". Указывает альтернативный тип, который будет также использовать этот визуализатор. Значение "True", если этот визуализатор может использоваться объектами классов, полученных из данного типа; значение "False", если объект должен быть непосредственно этого типа, чтобы визуализатор перезапустился. Значение по умолчанию — True. Указывает соответствующие имя и версию модуля для данного визуализатора. Указывает минимальный (включительный) номер версии. Указывает максимальный (включительный) номер версии. Указывает строку, отображаемую как значение объектов визуализируемого типа. Принимает произвольные строки в сочетании с выражениями. Все символы, заключенные в фигурные скобки (т. е. { и }), интерпретируются как выражения и вычисляются. Чтобы использовать фигурные скобки для других целей, можно использовать двойные фигурные скобки (т. е. {{ и }}). При наличии устаревших надстроек указывает библиотеку DLL устаревшей надстройки. Если не указан полный путь, Visual Studio выполнит поиск в каталоге визуализатора, чтобы найти следующий NATVIS-файл, указывающий надстройку. По-прежнему разрешено использовать обычную отображаемую строку в сочетании с надстройкой; она будет использоваться как резервное значение, если не удастся загрузить библиотеку DLL надстройки. Указывает название экспорта для реализации устаревшей надстройки, если эта надстройка существует. Этот атрибут допустим только в том случае, если также указан атрибут LegacyAddin. Указывает кодировку строки, возвращаемой устаревшей надстройкой. По умолчанию — UTF8. Этот атрибут допустим только при указании атрибута LegacyAddin. Указывает надстройку визуализатора, которая настраивает представление отладчика для данного объекта. Указывает выражение, значение которого отправляется во встроенные визуализаторы текста. Указывает необязательное имя в синтаксисе <DisplayString> для этого узла. Если этот параметр опущен, именем узла будет индекс элемента в обходе дерева. Выражения в фигурных скобках вычисляются в контексте узла. Выражение, которое указывает на значение узла связанного списка. Можно оставить его пустым или использовать this для ссылки на сам узел связанного списка. Это выражение вычисляется в контексте узла связанного списка, а не родительского типа связанного списка. Указывает один дочерний элемент. Принимает только выражения и не допускает произвольные строки. Если выражение создает значение сложного типа, сам дочерний узел может быть развернут пользователем. Имя дочернего элемента, которое будет отображаться в столбце имени в окнах переменных отладчика. Указывает дочерний элемент, потомки которого будут отображаться в качестве дочерних элементов текущего узла. Используется, когда необходимо создать неструктурированное представление при развертывании типа. Указывает порядок развертывания индексов многомерных массивов. Значение Forward используется для развертывания массивов по строкам, а значение Backward - для развертывания массивов по столбцам. Указывает, что элемент должен использовать значок, сопоставленный с общими данными. Указывает, что элемент должен использовать значок, сопоставленный с вызовами методов. Указывает, что элемент должен использовать значок, сопоставленный со свойствами. Указывает список дочерних элементов, отображаемых при развертывании переменной визуализируемого типа в окнах отладчика. Указывает, должен ли узел "[Базовое представление]" этого объекта быть скрытым. По умолчанию для этого атрибута задано значение false, из-за чего узел базового представления текущего объекта виден пользователю. Позволяет настраивать логику для итераций по коллекции, которые не могут быть визуализированными иными способами. Задает логику, по которой пропускается определенное число элементов в коллекции. Логика пропуска применяется, когда пользователь прокручивает окно просмотра, чтобы быстро перейти вниз обхода коллекции к нужной точке. После выполнения логики пропуска управление возвращается на начало выполнения, но переменные итерации будут изменены нужным образом, чтобы отразить обновленное состояние. Элемент <Skip> можно использовать для оптимизации производительности, он также позволяет быстро обходить коллекции по большому числу элементов. Если элемент <Skip> не указан, вычислитель выражений запустит логику обхода, когда нужно выполнить пропуск, до тех пор пока не выполнится необходимое число элементов. В зависимости от структуры данных базовой коллекции на это может потребоваться значительное количество ненужных вычислений. Имя переменной, которая задает число элементов для пропуска, в виде беззнакового 32-разрядного целого числа. Если указан элемент <Size>, вычислитель выражений никогда не передаст значение пропуска, из-за которого текущий индекс обхода превысит границы коллекции. Если элемент <Size> не указан, значением пропуска может быть любое произвольное целое число, и в этом случае именно логика пропуска выполняет необходимые проверки границ. Если невозможно пропустить полное число запрошенных элементов, логика <Skip> изменит значение переменной пропуска так, чтобы когда выполнение завершится, переменная содержала число пропущенных элементов. Указывает итоговое число элементов в коллекции. Условие, определяющее нужно ли выполнять этот и внутренние элементы Указывает блок инструкций, которые будут выполняться несколько раз до тех пор, пока не встретится элемент <Break> или нельзя будет вычислить выражение. Указывает блок инструкций, которые будут выполняться несколько раз до тех пор, пока не встретится элемент <Break> или нельзя будет вычислить выражение. Указывает блок инструкций, которые будут выполняться, только если значение условия является истинным. Указывает блок инструкций, которые будут выполняться, только если значение условия является истинным. Указывает блок инструкций, которые будут выполняться, только если значение условия является истинным. Указывает блок инструкций, которые будут выполняться, только если значение условия является истинным. Объявляется переменную для использования в будущих выражениях с блоком <CustomListItems>. Имя переменной. Выражение, вычисляющее исходное значение переменной. Это выражение также указывает тип переменной. Выражения исходных значений могут использовать другие уже заданные переменные. Выполняет единственное выражение. Выражение выполняется в контексте объекта, но может использовать переменные итераций. Выражение может изменять переменные итераций, больше никаких побочных эффектов не допускается. Создает дочерний элемент через вычисление данного выражения. Указывает необязательное имя для элемента. Имя предоставлено в синтаксисе <DisplayString> и может содержать внедренные выражения. Если имя не указано, используется имя по умолчанию в виде "[i]", где "i" — это индекс, представляющий собой элементы в порядке возвращения. Разрыв самого внутреннего элемента <Loop>. Элемент <Break> за пределами цикла прекратит итерацию коллекции. Указывает дочерний элемент, чье значение подтверждается выражением. Значение элемента можно указать с помощью элемента "DisplayString". Дочерние элементы этого элемента можно указывать с помощью элемента "Expand". Имя дочернего элемента, которое будет отображаться в столбце имени в окнах отладчика. Выражение будет использоваться для получения значения элемента, когда пользователю нужно его отследить отдельно с помощью команды "Добавить контрольное значение", примененной к элементу. Указывает представление содержимого переменной в виде массива. Предполагает, что элементы данных хранятся в памяти в нефрагментированном виде. Указывает ранг массива. Указывает размер каждого измерения массива. Для многомерных массивов можно указать выражение, использующее неявный параметр $i. Вместо этого параметра будет подставляться индекс измерения для определения размера массива по соответствующему измерению. Указывает нижнюю границу каждого измерения массива. Для многомерных массивов можно указать выражение, использующее неявный параметр $i. Вместо этого параметра будет подставляться индекс измерения для определения нижней границы массива по соответствующему измерению. Задает выражение, которое указывает первый элемент массива. Выражение должно быть указателем типа элемента, отличного от void*. Указывает более обобщенную форму представления переменной в виде массива. Используется, если элементы данных хранятся в памяти во фрагментированном виде и необходимо вычислять индекс элементов данных. Указывает размер списка индексов. Задает выражение, использующее неявный параметр $i, который указывает на элемент с номером i. Указывает представление содержимого переменной в виде связанного списка. Указывает количество элементов в связанном списке. Если указаны элементы с несколькими размерами, первый элемент размера с условием true (или без условий) определит размер. Если размер не указан (или все элементы размера имеют условие false), отладчик просмотрит список, чтобы узнать размер. Рекомендуется по возможности указывать размер связанных списков в записях NATVIS, так как это повысит производительность отладчика. Выражение, которое указывает на первый узел связанного списка. Выражение, которое указывает на следующий элемент. Это выражение вычисляется в контексте узла связанного списка, а не родительского типа связанного списка. Указывает представление содержимого переменной в виде дерева. Размер дерева. Выражение, которое указывает на корневой узел дерева. Выражение, которое указывает на левый дочерний элемент узла дерева. Это выражение вычисляется в контексте узла дерева, а не родительского типа. Выражение, которое указывает на правый дочерний элемент узла дерева. Это выражение вычисляется в контексте узла дерева, а не родительского типа. Выражение, которое указывает на значение узла дерева. Можно оставить его пустым или использовать this для ссылки на сам узел дерева. Это выражение вычисляется в контексте узла дерева, а не родительского типа. Указывает визуализатор пользовательского интерфейса, который может обрабатывать объекты этого типа. Визуализатор пользовательского интерфейса должен быть предварительно определен в NATVIS-файле. GUID службы визуализатора. Указывает идентификатор визуализатора. Используется для разделения нескольких средств просмотра, предоставляемых службой визуализатора. Указывает выражение, вычисляемое по текущему объекту, приведенному к полному производному (most-derived) типу. В большинстве случаев отладчик может определить полный производный тип объекта автоматически, и тогда использование элемента <MostDerivedType> не требуется. Для автоматического определения полного производного типа объекта необходимо, чтобы объект являлся экземпляром класса C++ с таблицей виртуальных функций, созданной компилятором. Этого достаточно для большинства иерархий классов. Тем не менее, иногда может требоваться настраиваемая логика, если иерархия классов не содержит виртуальных функций или если таблица виртуальных функций сформирована вручную с помощью кода приложения. Если верно, указывает, что наиболее производный тип объекта всегда будет статическим типом указанного выражения. По умолчанию отладчик будет использовать виртуальные таблицы для вычисления наиболее производного типа указанных выражений этого типа. Этот параметр следует использовать только в том случае, если код приложения создает виртуальные таблицы с использованием пользовательской логики, которую отладчик не распознает. Указывает, как смарт-указатель можно использовать синтаксически. Указывает, что смарт-указатель можно использовать синтаксически исключительно в целях разыменования и сравнения. Определяет следующие перегруженные операторы: - operator*() (разыменование) - operator->() (доступ к полю разыменованного значения) - operator==() (сравнение с необработанным указателем или другим смарт-указателем того же типа) - operator!=() (сравнение с необработанным указателем или другим смарт-указателем того же типа) Указывает, что смарт-указатель можно использовать синтаксически в целях разыменования и сравнения, а также индексирования Определяет следующие перегруженные операторы: - operator+() (добавление смещения типа size_t) - operator-() (вычитание смещения типа size_t) - operator[] (добавление смещения типа size_t и разыменование) - Все операторы, поддерживаемые SmartPointerUsage="Minimal" Указывает, что смарт-указатель будет содержать оператор преобразования для базового указателя. Все допустимые варианты применения базового указателя в этом языке можно использовать через оператор преобразования. Прямое назначение смарт-указателю все еще запрещено; чтобы изменить внутренний указатель в выражении, необходимо сделать это явным образом. Указывает, что заданный тип является смарт-указателем. Текст внутри этого элемента указывает выражение для вычисления базового указателя. Элемент <SmartPointer> оказывает следующее влияние: - Если не задан альтернативный элемент <DisplayString> (либо все элементы <DisplayString> содержат ошибки), базовый указатель будет отображаемой строкой - Если не задан альтернативный элемент <StringView> (либо все элементы <StringView> содержат ошибки), базовый указатель будет строковым представлением при его наличии. - Если не задан альтернативный элемент <Expand>, расширение смарт-указателя будет соответствовать расширению базового указателя. - Класс смарт-указателя также будет поддерживать перегруженные указатели в соответствии со значением атрибута <Usage>. Вы можете явно отказаться от такого поведения, указав "DefaultExpansion="false"" Указывает, какие сочетания операторов поддерживает данный смарт-указатель. Если значение равно true и отсутствует элемент Expand, предоставляется расширение по умолчанию, зависящее от расширения базового указателя. Если значение равно false, автоматическое создание элемента <Expand> по смарт-указателю не выполняется. Если этот атрибут отсутствует, используется значение по умолчанию, "true". Указывает запись визуализатора, которая настраивает представление отладчика для типа. Значение "True", если этот визуализатор может использоваться объектами классов, полученных из данного типа; значение "False", если объект должен быть непосредственно этого типа, чтобы визуализатор перезапустился. Значение по умолчанию — True. Указывает дополнительный приоритет, назначаемый этой записи для определения соответствия типов. В первую очередь проверяются записи с более высоким приоритетом, находящиеся в конкретном файле или каталоге. Записи <Type> с неуказанным приоритетом по умолчанию получают приоритет "Средний". Записи <AlternativeType> с неуказанным приоритетом наследуют приоритет элемента <Type>, в котором они содержатся. Приоритет используется только в случае отсутствия других средств устранения неоднозначности при определении соответствия типов. Например, записи с более точными определениями создания экземпляров шаблонов, ограничениями по модулям или представлениям будут пользоваться более высоким приоритетом независимо от указанных значений приоритетов. Аналогично, независимо от приоритета, NATVIS-файлы, входящие в состав загруженного проекта, всегда имеют более высокую очередность по отношению к файлам в пользовательском каталоге NATVIS, которые, в свою очередь, пользуются более высокой очередностью по отношению к файлам в каталоге NATVIS общесистемного уровня. Если две записи имеют одинаковый приоритет и нет других признаков для устранения неоднозначности, то невозможно установить, какую из них следует использовать. Указывает сведения о визуализаторе пользовательского интерфейса, который создает собственный интерфейс для отображения объекта. Чтобы связать тип с визуализатором пользовательского интерфейса, запись визуализатора для этого типа должна ссылаться на визуализатор пользовательского интерфейса. Указывает GUID службы визуализатора. Служба должна быть предоставлена пакетом Visual Studio, который также реализует интерфейс IVsCppDebugUIVisualizer. Отладчик загружает пакет, только если пользователь запрашивает эту службу визуализации. Указывает идентификатор визуализатора. Используется для разделения нескольких средств просмотра, предоставляемых этой службой визуализатора. Указывает имя, которое будет отображаться в списке визуализатора пользовательского интерфейса для переменной. Указывает описание визуализатора пользовательского интерфейса. Указывает запись визуализатора, которая настраивает представление отладчика для HRESULT. Другие типы HResult, которые будут совместно использовать тот же визуализатор. 32-битовое значение HRESULT, предназначенное для настройки. Описание этого значения HRESULT, которое будет отображаться в окнах отладчика. Имя значения HRESULT, которое будет отображаться в окнах отладчика. Определяет локализованный строковый ресурс, на который могут ссылаться элементы NATVIS, принимающие строки (например, DisplayString, имя атрибута элемента "Item"). Используйте формат "@<id>;", чтобы добавить ссылку на локализованную строку (например, @1001;) Идентификатор локализованной строки. Чтобы сослаться на эту локализованную строку, используйте формат @<id>;. Указывает список локализованных строк, на которые могут ссылаться элементы NATVIS. Определите локализованные строки во вспомогательном NATVIS-файле, имя которого совпадает с именем основного фала, и разверните его в указанной локальной папке, рядом с основным NATVIS-файлом. Отладчик загрузит локализованные ресурсы и подходящего вспомогательного файла. Определите локализованные строки в основном NATVIS-файле , которые будут значениями по умолчанию, когда вспомогательный отсутствует в языковом стандарте. Корневой элемент NATVIS-файла. Указывает соответствующие имя и версию модуля для всех визуализаторов, которые не задают явным образом имя и версию модуля в этом файле.