CodeClass2.AddAttribute メソッド (String, String, Object)
新しい属性のコード コンストラクターを作成し、適切な位置にクラスを挿入します。
名前空間: EnvDTE80
アセンブリ: EnvDTE80 (EnvDTE80.dll 内)
構文
'宣言
Function AddAttribute ( _
Name As String, _
Value As String, _
Position As Object _
) As CodeAttribute
CodeAttribute AddAttribute(
string Name,
string Value,
Object Position
)
CodeAttribute^ AddAttribute(
String^ Name,
String^ Value,
Object^ Position
)
abstract AddAttribute :
Name:string *
Value:string *
Position:Object -> CodeAttribute
function AddAttribute(
Name : String,
Value : String,
Position : Object
) : CodeAttribute
パラメーター
- Name
型 : System.String
必ず指定します。新しい属性の名前です。
- Value
型 : System.String
必ず指定します。属性の値でパラメーター化したプロパティのパラメーターのリストをコンマで区切って指定することもできます。
- Position
型 : System.Object
省略可能です。既定値は 0 です。ここで指定したコード要素の後に、新しい要素を追加します。値が CodeElement の場合は、その値の直後に新しい要素が追加されます。
値が long 型の場合は、後ろに新しい要素を追加する要素が Position によって示されます。
コレクションのカウントは 1 から始まるため、0 を指定すると新しい要素がコレクションの最初に配置されます。値 -1 は要素を末尾に配置することを示します。
戻り値
型 : EnvDTE.CodeAttribute
CodeAttribute オブジェクト。
解説
属性が既に存在する場合、AddAttribute メソッドは別の属性を追加します。属性や、コード モデルの背後にある言語によっては、このことが問題になる場合もあります。
[!メモ]
特定の種類の編集を行った後に、クラス、構造体、関数、属性、デリゲートなどのコード モデル要素の値を決定できないことがあります。つまり、これらの要素の値は、信頼できる値ではなく、常に同じ値になるとは限りません。詳細については、「コード モデルを使用したコードの調査 (Visual Basic)」で、コード モデル要素値を変更する方法についての説明を参照してください。
例
[Visual Basic]
Sub AddAttributeExample(ByVal dte As DTE2)
' Before running this example, open a code document from a project
' and place the insertion point inside a class definition.
Try
' Retrieve the CodeClass at the insertion point.
Dim sel As TextSelection = _
CType(dte.ActiveDocument.Selection, TextSelection)
Dim cls As CodeClass = _
CType(sel.ActivePoint.CodeElement( _
vsCMElement.vsCMElementClass), CodeClass)
' Add an attribute to the class.
cls.AddAttribute("TestAttribute", "TestValue")
Catch ex As Exception
MsgBox(ex.Message)
End Try
End Sub
[C#]
public void AddAttributeExample(DTE2 dte)
{
// Before running this example, open a code document from a project
// and place the insertion point inside a class definition.
try
{
// Retrieve the CodeClass at the insertion point.
TextSelection sel =
(TextSelection)dte.ActiveDocument.Selection;
CodeClass cls =
(CodeClass)sel.ActivePoint.get_CodeElement(
vsCMElement.vsCMElementClass);
// Add an attribute to the class.
cls.AddAttribute("TestAttribute", "TestValue", -1);
}
catch (Exception ex)
{
MessageBox.Show(ex.Message);
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。
参照
関連項目
その他の技術情報
方法 : オートメーション オブジェクト モデルのコード例をコンパイルおよび実行する