Project.UniqueName - свойство

Статья
11/05/2008

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

Возвращает уникальное строковое значение, позволяющее различать проекты с одинаковыми именами.

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

Синтаксис

'Декларация
ReadOnly Property UniqueName As String
'Применение
Dim instance As Project
Dim value As String

value = instance.UniqueName

string UniqueName { get; }

property String^ UniqueName {
    String^ get ();
}

function get UniqueName () : String

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

Тип: System.String
Строка, представляющая уникальное значение, использующееся для того, чтобы различать проекты с одинаковыми именами.

Заметки

Свойство UniqueName в основном используется для индексирования Solution.Item("..."). Этот метод возвращает временное уникальное строковое значение, позволяющее отличать один проект от другого. Хотя и можно сравнить значения свойств UniqueName друг с другом, строковым значениям не следует присваивать осмысленные (понятные) значения, так как они используются только для сравнения.

Вместо этого рекомендуется использовать свойство FullName или сочетание похожих постоянных свойств для осмысленного сравнения.

Примеры

Sub UniqueNameExample()
   Dim proj As Project
   Dim projitems As ProjectItems
   Dim msg As String

   ' Reference the current solution and its projects and project items.
   proj = DTE.ActiveSolutionProjects(0)
   projitems = proj.ProjectItems

   ' List properties of the project and its items.
   msg = "Is the item open? " & projitems.Item(1).IsOpen & Chr(13)
   msg = msg & "The project's unique name: " & proj.UniqueName
   ' The following two properties work only if the current project 
   ' contains subprojects. If it does, then uncomment the lines to run 
   ' them.
   ' msg = msg & "The parent project item name: " & proj.ParentProjectItem.Name & Chr(13)
   ' msg = msg & "The subproject name: " & projitems.Item(1).SubProject.Name & Chr(13)
   MsgBox(msg)
End Sub

Разрешения

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