Skip to content

locationfield-element-visual-studio-project-templates.md

Latest commit

 

History

History
93 lines (73 loc) · 3.21 KB

locationfield-element-visual-studio-project-templates.md

File metadata and controls

93 lines (73 loc) · 3.21 KB
title LocationField Element (Visual Studio Project Templates)
titleSuffix
description Learn about the LocationField element and how it specifies if the New Project dialog box Location text box is enabled, disabled, or hidden for the project template.
ms.date 11/04/2016
ms.subservice general-ide
ms.topic reference
f1_keywords
helpviewer_keywords
LocationField element [Visual Studio project templates]
author tinaschrepfer
ms.author tinali
manager mijacobs

LocationField element (Visual Studio project templates)

Specifies whether or not the Location text box in the New Project dialog box is enabled, disabled, or hidden for the project template.

<VSTemplate> <TemplateData> <LocationField>

Syntax

<LocationField> Enabled/Disabled/Hidden </LocationField>

Attributes and elements

The following sections describe attribute, child elements, and parent elements.

Attributes

None.

Child elements

None.

Parent elements

Element Description
TemplateData Required element.

Categorizes the template and defines how it displays in either the New Project.

Text value

A text value is required.

Valid text values are:

  • Enabled, which specifies that the Location box of the New Project dialog box is enabled.

  • Disabled, which specifies that the Location box of the New Project dialog box is disabled.

  • Hidden, which specifies that the Location box of the New Project dialog box is hidden.

Remarks

The default value is Enabled.

The Location text box in the New Project dialog box enables users to change the default directory in which new projects are saved.

The value specified in the Location element is only honored by the dialog box if the underlying project system supports it.

Example

The following example illustrates the metadata for a Visual C# template.

<VSTemplate Type="Project" Version="3.0.0"
    xmlns="http://schemas.microsoft.com/developer/vstemplate/2005">
    <TemplateData>
        <Name>My template</Name>
        <Description>A basic template</Description>
        <Icon>TemplateIcon.ico</Icon>
        <ProjectType>CSharp</ProjectType>
        <LocationField>Disabled</LocationField>
    </TemplateData>
    <TemplateContent>
        <Project File="MyTemplate.csproj">
            <ProjectItem>Form1.cs<ProjectItem>
            <ProjectItem>Form1.Designer.cs</ProjectItem>
            <ProjectItem>Program.cs</ProjectItem>
            <ProjectItem>Properties\AssemblyInfo.cs</ProjectItem>
            <ProjectItem>Properties\Resources.resx</ProjectItem>
            <ProjectItem>Properties\Resources.Designer.cs</ProjectItem>
            <ProjectItem>Properties\Settings.settings</ProjectItem>
            <ProjectItem>Properties\Settings.Designer.cs</ProjectItem>
        </Project>
    </TemplateContent>
</VSTemplate>

See also