Interface Reference3

Artigo
05/17/2015

Estende a interface de Reference2 de namespace de VSLangProj2 .

Namespace: VSLangProj80
Assembly: VSLangProj80 (em VSLangProj80.dll)

Sintaxe

'Declaração
<GuidAttribute("5021602E-2025-4299-88D2-0A92E8B41ADF")> _
Public Interface Reference3 _
    Inherits Reference2

[GuidAttribute("5021602E-2025-4299-88D2-0A92E8B41ADF")]
public interface Reference3 : Reference2

[GuidAttribute(L"5021602E-2025-4299-88D2-0A92E8B41ADF")]
public interface class Reference3 : Reference2

[<GuidAttribute("5021602E-2025-4299-88D2-0A92E8B41ADF")>]
type Reference3 =  
    interface 
        interface Reference2 
    end

public interface Reference3 extends Reference2

O tipo Reference3 expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Aliases	Obtém ou define os nomes alias da referência especificada.Essa propriedade aplica-se somente a Visual C# .
	AutoReferenced	Obtém se a referência é referenciada automaticamente pelo compilador.
	BuildNumber	Obtém o número de compilação de referência.
	Collection	Obtém uma coleção de References.
	ContainingProject	Obtém Project que contém a referência.
	CopyLocal	Obtém ou define se a referência será copiada no caminho local bin.
	Culture	Obtém a cadeia de caracteres de cultura de uma referência.
	Description	Obtém uma descrição de texto de referência.
	DTE	Obtém o objeto de nível superior de extensibilidade.
	Extender	Infraestrutura. Somente para uso interno do Microsoft.
	ExtenderCATID	Infraestrutura. Somente para uso interno do Microsoft.
	ExtenderNames	Infraestrutura. Somente para uso interno do Microsoft.
	Identity	Obtém o identificador exclusivo da referência.
	Isolated	Obtém ou define se a referência da é isolada, ou seja, não registrado com o windows.
	MajorVersion	Obtém o número de versão principal da referência.
	MinorVersion	Obtém o número da versão secundária da referência.
	Name	Obtém o nome do objeto.
	Path	Obtém o caminho para o arquivo de referência.
	PublicKeyToken	Obtém o token de chave pública de uma referência altamente assinado.
	RefType	Obtém o tipo de referência: assembly, COM, ou nativo.
	Resolved	Obtém se a referência atual esteve resolvida.
	RevisionNumber	Obtém o número de revisão de referência.
	RuntimeVersion	Obtém a versão do tempo de execução em que a referência foi criada.Isso é aplicável somente para referências do .NET.
	SourceProject	Obtém um objeto de Project se a referência é um projeto.Caso contrário, retorna Nothing (um objeto nulo).
	SpecificVersion	Obtém ou define se apenas uma versão específica de referência é usada.
	StrongName	Obtém se a referência será inscrita com um par de chaves pública/privada.
	SubType	Os conjuntos ou obtêm o subtipo de assembly.
	Type	Obsoleto.Incluído somente para compatibilidade com versões anteriores.Use RefType em vez disso.
	Version	Obtém a versão de referência especificada.

Superior

Métodos

	Nome	Descrição
	Remove	Remove a referência de objeto de References que o contém.

Superior

Comentários

Reference3 define os seguintes novos parâmetros:

Exemplos

O exemplo a seguir adiciona duas referências a Visual Basic ou a um projeto aberto de Visual C# . Chama uma função, GetRefTypeName, para exibir o tipo de referência e chama uma função, ReportReferences, para exibir propriedades adicionais de referência. Para executar este exemplo como um suplemento, consulte Como compilar e executar os exemplos de código do modelo de objeto Automation.

Os caminhos padrão para as referências são adicionadas: <installation root>\ arquivos de programas \ Microsoft.NET \ assemblies primários de Interoperabilidade para o adodb.dll e, <installation root>\ arquivos de programas \ arquivos comuns \ Microsoft \ SpeechEngines para spcommon.dll. Substituir <file path> no exemplo com o ou outros esses caminhos de arquivos apropriados.

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)
    AddNewReference(applicationObject)
End Sub
Sub AddNewReference(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 type and additional
    ' information.
    Dim newRef As Reference3
    ' Replace <file path> with an actual path.
    newRef = aVSProject.References.Add("<file path>\adodb.dll")
    MsgBox("The " & newRef.Name() & " added, is of type:" & vbCr _
    & GetRefTypeName(newRef))
    MsgBox("A report on " & newRef.Name() & ":" & vbCr & _
    ReportReferences(newRef))
    ' Add a COM reference and display its type and a report.
    ' Replace <file path> with an actual path.
    newRef = aVSProject.References.Add("<file path>\spcommon.dll")
    MsgBox("The " & newRef.Name() & " added, is of type:" & vbCr _
    & GetRefTypeName(newRef))
    MsgBox("A report on " & newRef.Name() & ":" & vbCr & _
    ReportReferences(newRef))
End Sub
Private Function GetRefTypeName(ByVal ref As Reference3) _
    As String
    Dim type As String
    Select Case ref.Type
        Case prjReferenceType.prjReferenceTypeActiveX
            type = "COM"
         Case prjReferenceType.prjReferenceTypeAssembly
            type = "Assembly"
    End Select
    Return type
End Function
Function ReportReferences(ByVal aRef As Reference3) As String
    Dim report As String = ""
    Dim type As String
    ' Each entry in the ArrayList contains a label and a value.
    Dim ht As System.Collections.ArrayList = _
    New System.Collections.ArrayList
    With aRef
        ht.Add(New String() {"Name", .Name})
        ht.Add(New String() {"Description", .Description})
        ht.Add(New String() {"Version",  -
        String.Format("{0}.{1}.{2}.{3}", _
        .MajorVersion, .MinorVersion, .BuildNumber, .RevisionNumber)})
        ht.Add(New String() {"Location", .ContainingProject.FullName})
            Select Case .Type
            Case prjReferenceType.prjReferenceTypeActiveX
                type = "COM"
            Case prjReferenceType.prjReferenceTypeAssembly
                type = "Assembly"
            End Select
            ht.Add(New String() {"Type", type})
            ht.Add(New String() {"Culture", .Culture})
    End With
    Dim datas() As String
    For Each datas In ht
        report &= datas(0) & ControlChars.Tab & datas(1) & _
        ControlChars.CrLf
    Next
    Return report
End Function

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;
    AddNewReference(((DTE2)applicationObject));
}

public void AddNewReference(DTE2 dte)
{
    Project aProject = null;
    VSProject2 aVSProject = null;
    aProject = applicationObject.Solution.Projects.Item(1);
    aVSProject = 
((VSProject2)(applicationObject.Solution.Projects.Item(1).Object));
    // Add an Assembly reference and display its type and a report.
    Reference3 newRef = null;
    // Replace <file path> with an actual file path.
    newRef = ((Reference3)(aVSProject.References.Add(@"
<file path>\adodb.dll")));
    MessageBox.Show("The " + newRef.Name + " added, is of type:" 
+ "\n" + GetRefTypeName(newRef));
    MessageBox.Show("A report on " + newRef.Name + ":" + "\n" 
+ ReportReferences(newRef)); 
    // Add a COM reference and display its type and a report.
    // Replace <file path> with an actual file path.
    newRef = ((Reference3)(aVSProject.References.Add(@"
<file path>\spcommon.dll")));
    MessageBox.Show("The " + newRef.Name + " added, is of type:" 
+ "\n" + GetRefTypeName(newRef));
    MessageBox.Show("A report on " + newRef.Name + ":" + "\n" 
+ ReportReferences(newRef)); 
}
private string GetRefTypeName(Reference3 refIdent)
{
    string type = null;
    switch (refIdent.Type)
    {
     case prjReferenceType.prjReferenceTypeActiveX:
        type = "COM";
        break;
    case prjReferenceType.prjReferenceTypeAssembly:
        type = "Assembly";
        break;
    }
    return type;
}
public string ReportReferences(Reference3 aRef)
{
    string report = "";
    string type = null;
    // Each entry in the ArrayList contains a label and a value.
    System.Collections.ArrayList ht = 
new System.Collections.ArrayList();
    VSLangProj.Reference temp = aRef;
    ht.Add(new string[] { "Name", temp.Name });
    ht.Add(new string[] { "Description", temp.Description });
   ht.Add(new string[] { "Version", string.Format("{0}.{1}.{2}.{3}"
, temp.MajorVersion, temp.MinorVersion, 
temp.BuildNumber, temp.RevisionNumber) });
    ht.Add(new string[] { "Location", 
temp.ContainingProject.FullName });
    switch (temp.Type)
    {
        case prjReferenceType.prjReferenceTypeActiveX:
            type = "COM";
            break;
        case prjReferenceType.prjReferenceTypeAssembly:
            type = "Assembly";
            break;
    }
    ht.Add(new string[] { "Type", type });
    ht.Add(new string[] { "Culture", temp.Culture });
    string[] datas = null;
    foreach (string[] temp1 in ht)
    {
        datas = temp1; 
        report += datas[0] + "\t" + datas[1] + "\n";
    }
    return report;
}

Consulte também

Referência

Namespace VSLangProj80

Reference

Compartilhar via