SqlConnectionStringBuilder::AttachDBFilename Property

.NET Framework (current version)

Gets or sets a string that contains the name of the primary data file. This includes the full path name of an attachable database.

Namespace: System.Data.SqlClient
Assembly: System.Data (in System.Data.dll)

Syntax

C++

public:
property String^ AttachDBFilename {
	String^ get();
	void set(String^ value);
}

Property Value

Type: System::String^

The value of the AttachDBFilename property, or String.Empty if no value has been supplied.

Exceptions

Exception	Condition
ArgumentNullException	To set the value to null, use Value.

Remarks

This property corresponds to the "AttachDBFilename", "extended properties", and "initial file name" keys within the connection string.

AttachDBFilename is only supported for primary data files with an .mdf extension.

An error will be generated if a log file exists in the same directory as the data file and the 'database' keyword is used when attaching the primary data file. In this case, remove the log file. Once the database is attached, a new log file will be automatically generated based on the physical path.

Examples

The following example creates a new SqlConnectionStringBuilder instance, and sets the AttachDBFilename property in order to specify the name of an attached data file.

C++

No code example is currently available or this language may not be supported.

Version Information

.NET Framework
Available since 2.0