CodeDelegate2.AddAttribute 方法 (String, String, Object)

發行項
10/28/2012

建立新的屬性程式碼建構，並在正確位置插入程式碼。

命名空間： 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
必要項。新屬性 (Attribute) 的名稱。

Value
型別：System.String
必要項。屬性 (Attribute) 的值，對於具有參數的屬性 (Property)，它可能是以逗號分隔的參數清單。

Position
型別：System.Object
選擇項。預設値 = 0。其後要加入新項目的程式碼項目。
如果 Value 是長整數資料型別，那麼 AddAttribute 會指出其後要加入新項目的項目。
由於集合是從 1 開始計算，傳遞 0 表示新的項目必須放在集合起始的位置。值為 -1 時表示這個項目必須放在集合結尾的位置。

傳回值

型別：EnvDTE.CodeAttribute
CodeAttribute 物件。

備註

如果屬性已經存在，AddAttribute 會加入另一個屬性。這對於該屬性或程式碼模型後的語言可能會不正確。

注意事項
在特定類型的編輯之後，程式碼模型項目 (例如類別、結構、函式、屬性、委派等) 的值可能不具決定性，表示其值不一定維持相同。如需詳細資訊，請參閱使用程式碼模型探索程式碼 (Visual Basic) 的＜程式碼模型項目值可以變更＞一節。

範例

在執行這個範例之前，請先載入具有類別的專案，並在範例程式碼中插入以下程式碼行。當這個程式碼行和範例程式碼都加入之後，請按一下 [Delegate] 這一行並將插入點置於此，接著再執行這個範例。

[VisualBasic]

Delegate Sub MySubDelegate(ByVal x As Integer)

[C#]

public delegate void MySubDelegate(int x);

[VisualBasic]

Public Sub addDelegateAttribExample(ByVal dte As DTE2)
    Try
        ' Retrieve the CodeClass at the insertion point.
        Dim sel As TextSelection = _
          CType(dte.ActiveDocument.Selection, TextSelection)
        Dim del As CodeDelegate2 = _
          CType(sel.ActivePoint.CodeElement( _
        vsCMElement.vsCMElementDelegate), CodeDelegate2)

        ' Add a new attribute to the delegate.
        del.AddAttribute("someNewAttribute", "someValue", -1)
    Catch ex As System.Exception
        MsgBox(ex.ToString)
    End Try
End Sub