Share via


Settings Class

The Settings object represents a group of configurable settings on the instance of Microsoft SQL Server.

Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in microsoft.sqlserver.smo.dll)

Syntax

'Declaration
Public NotInheritable Class Settings
    Inherits SqlSmoObject
    Implements IAlterable, IScriptable
public sealed class Settings : SqlSmoObject, IAlterable, IScriptable
public ref class Settings sealed : public SqlSmoObject, IAlterable, IScriptable
public final class Settings extends SqlSmoObject implements IAlterable, IScriptable
public final class Settings extends SqlSmoObject implements IAlterable, IScriptable

Remarks

Updated text:

Updated text:

This namespace, class, or member is supported only in version 2.0 of the Microsoft .NET Framework.

To get Settings object properties, users can be a member of the public fixed server role.

To set Settings object properties, users must be a member of the sysadmin fixed server role.

Inheritance Hierarchy

System.Object
   Microsoft.SqlServer.Management.Smo.SmoObjectBase
     Microsoft.SqlServer.Management.Smo.SqlSmoObject
      Microsoft.SqlServer.Management.Smo.Settings

Example

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Display information about the instance of SQL Server in Information and Settings.
Console.WriteLine("OS Version = " & srv.Information.OSVersion)
Console.WriteLine("State = " & srv.Settings.State.ToString)
'Display information specific to the current user in UserOptions.
Console.WriteLine("Quoted Identifier support = " & srv.UserOptions.QuotedIdentifier)
'Modify server settings in Settings.

srv.Settings.LoginMode = ServerLoginMode.Integrated
'Modify settings specific to the current connection in UserOptions.
srv.UserOptions.AbortOnArithmeticErrors = True
'Run the Alter method to make the changes on the instance of SQL Server.
srv.Alter()

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server 2005.

See Also

Reference

Settings Members
Microsoft.SqlServer.Management.Smo Namespace

Other Resources

How to: Modify SQL Server Settings in Visual Basic .NET
Configuring SQL Server in SMO

Change History

Release

History

New content:
  • Added text to the Remarks section of the DefaultLog and DefaultFile properties.

New content:
  • Added code snippet to the Example section.