Literal-Element (IntelliSense-Codeausschnitte)

Artikel
02/26/2013

Definiert die Literale des Codeausschnitts, die Sie bearbeiten können.

<Literal Editable="true/false">
   <ID>... </ID>
   <ToolTip>... </ToolTip>
   <Default>... </Default>
   <Function>... </Function>
</Literal>

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
Bearbeitbar	Optionales Boolean-Attribut. Gibt an, ob Sie das Literal nach dem Einfügen des Codeausschnitts bearbeiten können.Der Standardwert dieses Attributs ist true.

Bearbeitbar

Optionales Boolean-Attribut.

Gibt an, ob Sie das Literal nach dem Einfügen des Codeausschnitts bearbeiten können.Der Standardwert dieses Attributs ist true.

Untergeordnete Elemente

Element	Beschreibung
Standardwert	Erforderliches Element. Gibt den Standardwert des Literals an, wenn Sie den Codeausschnitt einfügen.Es muss genau ein Default-Element in einem Literal-Element vorhanden sein.
Funktion	Optionales Element. Gibt eine Funktion an, die ausgeführt werden soll, wenn das Literal in Visual Studio den Fokus erhält.Ein Literal-Element kann kein oder ein Function-Element enthalten.
ID	Erforderliches Element. Gibt einen eindeutigen Bezeichner für das Literal an.Es muss genau ein ID-Element in einem Literal-Element vorhanden sein.
Tooltip	Optionales Element. Beschreibt den erwarteten Wert sowie die Verwendungsweise des Literals.Ein Literal-Element kann kein oder ein Tooltip-Element enthalten.

Übergeordnete Elemente

Element	Beschreibung
Deklarationen	Enthält die Literale und Objekte eines Codeausschnitts, die Sie bearbeiten können.

Hinweise

Das Literal-Element wird verwendet, um eine Ersetzung für ein Codeelement zu kennzeichnen, das zwar vollständig im Ausschnitt enthalten ist, nach dem Einfügen in den Code jedoch wahrscheinlich geändert wird.Literalzeichenfolgen, numerische Werte und einige Variablennamen sollten beispielsweise als Literale deklariert werden.

Literale und Objekte dürfen kein ID-Element mit dem Wert selected oder end enthalten.Der Wert $selected$ stellt Text dar, der im Dokument ausgewählt wird, das beim Aufruf in den Ausschnitt eingefügt werden soll.$end$ markiert den Speicherort, um den Cursor zu setzen, nachdem der Codeausschnitt eingefügt wurde.

Beispiel

Im folgenden Codebeispiel wird veranschaulicht, wie ein Literal mit dem ID-Elementwert SQL deklariert wird.Auf das Literal wird unter Verwendung des Standardtrennzeichens im Code-Element verwiesen.In diesem Beispiel wird mit $SQL$ auf das Literal verwiesen.

<CodeSnippets xmlns="https://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
    <CodeSnippet Format="1.0.0">
        <Header>
            <Title>Create a data adapter</Title>
            <Description>Creates a SqlDataAdapter object.</Description>
            <Author>Microsoft Corporation</Author>
            <Shortcut>createadapter</Shortcut>
        </Header>
        <Snippet>
            <Declarations>
                <Literal>
                    <ID>SQL</ID>
                    <ToolTip>Replace with a SQL connection string.</ToolTip>
                    <Default>"SQL connection string"</Default>
                </Literal>
                <Object>
                    <ID>Connection</ID>
                    <Type>System.Data.SqlClient.SqlConnection</Type>
                    <ToolTip>Replace with a connection object in your application.</ToolTip>
                    <Default>dcConnection</Default>
                </Object>
            </Declarations>
            <Code Language="CSharp">
                <![CDATA[
                    daCustomers = new SqlClient.SqlDataAdapter();
                    selectCommand = new SqlClient.SqlCommand($SQL$);
                    daCustomers.SelectCommand = selectCommand;
                    daCustomers.SelectCommand.Connection = $Connection$;
                ]]>
            </Code>
        </Snippet>
    </CodeSnippet>
</CodeSnippets>

Siehe auch

Konzepte

Schemareferenz für Codeausschnitte

Freigeben über