Solution3.AddFromTemplate メソッド (String, String, String, Boolean)

[アーティクル]
08/09/2011

既存のプロジェクトファイルと、プロジェクトファイルに含まれるすべての項目やサブディレクトリを指定の場所にコピーし、ソリューションに追加します。

名前空間: EnvDTE90
アセンブリ: EnvDTE90 (EnvDTE90.dll 内)

構文

'宣言
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

パラメーター

FileName
型: System.String
必須。拡張子付きのテンプレートプロジェクトファイルの完全パスとファイル名。

Destination
型: System.String
必須。FileName の内容をコピーするディレクトリの完全パス。

ProjectName
型: System.String
必須。コピー先ディレクトリのプロジェクトファイルの名前。拡張子も指定してください。表示される名前は、ProjectName に基づく名前になります。

Exclusive
型: System.Boolean
省略可能です。プロジェクトを現在のソリューションに読み込むか新しいソリューションに読み込むかを示します。現在のソリューションを閉じてプロジェクトを新しいソリューションに追加する場合は true を指定します。開いている既存のソリューションにプロジェクトを追加する場合は false を指定します。

戻り値

型: EnvDTE.Project
Project オブジェクト。

実装

Solution2.AddFromTemplate(String, String, String, Boolean)

解説

ソリューションエクスプローラーに表示されるプロジェクトの名前は ProjectName で、ファイル拡張子はありません。新しいプロジェクトファイルの名前がコピー先に既に存在する場合、AddFromTemplate は失敗します。

注意

Visual Basic プロジェクトおよび Visual C# プロジェクトの場合、返された Project オブジェクトの値は Nothing または nullnull 参照 (Visual Basic では Nothing) です。作成された Project オブジェクトを見つけるには、新しく作成されたプロジェクトを識別する ProjectName パラメーターを使用して、DTE.Solution.Projects コレクションを反復処理します。

例

このアドインコードの実行方法については、「方法 : オートメーションオブジェクトモデルのコード例をコンパイルおよび実行する」を参照してください。

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 C# Console
    ' project to it.
    Try
        Dim soln As Solution3 = CType(DTE.Solution, Solution3)
        Dim csTemplatePath As String
        ' This path must exist on your computer.
        ' Replace <file path> below with an actual path.
        Dim csPrjPath As String = "<file path>"
        MsgBox("starting")
        ' Get the project template path for a C# console project.
        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)
        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{
        Solution3 soln = (Solution3)_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);
    }
}