Método Solution2.AddFromTemplate (String, String, String, Boolean)

Artigo
10/26/2012

Cópias de um existente projeto arquivo e os itens ou subdiretórios que ele contém, no 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: System.String
Obrigatório.O nome de arquivo e caminho completo com a extensão do arquivo do modelo de projeto.

Destination
Tipo: System.String
Obrigatório.O caminho completo da pasta na qual deseja copiar o conteúdo de FileName.

ProjectName
Tipo: System.String
Obrigatório.O nome do arquivo do projeto no diretório de destino.Isso deve incluir a extensão.O nome exibido é derivado de ProjectName.

Exclusive
Tipo: System.Boolean
Opcional.Indica se o projeto é carregado na solução atual ou a própria; trueSe a solução atual é fechada e o projeto é adicionado a uma nova solução, false se o projeto é adicionado à solução existente, aberta.

Valor de retorno

Tipo: EnvDTE.Project
A Project object.

Comentários

O nome do projeto exibido na Solution Explorer é ProjectName sem a extensão de arquivo.AddFromTemplatefalha se o novo nome de arquivo de projeto já existe no destino.

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

Exemplos

Para obter informações sobre como executar esse código de suplemento, consulte Como: compilar e executar os exemplos de código de modelo de objeto de automação.

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

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áveis.

Consulte também

Referência

Solution2 Interface

Sobrecargas AddFromTemplate

Namespace EnvDTE80

Compartilhar via