CodeAttribute2.Collection Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Получает коллекцию объектов CodeAttribute2.
public:
property EnvDTE::CodeElements ^ Collection { EnvDTE::CodeElements ^ get(); };
[System.Runtime.InteropServices.DispId(2)]
public EnvDTE.CodeElements Collection { [System.Runtime.InteropServices.DispId(2)] [System.Runtime.InteropServices.TypeLibFunc(1024)] get; }
[<System.Runtime.InteropServices.DispId(2)>]
[<get: System.Runtime.InteropServices.DispId(2)>]
[<get: System.Runtime.InteropServices.TypeLibFunc(1024)>]
member this.Collection : EnvDTE.CodeElements
Public ReadOnly Property Collection As CodeElements
Значение свойства
Коллекция объектов CodeAttribute2.
Реализации
- Атрибуты
Примеры
В следующем примере создается новое пространство имен и атрибут в текущем классе и выводятся некоторые свойства атрибута.
public void CreateClassAndAttrib(DTE2 applicationObject)
{
// Before running, load or create a project.
FileCodeModel2 fcm2 = GetFileCodeModel(applicationObject);
CodeAttribute2 cmAttribute;
CodeClass2 cmClass;
String msg = null;
if (fcm2 != null)
{
CodeNamespace cmNamespace;
// Try to create a new namespace.
try
{
cmNamespace = fcm2.AddNamespace("CMNamespace", -1);
// If successful, create the other code elements.
if (cmNamespace != null)
{
cmClass = (CodeClass2)cmNamespace.AddClass("ANewClass",
-1, null, null, vsCMAccess.vsCMAccessPrivate);
cmAttribute = (CodeAttribute2)cmClass.AddAttribute
("NewAttribute", "AttributeValue", -1);
msg += "Attribute count: " +
cmAttribute.Collection.Count + Environment.NewLine;
msg += "Document name: " +
cmAttribute.DTE.ActiveDocument.Name;
}
else
{
MessageBox.Show("Cannot continue - no filecodemodel
available.");
}
}
catch (Exception ex)
{
MessageBox.Show("ERROR: " + ex);
}
}
}
public FileCodeModel2 GetFileCodeModel(DTE2 applicationObject)
{
// Returns the FileCodeModel object of the active
// window.
TextWindow txtWin =
(TextWindow)applicationObject.ActiveWindow.Object;
FileCodeModel2 fcm2;
if (txtWin != null)
{
try
{
fcm2 = (FileCodeModel2)txtWin.Parent.
ProjectItem.FileCodeModel;
return fcm2;
}
catch (Exception ex)
{
MessageBox.Show("ERROR: " + ex);
return null;
}
}
else
return null;
}
Комментарии
Примечание
Значения аргумента атрибута Code после назначения не сохраняются в памяти Visual Studio , и, таким образом, могут быть недопустимыми, если происходит будущее обновление аргумента атрибута Code. То есть следующий доступ к аргументу может возвращать E_FAIL или совершенно другое значение. (Однако все, что влияет на дочерние элементы элемента, не имеет этой проблемы.)
Из-за этого недетерминированного поведения необходимо получить значение аргумента перед его изменением. Например, если задать в коде аргумент атрибута Code, например myAttrArg.Value = """a first value""" , необходимо явно ссылаться на него перед обновлением, например myAttrArg = myAttr.Arguments.Item("first value") , и назначить новое значение myAttrArg.Value = """a second value""" . Это гарантирует, что будет изменен правильный аргумент.
Кроме того, значения элементов модели кода, такие как классы, структуры, функции, атрибуты, делегаты и т. д., могут быть недетерминированными после внесения определенных видов изменений. Это означает, что их значения не могут полагаться на то, что они всегда остаются неизменными. Дополнительные сведения см. в разделе значения элементов модели кода могут изменяться при обнаружении кода с помощью модели кода (Visual Basic).