Share via

  • Artículo

Clase FileGroup

El objeto FileGroup representa un grupo de archivos de SQL Server. Para obtener más información acerca de los grupos de archivos, vea Utilizar grupos de archivos y archivos para almacenar datos.

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

Sintaxis

'Declaración
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class FileGroup _
    Inherits NamedSmoObject _
    Implements ICreatable, IAlterable, IDroppable, IRenamable,  _
    IMarkForDrop, ISfcSupportsDesignMode
'Uso
Dim instance As FileGroup

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class FileGroup : NamedSmoObject, 
    ICreatable, IAlterable, IDroppable, IRenamable, IMarkForDrop, 
    ISfcSupportsDesignMode

[PhysicalFacetAttribute]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class FileGroup sealed : public NamedSmoObject, 
    ICreatable, IAlterable, IDroppable, IRenamable, IMarkForDrop, 
    ISfcSupportsDesignMode

[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type FileGroup =  
    class
        inherit NamedSmoObject
        interface ICreatable
        interface IAlterable
        interface IDroppable
        interface IRenamable
        interface IMarkForDrop
        interface ISfcSupportsDesignMode
    end

public final class FileGroup extends NamedSmoObject implements ICreatable, IAlterable, IDroppable, IRenamable, IMarkForDrop, ISfcSupportsDesignMode

El tipo FileGroup expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público FileGroup() () () () Inicializa una nueva instancia de la clase FileGroup.
Método público FileGroup(Database, String) Inicializa una nueva instancia de la clase FileGroup en la base de datos especificada y con el nombre especificado.
Método público FileGroup(Database, String, Boolean) Inicializa una nueva instancia de la clase FileGroup en la base de datos especificada y con el nombre especificado. También permite crear un grupo de archivos FILESTREAM.

Arriba

Propiedades

  Nombre Descripción
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 pública Files Representa una recopilación de objetos DataFile. Cada objeto DataFile representa un archivo que pertenece al grupo de archivos.
Propiedad pública ID Obtiene el valor de identificador que identifica de forma única el grupo de archivos.
Propiedad pública IsDefault Obtiene o establece el valor Boolean que especifica si el grupo de archivos es el grupo de archivos predeterminado de la base de datos.
Propiedad pública IsFileStream Obtiene el valor Boolean que especifica si el grupo de archivos es del tipo FILESTREAM.
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 Name Gets or sets the name of the object. (Se hereda de NamedSmoObject.)
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 Parent Obtiene o establece el objeto Database primario del objeto FileGroup.
Propiedad pública Properties Obtiene una colección de objetos Property que representa las propiedades del objeto. (Se hereda de SqlSmoObject.)
Propiedad pública ReadOnly Obtiene el valor Boolean que especifica si el grupo de archivos es de solo lectura.
Propiedad protegida ScalarResult Obtiene el resultado escalar para el objeto al que se hace referencia. (Se hereda de SqlSmoObject.)
Propiedad pública Size Obtiene o establece el tamaño del grupo de archivos en KB.
Propiedad pública State Gets the state of the referenced object. (Se hereda de SmoObjectBase.)
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 FileGroup 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 público CheckFileGroup Examina y prueba la integridad de las páginas de la base datos que se mantienen en los archivos del sistema operativo que implementan el grupo de archivos.
Método público CheckFileGroupDataOnly Examina y prueba la integridad de las páginas de la base datos que se usan para mantener los datos de tabla en los archivos del sistema operativo que implementan el grupo de archivos.
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 público Create Crea un nuevo grupo de archivos basándose en el objeto FileGroup.
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 público Drop Quita el grupo de archivos de la base de datos.
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 público EnumObjects Enumera el sistema y las tablas, los índices y los mecanismos de estadísticas definidos por el usuario que están almacenados en un grupo de archivos.
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 público MarkForDrop Marca el grupo de archivos para quitarlo la próxima vez que su objeto Database primario se modifique con el método Alter.
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 Rename Cambia el nombre del grupo de archivos.
Método protegido RenameImpl Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método protegido RenameImplWorker Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada. (Se hereda de NamedSmoObject.)
Método protegido ScriptAlter Modifica el objeto SqlSmoObject de acuerdo con los parámetros. (Se hereda de SqlSmoObject.)
Método protegido ScriptChangeOwner This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
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 ScriptOwner Alters the script owner authorization. (Se hereda de NamedSmoObject.)
Método protegido ScriptRename This method supports the SMO infrastructure and is not intended to be used directly from your code. (Se hereda de NamedSmoObject.)
Método protegido SetParentImpl Establece el elemento primario del objeto SqlSmoObject en el parámetro newParent. (Se hereda de SqlSmoObject.)
Método protegido SetSchemaOwned Sets the schema owned value. (Se hereda de NamedSmoObject.)
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.)
Implementación de interfaces explícitasPropiedad privada ISfcSupportsDesignMode. . :: . .IsDesignMode Obtiene un valor booleano que indica si el objeto admite el modo de diseño. Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.

Arriba

Comentarios

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

To set FileGroup object properties, users must have ALTER permission on the database or be a member of the db_owner fixed database role.

To create a file group, users must have ALTER permission on the database or be a member of the db_owner fixed database role.

To drop a file group, users must have ALTER permission on the database or be a member of the db_owner fixed database role.

To run CheckFileGroup and CheckFileGroupDataOnly methods, users must be a member of the db_owner fixed database role or 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.

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.