CodeEvent.AddAttribute メソッド

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

更新 : 2007 年 11 月

新しい属性コード構成を作成し、適切な位置にコードを挿入します。

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

構文

'宣言
Function AddAttribute ( _
    Name As String, _
    Value As String, _
    Position As Object _
) As CodeAttribute
'使用
Dim instance As CodeEvent
Dim Name As String
Dim Value As String
Dim Position As Object
Dim returnValue As CodeAttribute

returnValue = instance.AddAttribute(Name, _
    Value, Position)

CodeAttribute AddAttribute(
    string Name,
    string Value,
    Object Position
)

CodeAttribute^ AddAttribute(
    String^ Name, 
    String^ Value, 
    Object^ Position
)

function AddAttribute(
    Name : String, 
    Value : String, 
    Position : Object
) : CodeAttribute

パラメータ

Name
型 : System.String

属性の名前。

Value
型 : System.String

属性の値。パラメータ化したプロパティのパラメータのリストをカンマで区切って指定することもできます。

Position
型 : System.Object

省略できます。追加される新しい要素の後にある要素の位置。

既定では、値がゼロの場合に新しい要素がコレクションの先頭に追加されます。値が -1 の場合は、新しい要素がコレクションの末尾に追加されます。

戻り値

型 : EnvDTE.CodeAttribute

CodeAttribute オブジェクト。

解説

メモ :
特定の種類の編集を行うと、クラス、構造体、関数、属性、デリゲートなどのコードモデル要素が非確定的な値になる場合があります。つまり、これらの要素の値は、常に同じ値になるとは限りません。詳細については、「コードモデルを使用したコードの調査 (Visual Basic)」の「変更されるコードモデル要素値」を参照してください。

特定の種類の編集を行うと、クラス、構造体、関数、属性、デリゲートなどのコードモデル要素が非確定的な値になる場合があります。つまり、これらの要素の値は、常に同じ値になるとは限りません。詳細については、「コードモデルを使用したコードの調査 (Visual Basic)」の「変更されるコードモデル要素値」を参照してください。

例

AddAttribute メソッドの使用方法を次の例に示します。

このプロパティをテストするには

ターゲットプロジェクトを開き、イベントオブジェクト上にカーソルを配置してコードイベント要素を選択します。
アドインを実行します。

public static void AddAttribute(EnvDTE80.DTE2 dte)
{
    TextSelection objTextSel;
    EnvDTE80.CodeEvent codeEvent;
    objTextSel = (TextSelection)dte.ActiveDocument.Selection;
    codeEvent = (EnvDTE80.CodeEvent)objTextSel.ActivePoint.get_CodeElement(vsCMElement.vsCMElementEvent);

    codeEvent.AddAttribute("Obsolete", "\"NewAttribute\", true", 1);
    string str = "";
    foreach (CodeElement ce in codeEvent.Attributes)
        str += "\n" + ce.FullName;
    MessageBox.Show("\nAddAttribute method: " +
                    str, "Testing CodeEvent");
}