CodeElement.InfoLocation - свойство

Статья
11/05/2008

Обновлен: Ноябрь 2007

Возвращает сведения о возможностях модели кода.

Пространство имен: EnvDTE
Сборка: EnvDTE (в EnvDTE.dll)

Синтаксис

'Декларация
ReadOnly Property InfoLocation As vsCMInfoLocation
'Применение
Dim instance As CodeElement
Dim value As vsCMInfoLocation

value = instance.InfoLocation

vsCMInfoLocation InfoLocation { get; }

property vsCMInfoLocation InfoLocation {
    vsCMInfoLocation get ();
}

function get InfoLocation () : vsCMInfoLocation

Значение свойства

Тип: EnvDTE.vsCMInfoLocation
Значение константы vsCMInfoLocation.

Заметки

Если InfoLocation возвращает vsCMInfoLocationProject, то можно установить свойства, а также получить StartPoint, EndPoint и т. д. При переходе от одного объекта модели кода (A) к другому (B), например от функции к ее типу или от класса к базовому классу, объект B может иметь тип vsCMInfoLocationExternal, если его определение находится в другом проекте. Размещение зависит от реализации модели кода, от того, реализованы ли проекты объектов A и B на одном языке, и т. д.

Если свойство InfoLocation возвращает vsCMInfoLocationExternal, то сведения можно извлечь только из метаданных, путем просмотра библиотек DLL или из замороженных ресурсов. Можно получить StartPoint и EditPoint, но нельзя редактировать документ. Т.е. нельзя задавать свойства или изменять текст, находящийся за элементом кода.

Если InfoLocation возвращает vsCMInfoLocationNone, то доступен только объект модели кода, имеющий имя. Кроме того, в зависимости от контекста исходного кода можно в некоторых случаях понять, должно ли имя быть именем класса или интерфейса. Но в такой ситуации, поскольку модель кода не может разрешить данное имя, вернув какие бы то ни было полезные сведения, объект совершенно бесполезен.

Примечание.
Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и т. п., после внесения некоторых изменений могут оказаться неопределенными, иными словами, нельзя рассчитывать, что их значения будут всегда оставаться одинаковыми. Дополнительные сведения см. в главе "Значения элементов модели кода могут изменяться" раздела Практическое руководство. Поиск кода при помощи модели кода (Visual Basic).

Значения элементов модели кода, таких как классы, структуры, функции, атрибуты, делегаты и т. п., после внесения некоторых изменений могут оказаться неопределенными, иными словами, нельзя рассчитывать, что их значения будут всегда оставаться одинаковыми. Дополнительные сведения см. в главе "Значения элементов модели кода могут изменяться" раздела Практическое руководство. Поиск кода при помощи модели кода (Visual Basic).

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.