References.Item(Object) Method

Reference

Definition

Namespace:: VSLangProj

Assembly:: VSLangProj.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 an indexed Reference object.

public:
 VSLangProj::Reference ^ Item(System::Object ^ index);

public:
 VSLangProj::Reference ^ Item(Platform::Object ^ index);

VSLangProj::Reference Item(winrt::Windows::Foundation::IInspectable const & index);

[System.Runtime.InteropServices.DispId(0)]
public VSLangProj.Reference Item (object index);

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

Public Function Item (index As Object) As Reference

Parameters

index: Object

Required. Either the Identity string of the Reference object or a one-based index into the References collection.

Returns

Reference

Returns a Reference object.

Attributes: DispIdAttribute

Examples

' Macro Editor  
Imports VSLangProj  
Public Sub FindExample()  
   ' First project is a Visual Basic or C# project.  
   Dim theVSProject As VSProject = _  
      CType(DTE.Solution.Projects.Item(1).Object, VSProject)  

   Dim refs As References = theVSProject.References  
   Dim firstIdentity As String = refs.Item(1).Identity  
   Dim firstRef As Reference = refs.Find(firstIdentity)  
   ' Are they the same object?  
   Dim isSame As Boolean = (firstRef.Identity = refs.Item(1).Identity)  
   MsgBox("Are they the same? " & isSame.ToString())  
End Sub

Remarks

This method is used to retrieve a specific object from the References collection. There is no guarantee that a given index number for a collection will always point to the same item, because items may be added or deleted from the collection. Using index numbers for the collection is useful when iterating through the whole collection and no items are added or deleted during the iteration.

Applies to