Reference3.RevisionNumber Property

Definition

Namespace:

VSLangProj80

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.11.40262

Gets the revision number of the reference.

public:
 property int RevisionNumber { int get(); };

public:
 property int RevisionNumber { int get(); };

[System.Runtime.InteropServices.DispId(13)]
public int RevisionNumber { [System.Runtime.InteropServices.DispId(13)] get; }

[<System.Runtime.InteropServices.DispId(13)>]
[<get: System.Runtime.InteropServices.DispId(13)>]
member this.RevisionNumber : int

Public ReadOnly Property RevisionNumber As Integer

Property Value

Int32

A Long. The number returned depends on the reference type.Reference TypeValue ReturnedAssemblyRevision version number of the reference; 0–9999.COM0

Implements

RevisionNumber

Attributes

DispIdAttribute

Examples

This example adds an Assembly and a COM reference to an open Visual Basic or Visual C# project and it then displays their revision numbers. To run this example as an add-in, see How to: Compile and Run the Automation Object Model Code Examples.

The default paths for the reference added are: <installation root>\Program Files\Microsoft.NET\Primary Interop Assemblies for adodb.dll, and <installation root>\Program Files\Common Files\SpeechEngines\Microsoft for spcommon.dll. Replace <file path> in the example with these or other appropriate file paths.

Imports VSLangProj  
Imports VSLangProj2  
Imports VSLangProj80  
Public Sub OnConnection(ByVal application As Object, _  
 ByVal connectMode As ext_ConnectMode, ByVal addInInst As Object, _  
 ByRef custom As Array) Implements IDTExtensibility2.OnConnection  
    applicationObject = CType(application, DTE2)  
    addInInstance = CType(addInInst, AddIn)  
    GetRevisionNumber(applicationObject)  
End Sub   
Sub GetRevisionNumber(ByVal dte As DTE2)  
    Dim aProject As Project  
    Dim aVSProject As VSProject2  
    aProject = applicationObject.Solution.Projects.Item(1)  
    aVSProject = _  
    CType(applicationObject.Solution.Projects.Item(1).Object, _  
    VSProject2)  
    ' Add an Assembly reference and display its minor version.  
    Dim newRef As Reference3  
    Try  
        ' Replace <file path> with an actual file path.  
        newRef = CType(aVSProject.References.Add _  
        ("<file path>\adodb.dll"), Reference3)  
    Catch e As System.Exception  
    End Try  
    MsgBox("Added an assembly reference, named: " & newRef.Name)  
    MsgBox("The revision number of " & newRef.Name & " is " _  
    & newRef.RevisionNumber.ToString())  
    ' Add a COM reference and display its minor version.  
    Try  
        ' Replace <file path> with an actual file path.  
        newRef = CType(aVSProject.References.Add_  
        ("<file path>\spcommon.dll"),_  
        Reference3)  
    Catch e As System.Exception  
    End Try  
    MsgBox("Added a COM reference, named: " & newRef.Name)  
    MsgBox("The revision number of " & newRef.Name & " is " _  
    & newRef.RevisionNumber.ToString())  
End Sub  

using System.Windows.Forms;  
using VSLangProj;  
using VSLangProj2;  
using VSLangProj80;  
public void OnConnection(object application,   
ext_ConnectMode connectMode, object addInInst, ref Array custom)  
{  
    applicationObject = (DTE2)application;  
    addInInstance = (AddIn)addInInst;  
    GetRevisionNumber(((DTE2)applicationObject));  
}  
public void GetRevisionNumber(DTE2 dte)  
{  
    // The first project is a Visual Basic or C# project.  
    VSProject2 vsProject =  
((VSProject2)(applicationObject.Solution.Projects.Item(1).Object));  
    Reference3 aRef = null;  
    // Add an Assembly reference and display its revision number.  
    // Replace <file path> with an actual file path.  
    aRef = (Reference3)vsProject.References.Add  
(@"<file path>\adodb.dll");  

    MessageBox.Show("Added an Assembly reference, named: "   
+ aRef.Name);  
    MessageBox.Show("The revision number of " + aRef.Name + " is "   
+ aRef.RevisionNumber.ToString());  
    // Add a COM reference and display its revision number.  
    // Replace <file path> with an actual file path.  
    aRef = (Reference3)vsProject.References.Add  
(@"File path>\spcommon.dll");  
    MessageBox.Show("Added a COM reference, named: " + aRef.Name);  
MessageBox.Show("The revision number of " + aRef.Name + " is "   
+ aRef.RevisionNumber.ToString());  
}  

Remarks

The version of a reference is uniquely identified by four components: major, minor, build, and revision. The major and minor components are required. The revision component is optional when build is not defined. COM objects do not have revision and build components. For more information, see Assembly Versioning.