Properties Interface


Contains all of the properties of a given object that are contained in a generic collection of properties.

Namespace:   EnvDTE
Assembly:  EnvDTE (in EnvDTE.dll)

public interface Properties : IEnumerable


This API supports the product infrastructure and is not intended to be used directly from your code. Microsoft Internal Use Only.


Gets a value indicating the number of objects in the collection.


Gets the top-level extensibility object.


Gets the immediate parent object of a Properties collection.


Gets an enumeration for items in a collection.


Returns an indexed member of a Properties collection.

Properties contains properties of various kinds. It can contain project properties, item properties, solution properties, and so on. It is used in the properties of other interfaces, such as Properties, to contain their property lists.

In the case of Properties, Properties represents all of the available categories and subcategories that are contained in the Options dialog box on the Tools menu. See Properties, for more information.

Properties is also used to represent things such as properties for projects, properties for items in projects, properties for project configurations, and so on. For more information, see Accessing Project Type Specific Project, Project Item, and Configuration Properties.

The Properties collection does not support statement completion, such as property members of objects. However, it does provide an easy way to expose many properties and iterate through them.

Sub PropertiesExample()
   ' Demonstrates how to programmatically access Tools Options 
   ' properties using the Properties collection.
   Dim Props As Properties
   Dim PropObj As [Property]
   Dim NameValPair As String

   Props = DTE.Properties("Environment", "General")
   MsgBox("Tools – Options – Environment – General Properties Count = _
     & Props.Count())
   For Each PropObj In Props
     NameValPair = NameValPair & (PropObj.Name & "Value = " & _
       PropObj.Value & microsoft.VisualBasic.ControlChars.CrLf)
End Sub
Return to top