DTE2.LaunchWizard メソッド (String, array<Object %)
指定したパラメーターを使ってウィザードを実行します。
名前空間: EnvDTE80
アセンブリ: EnvDTE80 (EnvDTE80.dll 内)
構文
'宣言
Function LaunchWizard ( _
VSZFile As String, _
ByRef ContextParams As Object() _
) As wizardResult
wizardResult LaunchWizard(
string VSZFile,
ref Object[] ContextParams
)
wizardResult LaunchWizard(
[InAttribute] String^ VSZFile,
[InAttribute] array<Object^>^% ContextParams
)
abstract LaunchWizard :
VSZFile:string *
ContextParams:Object[] byref -> wizardResult
function LaunchWizard(
VSZFile : String,
ContextParams : Object[]
) : wizardResult
パラメーター
- VSZFile
型 : System.String
必ず指定します。ウィザードの実行に必要な情報を含む .Vsz (ウィザード) ファイル。
- ContextParams
型 : array<System.Object[]%
必ず指定します。ウィザードのパラメーター。最初のパラメーターは、Add Item、Add Project、またはカスタム GUID とは異なる起動コンテキストを一意に識別する GUID です。残りの引数はユーザー定義の引数で、その数や値はウィザードによって異なります。
Visual Basic Windows アプリケーションや Visual C# コンソール アプリケーションなど、Visual Studio に含まれているウィザード (またはテンプレート) には、渡す必要がある必須のコンテキスト パラメーターがあります。これらの詳細については、「ContextParams 列挙型」を参照してください。独自に作成するウィザードについては、パラメーターに関する制約がある場合があります。
戻り値
型 : EnvDTE.wizardResult
wizardResult オブジェクト。
解説
IDE のメイン UI スレッドはウィザードの実行と同期しているため、ユーザーはウィザードが完了するまで操作できません。
LaunchWizard メソッドを使用して Visual Studio の項目の追加ウィザードを起動する方法を次のマクロの例に示します。このウィザードは 7 つのカスタム パラメーターを使用するため、それぞれのパラメーターの値が設定されています。すべての例外は、Try...Catch ブロックでキャッチされます。
例
Sub LaunchWizardExample()
Dim params() As Object = New Object() { _
"{0F90E1D0-4999-11D1-B6D1-00A0C90F2744}", _ ' Param 0
"MyConsoleProject", _ ' Param 1
"C:\MyProjects", _ ' Param 2
"", _ ' Param 3
False, _ ' Param 4
"", _ ' Param 5
False} ' Param 6
' The wizardResult constant determines the state of the wizard, such
' as whether it completed, was canceled, and so on.
Dim res As EnvDTE.wizardResult
' Set the project type to a Visual Basic project.
Dim str As String = _
DTE.Solution.TemplatePath(VSLangProj.PrjKind.prjKindVBProject)
' Start the Visual Basic Console Application wizard by using the
' supplied parameters. Exceptions are caught below.
Try
res = DTE2.LaunchWizard(str & "ConsoleApplication.vsz", params)
Catch e1 As System.Exception
MsgBox("Error: " & e1.Message)
End Try
End Sub
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。