This documentation is archived and is not being maintained.

SqlConnectionStringBuilder.UserInstance Property

Note: This property is new in the .NET Framework version 2.0.

Gets or sets a value that indicates whether to redirect the connection from the default SQL Server Express instance to a runtime-initiated instance running under the account of the caller.

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

public bool UserInstance { get; set; 
/** @property */
public boolean get_UserInstance ()

/** @property */
public void set_UserInstance (boolean value)

public function get UserInstance () : boolean

public function set UserInstance (value : boolean)

Property Value

The value of the UserInstance property, or False if none has been supplied.

This property corresponds to the "User Instance" key within the connection string. If the value passed in is null when you try to set the property, the UserInstance property is reset. If the value has not been set and the developer tries to retrieve the property, the return value is False.

NoteNote

This feature is available only with the SQL Server 2005 Express Edition. For more information on user instances, see Working with User Instances and "User Instances for Non-Administrators" in SQL Server Books Online.

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: