OutputGroups.Item(Object) Method

Reference

Definition

Namespace:: EnvDTE

Assembly:: EnvDTE.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Returns a OutputGroup object in a OutputGroups collection.

public:
 EnvDTE::OutputGroup ^ Item(System::Object ^ index);

public:
 EnvDTE::OutputGroup ^ Item(Platform::Object ^ index);

EnvDTE::OutputGroup Item(winrt::Windows::Foundation::IInspectable const & index);

[System.Runtime.InteropServices.DispId(0)]
public EnvDTE.OutputGroup Item (object index);

[<System.Runtime.InteropServices.DispId(0)>]
abstract member Item : obj -> EnvDTE.OutputGroup

Public Function Item (index As Object) As OutputGroup

Parameters

index: Object

Required. The index of the OutputGroup object to return.

Returns

OutputGroup

An OutputGroup object.

Attributes: DispIdAttribute

Examples

public void CodeExample(DTE2 dte)  
{    
    try  
    {  
        // Open a project before running this example.  
        Project proj = dte.Solution.Projects.Item(1);  
        OutputGroups groups = proj.ConfigurationManager.ActiveConfiguration.OutputGroups;  
        int c = 1;  
        int x = 0;  
        string msg;  
        // Find the last outputgroup with at least one file.  
        foreach (OutputGroup grp in groups)  
        {  
            x++;  
            if (grp.FileCount > 0)  
                c = x;  
        }  
        OutputGroup group = groups.Item(c);  
        msg = "The " + c + "/" + groups.Count + " item in the OutputGroups groups collection is " +  
            group.DisplayName;  
        msg += "\nThe parent of the collection is the Configuration: " + groups.Parent.ConfigurationName;  
        msg += "\nThe application containing this collection is: " + groups.DTE.Name;  
        MessageBox.Show(msg);  
    }  
    catch(Exception ex)  
    {  
        MessageBox.Show(ex.Message);  
    }  
}

Remarks

The value passed to Index is either an integer that is an index to a OutputGroup object in a OutputGroups collection, or a string value that equates to the name of an OutputGroup object in the collection.

The Item method throws a ArgumentException exception if the collection cannot find the object that corresponds to the index value.

Applies to