Compartir a través de

  • Artículo

Clase Settings

El objeto Settings representa un grupo de valores configurables de la instancia de SQL Server.

Jerarquía de herencia

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

Espacio de nombres:  Microsoft.SqlServer.Management.Smo
Ensamblado:  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Sintaxis

'Declaración
<SfcElementTypeAttribute("Setting")> _
Public NotInheritable Class Settings _
    Inherits SqlSmoObject _
    Implements IAlterable, IScriptable
'Uso
Dim instance As Settings

[SfcElementTypeAttribute("Setting")]
public sealed class Settings : SqlSmoObject, 
    IAlterable, IScriptable

[SfcElementTypeAttribute(L"Setting")]
public ref class Settings sealed : public SqlSmoObject, 
    IAlterable, IScriptable

[<SealedAttribute>]
[<SfcElementTypeAttribute("Setting")>]
type Settings =  
    class
        inherit SqlSmoObject
        interface IAlterable
        interface IScriptable
    end

public final class Settings extends SqlSmoObject implements IAlterable, IScriptable

El tipo Settings expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública AuditLevel Obtiene o establece el nivel de auditoría de la instancia de Microsoft SQL Server.
Propiedad pública BackupDirectory Obtiene el directorio de copia de seguridad predeterminado para la instancia de MicrosoftSQL Server.
Propiedad pública DefaultFile Obtiene o establece el directorio de archivos de datos predeterminado para la instancia de MicrosoftSQL Server.
Propiedad pública DefaultLog Obtiene o establece el directorio de archivos de registro predeterminado para la instancia de MicrosoftSQL Server.
Propiedad protegida ExecuteForScalar Obtiene o establece el valor de propiedad Boolean que especifica si el objeto está establecido para que se ejecute para la opción escalar. (Se hereda de SqlSmoObject.)
Propiedad protegida IsTouched Obtiene el valor de propiedad Boolean que especifica si las propiedades del objeto se han actualizado pero todavía no son persistentes en el servidor. (Se hereda de SqlSmoObject.)
Propiedad pública LoginMode Obtiene o establece el modo de inicio de sesión para SQL Server.
Propiedad pública MailProfile Obtiene o establece el perfil de correo para la instancia de SQL Server.
Propiedad pública NumberOfLogFiles Obtiene o establece el número de archivos de registro que usan las bases de datos de la instancia de SQL Server.
Propiedad protegida ObjectInSpace Obtiene el valor de propiedad Boolean que especifica si el objeto existe en aislamiento, o si está conectado directa o indirectamente con la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Propiedad pública OleDbProviderSettings Hace referencia a una colección de objetos OleDbProviderSettings. Cada objeto OleDbProviderSettings representa la configuración de un proveedor OLE DB.
Propiedad pública Parent Obtiene el objeto Server que es elemento primario del objeto Settings.
Propiedad pública PerfMonMode Obtiene el comportamiento de sondeo del Monitor de rendimiento de la instancia de SQL Server.
Propiedad pública Properties Obtiene una colección de objetos Property que representa las propiedades del objeto. (Se hereda de SqlSmoObject.)
Propiedad protegida ScalarResult Obtiene el resultado escalar para el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Propiedad pública State Gets the state of the referenced object. (Se hereda de SmoObjectBase.)
Propiedad pública TapeLoadWaitTime Obtiene o establece el tiempo que se debe esperar para que se cargue una cinta en un dispositivo de copia de seguridad de cinta.
Propiedad pública Urn Obtiene el valor de la dirección URN (nombre de recursos uniforme) que identifica de forma única el objeto. (Se hereda de SqlSmoObject.)
Propiedad pública UserData Gets or sets user-defined data associated with the referenced object. (Se hereda de SmoObjectBase.)

Arriba

Métodos

  Nombre Descripción
Método protegido AddDatabaseContext(StringCollection) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries. (Se hereda de SqlSmoObject.)
Método protegido AddDatabaseContext(StringCollection, ScriptingOptions) Agrega el contexto de la base de datos a la colección de consultas identificada por el parámetro queries usando las opciones de scripting especificadas. (Se hereda de SqlSmoObject.)
Método público Alter Actualiza cualquier cambio que se produzca en las propiedades del objeto Settings en la instancia de SQL Server. 
Método protegido AlterImpl Activa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplFinish Método al que se llama cuando finaliza el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplInit Método al que se llama cuando se inicializa el evento de objeto modificado. (Se hereda de SqlSmoObject.)
Método protegido AlterImplWorker Llama a los métodos Alter. (Se hereda de SqlSmoObject.)
Método protegido BindDefaultImpl Enlaza los elementos predeterminados identificados por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido BindRuleImpl Enlaza el esquema de la regla a la regla y las columnas identificadas por los parámetros. (Se hereda de SqlSmoObject.)
Método protegido CheckCollation Comprueba el orden de las opciones de scripting por el método de intercalación identificado por el parámetro collationName. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectState() () () () Valida el estado del objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectState(Boolean) Valida el estado del objeto al que se hace referencia, con la opción de especificar que se produzca una excepción si todavía no se ha creado el objeto. (Se hereda de SqlSmoObject.)
Método protegido CheckObjectStateImpl Comprueba el estado de un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion100 Comprueba si la versión de SQL Server es SQL Server 2008. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80 Comprueba la validez del objeto en SQL Server 2000. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion80SP3 Comprueba la validez del objeto en SQL Server 2000 SP3. (Se hereda de SqlSmoObject.)
Método protegido CheckVersion90 Comprueba la validez del objeto en SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CheckVersionBelow90 Comprueba si la versión de SQL Server es anterior a SQL Server 2005. (Se hereda de SqlSmoObject.)
Método protegido CleanObject Establece el objeto en el estado no modificado. (Se hereda de SqlSmoObject.)
Método protegido CreateImpl Crea un objeto con opciones de scripting. (Se hereda de SqlSmoObject.)
Método protegido CreateImplFinish Método al que se llama cuando finaliza el evento Create. (Se hereda de SqlSmoObject.)
Método protegido CreateImplInit Método al que se llama cuando se inicializa el evento Create. (Se hereda de SqlSmoObject.)
Método público Discover Detecta una lista del tipo Object. (Se hereda de SqlSmoObject.)
Método protegido DropImpl Quita un SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido DropImplWorker Llama a los métodos Drop. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImpl Enumera los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorker Llama a los métodos que enumeran los scripts especificados por el parámetro so. (Se hereda de SqlSmoObject.)
Método protegido EnumScriptImplWorkerSOChanged Devuelve una cadena IEnumerable que describe las opciones de scripting de un objeto. (Se hereda de SqlSmoObject.)
Método público Equals (Se hereda de Object.)
Método protegido ExecuteNonQuery (Se hereda de SqlSmoObject.)
Método protegido Finalize (Se hereda de Object.)
Método protegido FormatSqlVariant Da formato a un objeto como tipo SqlVariant. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceFileStreamScript Genera un script para crear el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GenerateDataSpaceScript Genera un script para asignar espacio en el archivo de datos. (Se hereda de SqlSmoObject.)
Método protegido GetBindDefaultScript Obtiene el script que enlaza los valores predeterminados especificados por los parámetros defSchema y defName. (Se hereda de SqlSmoObject.)
Método protegido GetBindRuleScript Obtiene el script que especifica las reglas de enlace. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro booleano del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna una propiedad booleana del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetDateTimeParameter Asigna la propiedad datetime del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetDateTimeParameterAsInt Asigna la propiedad datetime del objeto SqlSmoObject como un valor entero si la propiedad datetime no es NULL. (Se hereda de SqlSmoObject.)
Método protegido GetDBName Obtiene el nombre de la base de datos asociada al objeto. (Se hereda de SqlSmoObject.)
Método protegido GetEnumParameter Asigna una propiedad enumeration del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetFragOptionString Obtiene un objeto FragmentationOption como un valor de cadena. (Se hereda de SqlSmoObject.)
Método protegido GetGuidParameter Asigna una propiedad Guid del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetHashCode (Se hereda de Object.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptional Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetPropValueOptionalAllowNull Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetRealValue Obtiene un valor de propiedad del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetScriptingOptionsForCreate Obtiene ScriptingOptions para el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetServerName Obtiene el nombre de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetServerObject Obtiene el servidor del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetSqlServerVersionName Obtiene el nombre de la versión de la instancia de SQL Server con la que está asociado el objeto. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Asigna un parámetro de cadena del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetTimeSpanParameterAsInt Asigna un parámetro de intervalo de tiempo del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público GetType (Se hereda de Object.)
Método protegido GetUrnRecursive(StringBuilder) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido GetUrnRecursive(StringBuilder, UrnIdOption) Asigna un objeto Urn del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ImplInitialize Inicializa los campos del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Initialize() () () () Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método público Initialize(Boolean) Inicializa el objeto y fuerza la carga de las propiedades. (Se hereda de SqlSmoObject.)
Método protegido IsObjectDirty Comprueba si se han modificado las propiedades del objeto y los cambios todavía no son persistentes en la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInitialized Comprueba si se ha inicializado el objeto. (Se hereda de SqlSmoObject.)
Método protegido IsObjectInSpace Comprueba si el objeto está aislado o conectado a la instancia de SQL Server. (Se hereda de SqlSmoObject.)
Método protegido IsVersion80SP3 Determina si la versión de SQL Server es SQL Server 2000 con SP3. (Se hereda de SqlSmoObject.)
Método protegido IsVersion90AndAbove Determina si la versión de SQL Server es SQL Server 2005 o posterior. (Se hereda de SqlSmoObject.)
Método protegido MarkDropped Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MarkForDropImpl Establece SqlSmoState en quitado. (Se hereda de SqlSmoObject.)
Método protegido MemberwiseClone (Se hereda de Object.)
Método protegido PostAlter Método que se activa tras modificar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostCreate Método que se activa tras crear el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido PostDrop Método que se activa tras quitar el objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Refresh Actualiza el objeto y recupera las propiedades la próxima vez que se tiene acceso al objeto. (Se hereda de SqlSmoObject.)
Método público Script() () () () Genera un script de Transact-SQL que se puede usar para volver a crear la configuración de SQL Server.
Método público Script(ScriptingOptions) Genera un script Transact-SQL que se puede usar para volver a crear la configuración de SQL Server de acuerdo con lo especificado en las opciones de scripting.
Método protegido ScriptAlter Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptCreate Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptDdl Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptDrop Inicia InvalidSmoOperationException. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl() () () () Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImpl(ScriptingOptions) Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido ScriptImplWorker Obtiene una colección de los scripts del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido SetParentImpl Establece el elemento primario del objeto SqlSmoObject en el parámetro newParent. (Se hereda de SqlSmoObject.)
Método público ToString Devuelve un valor String que representa el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Método protegido TouchImpl No implementado. (Se hereda de SqlSmoObject.)
Método protegido UnbindDefaultImpl Desenlaza las columnas predeterminadas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método protegido UnbindRuleImpl Desenlaza las reglas del objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Método público Validate Validates the state of an object. (Se hereda de SmoObjectBase.)

Arriba

Eventos

  Nombre Descripción
Evento público PropertyChanged Representa el evento que se produce cuando se cambia una propiedad. (Se hereda de SqlSmoObject.)
Evento público PropertyMetadataChanged Representa el evento que se produce cuando cambian los metadatos de la propiedad. (Se hereda de SqlSmoObject.)

Arriba

Campos

  Nombre Descripción
Campo protegido m_ExtendedProperties Representa una propiedad definida para extender las propiedades proporcionadas por un objeto SqlSmoObject. (Se hereda de SqlSmoObject.)
Campo protegido singletonParent Representa el elemento primario singleton. (Se hereda de SqlSmoObject.)

Arriba

Implementaciones de interfaces explícitas

  Nombre Descripción
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Discover Detecta las dependencias. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetDomainRoot Devuelve la raíz del dominio. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetParent Obtiene el elemento primario de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyType Obtiene el tipo de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetPropertyValue Obtiene el valor de la propiedad especificada. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .GetUrn Obtiene el Nombre de recursos uniforme del objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .Resolve Obtiene la instancia que contiene la información sobre el objeto del Nombre de recursos unificado del objeto. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetObjectState Establece el estado del objeto en el valor SfcObjectState especificado. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado IAlienObject. . :: . .SetPropertyValue Establece el valor de la propiedad. (Se hereda de SqlSmoObject.)
Implementación de interfaces explícitasMétodo privado ISfcPropertyProvider. . :: . .GetPropertySet Obtiene la referencia de interfaz al conjunto de propiedades de este objeto. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server. (Se hereda de SqlSmoObject.)

Arriba

Comentarios

Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan.

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.

Thread Safety

Todos los miembros estáticos (compartidos en Microsoft Visual Basic) públicos de este tipo son seguros para operaciones multiproceso. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Ejemplos

'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()

Seguridad para subprocesos

Cualquier miembro público static (Shared en Visual Basic) de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.