Properties Interface

Definition

Namespace:

EnvDTE

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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

public interface class Properties : System::Collections::IEnumerable

[System.Runtime.InteropServices.Guid("4CC8CCF5-A926-4646-B17F-B4940CAED472")]
public interface Properties : System.Collections.IEnumerable

[<System.Runtime.InteropServices.Guid("4CC8CCF5-A926-4646-B17F-B4940CAED472")>]
type Properties = interface
    interface IEnumerable

Public Interface Properties
Implements IEnumerable

Attributes

GuidAttribute

Implements

IEnumerable

Examples

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)  
   Next  
   MsgBox(NameValPair)  
End Sub  

Remarks

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.

Properties

Application	Microsoft Internal Use Only.
Count	Gets a value indicating the number of objects in the collection.
DTE	Gets the top-level extensibility object.
Parent	Gets the immediate parent object of a Properties collection.

Methods

GetEnumerator()	Gets an enumeration for items in a collection.
Item(Object)	Returns an indexed member of a Properties collection.