# <vsslabel>

[This is preliminary documentation and subject to change.]

Used to apply a label to a Visual Source Safe item.

### Parameters

Attribute | Type | Description | Required
--- | --- | --- | ---
label | string | The name of the label. | True
comment | string | The label comment. | False
dbpath | file | The path to the folder that contains "srcsafe.ini". | True
path | string | The Visual SourceSafe project or file path you wish the perform the action on (starting with "$/"). | True
failonerror | bool | Determines if task failure stops the build, or is just reported. The default is true. | False
if | bool | If true then the task will be executed; otherwise, skipped. The default is true. | False
password | string | The password to use to login to the SourceSafe database. | False
unless | bool | Opposite of `if`. If false then the task will be executed; otherwise, skipped. The default is false. | False
user | string | Deprecated. The name of the user needed to access the Visual SourceSafe database. When no `username` is specified and "Use network name for automatic user log in" is enabled, then the current Windows username will be used to log in. | False
username | string | The name of the user needed to access the Visual SourceSafe database. When no `username` is specified and "Use network name for automatic user log in" is enabled for the Visual SourceSafe database, then the current Windows username will be used to log in. | False
verbose | bool | Determines whether the task should report detailed build log messages. The default is false. | False
version | string | A version of the path to reference. Accepts multiple forms, including the label, version number, or date of the version. If omitted, the latest version is used. | False

### Examples

- Label all files in a local sourcesafe database. (Automatically applies the label recursively)

                      <vsslabel
                        user="myusername"
                        password="mypassword"
                        dbpath="C:\VSS\srcsafe.ini"
                        path="$/MyProduct"
                        comment="NAnt label"
                        label="myLabel"
                      />

- Label a file in a remote sourcesafe database.

                      <vsslabel
                        user="myusername"
                        password="mypassword"
                        dbpath="\\MyServer\VSS\srcsafe.ini"
                        path="$/MyProduct/myFile.cs"
                        comment="NAnt label"
                        label="myLabel"
                      />

### Requirements

Assembly: NAnt.Contrib.Tasks (0.93.5002.0)