ConfigurationManager.AddConfigurationRow メソッド

[アーティクル]
08/22/2008

更新 : 2007 年 11 月

既存のプロジェクトまたはプロジェクト項目の構成行の Configuration オブジェクトに基づいて、新しいプロジェクトまたはプロジェクト項目の構成行を作成します。

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

構文

'宣言
Function AddConfigurationRow ( _
    NewName As String, _
    ExistingName As String, _
    Propagate As Boolean _
) As Configurations
'使用
Dim instance As ConfigurationManager
Dim NewName As String
Dim ExistingName As String
Dim Propagate As Boolean
Dim returnValue As Configurations

returnValue = instance.AddConfigurationRow(NewName, _
    ExistingName, Propagate)

Configurations AddConfigurationRow(
    string NewName,
    string ExistingName,
    bool Propagate
)

Configurations^ AddConfigurationRow(
    String^ NewName, 
    String^ ExistingName, 
    [InAttribute] bool Propagate
)

function AddConfigurationRow(
    NewName : String, 
    ExistingName : String, 
    Propagate : boolean
) : Configurations

パラメータ

NewName
型 : System.String

必ず指定します。新しいプロジェクトまたはプロジェクト項目の構成行の一意の名前。

ExistingName
型 : System.String

必ず指定します。プロジェクトまたはプロジェクト項目の構成行の名前。新しい構成行を作成するためにコピーされます。

Propagate
型 : System.Boolean

必ず指定します。プロジェクトまたはプロジェクト項目の構成行を反映させる場合は、true を指定します。それ以外の場合は false を指定します。

戻り値

型 : EnvDTE.Configurations

Configurations コレクション。

解説

AddConfigurationRow は新しい Configuration オブジェクトのコレクションを返します。現在のプロジェクトに NewName が既に存在する場合、ExistingName の設定値がコピーされなかったことがわかるように、このメソッドは失敗します。

例

Sub AddConfigurationRowExample()
    ' Make a copy of the "Debug" configurations to temporarily change 
    ' them without affecting the original "Debug" configurations.
    Dim cfgmgr As ConfigurationManager = _
        DTE.ActiveSolutionProject.ConfigurationManager
    Dim cfgs = Cfgmgr.AddConfigurationRow("MyDebug", "Debug")
    For Each (cfg in cfgs)
        Cfg.Properties.Item("SomeProperty") = True
    Next
End Sub