CodeAttribute2.AddArgument – metoda

Článek
08/11/2011

Přidá atribut argument.

Obor názvů: EnvDTE80
Sestavení: EnvDTE80 (v EnvDTE80.dll)

Syntaxe

'Deklarace
Function AddArgument ( _
    Value As String, _
    Name As Object, _
    Position As Object _
) As CodeAttributeArgument

CodeAttributeArgument AddArgument(
    string Value,
    Object Name,
    Object Position
)

CodeAttributeArgument^ AddArgument(
    String^ Value, 
    [InAttribute] Object^ Name, 
    [InAttribute] Object^ Position
)

abstract AddArgument : 
        Value:string * 
        Name:Object * 
        Position:Object -> CodeAttributeArgument

function AddArgument(
    Value : String, 
    Name : Object, 
    Position : Object
) : CodeAttributeArgument

Parametry

Value
Typ: System.String
Povinné.Výchozí hodnota je 0. prvek, po které chcete přidat nový prvek.Pokud je hodnota CodeElement, pak se vkládá nový prvek v argumentu CodeElement.Pokud je hodnota Long Typ dat označuje po které chcete přidat nový prvek a pak.Protože kolekce vycházející z jedničky, procházející nula označuje nový prvek uvádět na začátku sběru.Hodnota-1 znamená umístit na konci argument.

Name
Typ: System.Object
Povinné.Hodnota argumentu.

Position
Typ: System.Object
Nepovinné.Pokud je argument pojmenovaného parametru, tento parametr obsahuje název argumentu.

Vrácená hodnota

Typ: EnvDTE80.CodeAttributeArgument
A CodeAttributeArgument objektu.

Poznámky

Poznámka

Kód hodnoty argumentu atributu, po přiřazen, nejsou zachovány v paměti pomocí Visual Studio, tedy může nebo nemusí být platné dojde budoucí aktualizace argumentu atributu kód. Další argument access může vrátit, E_FAIL nebo zcela jinou hodnotu. (Vše, co děti prvku ovlivňuje však nemá problém.)

V důsledku tohoto chování deterministický měly načíst hodnoty v argumentu před jeho změna. Pokud nastavíte argument atributu kód v kódu, jako například myAttrArg.Value = """a first value""", pak je měly explicitně odkazovat jej před aktualizací, například myAttrArg = myAttr.Arguments.Item("first value")a potom přiřadit novou hodnotu myAttrArg.Value = """a second value""". Tím předejdete změní správný argument.

Hodnoty prvků modelu kód jako třídy, struktury, funkce, atributy, delegátů a tak dále mohou být také-deterministický po provedení určité typy úprav, což znamená, že jejich hodnoty nelze dovolávat vždy zůstává stejné. Další informace naleznete v části Změna hodnoty prvku modelu kódu Discovering Code by Using the Code Model (Visual Basic).

Příklady

Následující příklad vytvoří nový obor názvů a atribut aktuální třídy a jsou uvedeny některé vlastnosti atributu.

public void CreateClassAndAttrib(DTE2 applicationObject)
{
    // Before running, load or create a project.
    FileCodeModel2 fcm2 = GetFileCodeModel(applicationObject);
    CodeAttribute2 cmAttribute;
    CodeClass2 cmClass;
    String msg = null;

    if (fcm2 != null)
    {
        CodeNamespace cmNamespace;
        // Try to create a new namespace.
        try
        {
            cmNamespace = fcm2.AddNamespace("CMNamespace", -1);
            // If successful, create the other code elements.
            if (cmNamespace != null)
            {
                cmClass = (CodeClass2)cmNamespace.AddClass("ANewClass", 
                -1, null, null, vsCMAccess.vsCMAccessPrivate);
                cmAttribute = (CodeAttribute2)cmClass.AddAttribute
                ("NewAttribute", "AttributeValue", -1);
                msg += "# of Arguments: " + cmAttribute.Arguments.Count 
                + Environment.NewLine;
                MessageBox.Show(msg);
                cmAttribute.AddArgument("NewAddedValue", null, null);
                msg += "# of Arguments: " + cmAttribute.Arguments.Count 
                + Environment.NewLine;
                MessageBox.Show(msg);                       
            }
            else
            {
                MessageBox.Show("Cannot continue - no filecodemodel 
                available.");
            }
        }
        catch (Exception ex)
        {
            MessageBox.Show("ERROR: " + ex);
        }
    }
}

public FileCodeModel2 GetFileCodeModel(DTE2 applicationObject)
{
    // Returns the FileCodeModel object of the active 
    // window.
    TextWindow txtWin = 
    (TextWindow)applicationObject.ActiveWindow.Object;
    FileCodeModel2 fcm2;
    if (txtWin != null)
    {
        try
        {
             fcm2 = (FileCodeModel2)txtWin.Parent.
             ProjectItem.FileCodeModel;
             return fcm2;
        }
        catch (Exception ex)
        {
             MessageBox.Show("ERROR: " + ex);
             return null;
        }
    }
    else
        return null;
}

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.