VCCodeEnum.AddMember Method

Creates a new member code construct and inserts the code in the correct location.

Namespace:  Microsoft.VisualStudio.VCCodeModel
Assembly:  Microsoft.VisualStudio.VCCodeModel (in Microsoft.VisualStudio.VCCodeModel.dll)

Syntax

声明
Function AddMember ( _
    Name As String, _
    Value As Object, _
    Position As Object _
) As CodeVariable
用法
Dim instance As VCCodeEnum
Dim Name As String
Dim Value As Object
Dim Position As Object
Dim returnValue As CodeVariable

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

CodeVariable AddMember(
    string Name,
    Object Value,
    Object Position
)

CodeVariable^ AddMember(
    String^ Name, 
    Object^ Value, 
    Object^ Position
)

function AddMember(
    Name : String, 
    Value : Object, 
    Position : Object
) : CodeVariable

Parameters

• Name
  Type: System.String

  Required. The name of the new member.

• Value
  Type: System.Object

  Optional. The InitExpression() of the CodeVariable object is returned. It can be passed in either as a string or as an expression object.

• Position
  Type: System.Object

  Optional. Default = 0. The code element after which to add the new element. If the value is a CodeElement, then the new element is added immediately after it.

  If the value is a Long data type, then AddMember indicates the element after which to add the new element.

  Because collections begin their count at 1, passing 0 indicates that the new element should be placed at the beginning of the collection. A value of -1 means the element should be placed at the end.

Return Value

Type: CodeVariable

A CodeVariable object.

Remarks

AddMember adds a member to the enumeration and returns a CodeVariable object with IsConstant() set to true.

When setting Value to a string, AddMember inserts any required syntax, such as equal signs or semicolons if the variable does not already have an initialization expression. Depending on the languages and any syntactic or semantic checks it performs on the passed-in string, setting this argument may fail. Languages are not required to check the string, and because the string is necessarily language-dependent, setting this argument could result in undefined behavior if the string has any ill-formed content.

When setting Value to a CodeElement, the decision as to whether the CodeElement must be newly created depends on the language implementation of the code model. Some languages may implement copying semantics if you pass in a code element that is already in a source file.

The correctness of the arguments is determined by the language behind the code model.

Permissions

• Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

See Also

Concepts

How to: Compile and Run the Automation Object Model Code Examples

Reference

VCCodeEnum Interface

VCCodeEnum Members

Microsoft.VisualStudio.VCCodeModel Namespace