Método Solution2.AddFromTemplate

Artigo
05/17/2015

Copia um arquivo de projeto existente, e todos os itens ou as subpastas que ele contém, para o local especificado e o adiciona à solução.

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

Sintaxe

'Declaração
Function AddFromTemplate ( _
    FileName As String, _
    Destination As String, _
    ProjectName As String, _
    Exclusive As Boolean _
) As Project

Project AddFromTemplate(
    string FileName,
    string Destination,
    string ProjectName,
    bool Exclusive
)

Project^ AddFromTemplate(
    [InAttribute] String^ FileName, 
    [InAttribute] String^ Destination, 
    [InAttribute] String^ ProjectName, 
    [InAttribute] bool Exclusive
)

abstract AddFromTemplate : 
        FileName:string * 
        Destination:string * 
        ProjectName:string * 
        Exclusive:bool -> Project

function AddFromTemplate(
    FileName : String, 
    Destination : String, 
    ProjectName : String, 
    Exclusive : boolean
) : Project

Parâmetros

FileName
Tipo: String

Obrigatório. O caminho completo e o nome de arquivo com extensão do arquivo de projeto do modelo.

Destination
Tipo: String

Obrigatório. O caminho completo do diretório no qual o conteúdo de FileName deve ser copiado.

ProjectName
Tipo: String

Obrigatório. O nome do arquivo de projeto no diretório de destino. Ele deve incluir a extensão. O nome exibido é derivado de ProjectName.

Exclusive
Tipo: Boolean

Opcional. Indica se o projeto é carregado na solução atual ou na própria; true se a solução atual estiver fechada e o projeto for adicionado a uma nova solução, false se o projeto for adicionado à solução existente, aberta.

Valor de retorno

Tipo: Project
Um objeto Project.

Comentários

O nome do projeto exibido em Gerenciador de Soluções é ProjectName sem a extensão de arquivo. AddFromTemplate falhará se o novo nome de arquivo de projeto já existe no destino.

Dica

Para Visual Basic e projetos de Visual C# : O objeto retornado de Project tem um valor de Nothing ou de nulluma referência nula (Nothing no Visual Basic).Você pode encontrar o objeto criado de Project iterando através da coleção de DTE.Solution.Projects usando o parâmetro de ProjectName para identificar o projeto recém-criado.

Exemplos

Para obter informações sobre como executar este código do suplemento, consulte Como compilar e executar os exemplos de código do modelo de objeto Automation.

O exemplo a seguir cria uma solução e adicione um projeto de aplicativo de console.

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)
    SolutionExample(_applicationObject)
End Sub

Sub SolutionExample(ByVal dte As DTE2)
    ' This function creates a solution and adds a Visual Basic Console
    ' project to it.
    Try
        Dim soln As Solution2 = CType(DTE.Solution, Solution2)
        Dim vbTemplatePath As String
        ' This path must exist on your computer.
        ' Replace <file path> below with an actual path.
        Dim vbPrjPath As String = "<file path>"
        MsgBox("starting")
        ' Get the project template path for a Visual Basic console project.
        vbTemplatePath = soln.GetProjectTemplate _
        ("ConsoleApplication.zip", "VisualBasic")
        ' Create a new C# Console project using 
        ' the template obtained above.
        soln.AddFromTemplate(vbTemplatePath, vbPrjPath, _
        "New Visual Basic Console Project", False)
        MsgBox("done")
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub

public void OnConnection(object application,
 Extensibility.ext_ConnectMode connectMode, object addInInst,
 ref System.Array custom)
{
    _applicationObject = (DTE2)application;
    _addInInstance = (AddIn)addInInst;
    // Pass the applicationObject member variable to the code example.
    SolutionExample((DTE2)_applicationObject);
}

public void SolutionExample(DTE2 dte)
{
    // This function creates a solution and adds a Visual C# Console
    // project to it.
    try{
        Solution2 soln = (Solution2)_applicationObject.Solution;
        String csTemplatePath;
        // The file path must exist on your computer.
        // Replace <file path> below with an actual path.
        String csPrjPath = "<file path>";
    "<file path>MessageBox.Show("Starting...");
"<file path>"<file path>csTemplatePath = 
soln.GetProjectTemplate("ConsoleApplication.zip", "CSharp");
        // Create a new C# Console project using the template obtained 
        // above.
        soln.AddFromTemplate(csTemplatePath, csPrjPath,
 "New CSharp Console Project", false);
        MessageBox.Show("Done!");
    }
    catch(SystemException ex)
    {
        MessageBox.Show("ERROR: " + ex);
    }
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

Solution2 Interface

Namespace EnvDTE80

Compartilhar via