Classe FileGroup

L'objet FileGroup représente un groupe de fichiers SQL Server. Pour plus d'informations sur les groupes de fichiers, consultez Utilisation de fichiers ou de groupes de fichiers pour stocker des données.

Hiérarchie d'héritage

System. . :: . .Object
  Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
    Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
      Microsoft.SqlServer.Management.Smo. . :: . .NamedSmoObject
        Microsoft.SqlServer.Management.Smo..::..FileGroup

Espace de noms :  Microsoft.SqlServer.Management.Smo
Assembly :  Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

'Déclaration
<PhysicalFacetAttribute> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class FileGroup _
    Inherits NamedSmoObject _
    Implements ICreatable, IAlterable, IDroppable, IRenamable,  _
    IMarkForDrop, ISfcSupportsDesignMode
'Utilisation
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

Le type FileGroup expose les membres suivants.

Constructeurs

	Nom	Description
	FileGroup() () () ()	Initialise une nouvelle instance de la classe FileGroup.
	FileGroup(Database, String)	Initialise une nouvelle instance de la classe FileGroup sur la base de données spécifiée et avec le nom spécifié.
	FileGroup(Database, String, Boolean)	Initialise une nouvelle instance de la classe FileGroup sur la base de données spécifiée, avec le nom spécifié. Facultativement, permet la création d'un groupe de fichiers FILESTREAM.

Haut de la page

Propriétés

	Nom	Description
	ExecuteForScalar	Obtient ou définit la valeur de la propriété Boolean qui spécifie si l'objet est défini selon l'option permettant l'exécution qui retourne une valeur scalaire. (hérité de SqlSmoObject.)
	Files	Représente une collection d'objets DataFile. Chaque objet DataFile représente un fichier appartenant au groupe de fichiers.
	ID	Obtient la valeur d'ID qui identifie de façon unique le groupe de fichiers.
	IsDefault	Obtient ou définit la valeur Boolean qui spécifie si le groupe de fichiers est le groupe de fichiers par défaut pour la base de données.
	IsFileStream	Obtient la valeur Boolean qui spécifie si le groupe de fichiers est de type FILESTREAM.
	IsTouched	Obtient la valeur de la propriété Boolean qui spécifie si les propriétés de l'objet ont été mises à jour mais n'ont pas encore été rendues persistantes sur le serveur. (hérité de SqlSmoObject.)
	Name	Gets or sets the name of the object. (hérité de NamedSmoObject.)
	ObjectInSpace	Obtient la valeur de la propriété Boolean qui spécifie si l'objet existe dans l'isolation, ou s'il est connecté directement ou indirectement à l'instance de SQL Server. (hérité de SqlSmoObject.)
	Parent	Obtient ou définit l'objet parent Database de l'objet FileGroup.
	Properties	Obtient une collection d'objets Property qui représentent les propriétés de l'objet. (hérité de SqlSmoObject.)
	ReadOnly	Obtient la valeur Boolean qui spécifie si le groupe de fichiers est en lecture seule.
	ScalarResult	Obtient le résultat scalaire pour l'objet référencé. (hérité de SqlSmoObject.)
	Size	Obtient ou définit la taille du groupe de fichiers, en Ko.
	State	Gets the state of the referenced object. (hérité de SmoObjectBase.)
	Urn	Obtient la valeur URN (Uniform Resource Name) qui identifie de façon unique l'objet. (hérité de SqlSmoObject.)
	UserData	Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.)

Haut de la page

Méthodes

	Nom	Description
	AddDatabaseContext(StringCollection)	Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries. (hérité de SqlSmoObject.)
	AddDatabaseContext(StringCollection, ScriptingOptions)	Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries, à l'aide des options de script spécifiées. (hérité de SqlSmoObject.)
	Alter	Met à jour toutes les modifications apportées aux propriétés de l'objet FileGroup sur l'instance de SQL Server.
	AlterImpl	Active l'événement d'objet modifié. (hérité de SqlSmoObject.)
	AlterImplFinish	Méthode appelée lorsque l'événement d'objet modifié est terminé. (hérité de SqlSmoObject.)
	AlterImplInit	Méthode appelée lorsque l'événement d'objet modifié est initialisé. (hérité de SqlSmoObject.)
	AlterImplWorker	Appelle les méthodes de modification. (hérité de SqlSmoObject.)
	BindDefaultImpl	Lie les éléments par défaut identifiés par les paramètres. (hérité de SqlSmoObject.)
	BindRuleImpl	Lie le schéma de règle à la règle et aux colonnes identifiées par les paramètres. (hérité de SqlSmoObject.)
	CheckCollation	Vérifie l'ordre des options de script par la méthode de classement identifiée par le paramètre collationName. (hérité de SqlSmoObject.)
	CheckFileGroup	Analyse et teste l'intégrité des pages de bases de données conservées dans les fichiers du système d'exploitation qui implémentent le groupe de fichiers.
	CheckFileGroupDataOnly	Analyse et teste l'intégrité des pages de bases de données utilisées pour conserver les données des tables dans les fichiers du système d'exploitation qui implémentent le groupe de fichiers.
	CheckObjectState() () () ()	Valide l'état de l'objet référencé. (hérité de SqlSmoObject.)
	CheckObjectState(Boolean)	Valide l'état de l'objet référencé avec l'option permettant de spécifier qu'une exception est levée si l'objet n'est pas encore créé. (hérité de SqlSmoObject.)
	CheckObjectStateImpl	Vérifie l'état de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	CheckVersion100	Vérifie si la version de SQL Server est SQL Server 2008. (hérité de SqlSmoObject.)
	CheckVersion80	Vérifie la validité de l'objet sur SQL Server 2000. (hérité de SqlSmoObject.)
	CheckVersion80SP3	Vérifie la validité de l'objet sur SQL Server 2000 SP3. (hérité de SqlSmoObject.)
	CheckVersion90	Vérifie la validité de l'objet sur SQL Server 2005. (hérité de SqlSmoObject.)
	CheckVersionBelow90	Vérifie si la version de SQL Server est antérieure à SQL Server 2005. (hérité de SqlSmoObject.)
	CleanObject	Définit l'objet sur l'état non modifié. (hérité de SqlSmoObject.)
	Create	Crée un groupe de fichiers selon l'objet FileGroup.
	CreateImpl	Crée un objet avec les options de script. (hérité de SqlSmoObject.)
	CreateImplFinish	Méthode appelée lorsque l'événement de création est terminé. (hérité de SqlSmoObject.)
	CreateImplInit	Méthode appelée lorsque l'événement de création est initialisé. (hérité de SqlSmoObject.)
	Discover	Découvre une liste de type Object. (hérité de SqlSmoObject.)
	Drop	Supprime le groupe de fichiers de la base de données.
	DropImpl	Supprime un SqlSmoObject. (hérité de SqlSmoObject.)
	DropImplWorker	Appelle les méthodes de suppression. (hérité de SqlSmoObject.)
	EnumObjects	Énumère les tables système et les tables définies par l'utilisateur, les index et les mécanismes de statistiques stockés dans un groupe de fichiers.
	EnumScriptImpl	Énumère des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
	EnumScriptImplWorker	Appelle les méthodes qui énumèrent des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.)
	EnumScriptImplWorkerSOChanged	Retourne une chaîne IEnumerable qui décrit les options de script pour un objet. (hérité de SqlSmoObject.)
	Equals	(hérité de Object.)
	ExecuteNonQuery	(hérité de SqlSmoObject.)
	Finalize	(hérité de Object.)
	FormatSqlVariant	Met en forme un objet en tant que type SqlVariant. (hérité de SqlSmoObject.)
	GenerateDataSpaceFileStreamScript	Génère un script pour créer un fichier de données. (hérité de SqlSmoObject.)
	GenerateDataSpaceScript	Génère un script pour allouer l'espace dans le fichier de données. (hérité de SqlSmoObject.)
	GetBindDefaultScript	Obtient le script qui lie les valeurs par défaut spécifiées par les paramètres defName et defSchema. (hérité de SqlSmoObject.)
	GetBindRuleScript	Obtient le script qui spécifie les règles de liaison. (hérité de SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre booléen du SqlSmoObject. (hérité de SqlSmoObject.)
	GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte une propriété booléenne du SqlSmoObject. (hérité de SqlSmoObject.)
	GetDateTimeParameter	Affecte une propriété datetime du SqlSmoObject. (hérité de SqlSmoObject.)
	GetDateTimeParameterAsInt	Affecte la propriété datetime du SqlSmoObject comme une valeur entière, si la propriété datetime n'est pas Null. (hérité de SqlSmoObject.)
	GetDBName	Obtient le nom de la base de données associée à l'objet. (hérité de SqlSmoObject.)
	GetEnumParameter	Affecte une propriété d'énumération du SqlSmoObject. (hérité de SqlSmoObject.)
	GetFragOptionString	Obtient un objet FragmentationOption en tant que valeur de chaîne. (hérité de SqlSmoObject.)
	GetGuidParameter	Affecte une propriété Guid du SqlSmoObject. (hérité de SqlSmoObject.)
	GetHashCode	(hérité de Object.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
	GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValue	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValueOptional	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetPropValueOptionalAllowNull	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetRealValue	Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetScriptingOptionsForCreate	Obtient ScriptingOptions pour l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetServerName	Obtient le nom de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
	GetServerObject	Obtient le serveur de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetSqlServerVersionName	Obtient le nom de version de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%)	Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean)	Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetTimeSpanParameterAsInt	Affecte un paramètre d'intervalle de temps de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetType	(hérité de Object.)
	GetUrnRecursive(StringBuilder)	Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	GetUrnRecursive(StringBuilder, UrnIdOption)	Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	ImplInitialize	Initialise les champs de l'objet SqlSmoObject. (hérité de SqlSmoObject.)
	Initialize() () () ()	Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
	Initialize(Boolean)	Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.)
	IsObjectDirty	Vérifie si les propriétés de l'objet ont été modifiées et si les modifications n'ont pas encore été rendues persistantes sur l'instance de SQL Server. (hérité de SqlSmoObject.)
	IsObjectInitialized	Vérifie si l'objet a été initialisé. (hérité de SqlSmoObject.)
	IsObjectInSpace	Vérifie si l'objet est isolé ou connecté à l'instance de SQL Server. (hérité de SqlSmoObject.)
	IsVersion80SP3	Détermine si la version de SQL Server est SQL Server 2000 avec SP3. (hérité de SqlSmoObject.)
	IsVersion90AndAbove	Détermine si la version de SQL Server est SQL Server 2005 ou une version ultérieure. (hérité de SqlSmoObject.)
	MarkDropped	Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
	MarkForDrop	Marque le groupe de fichiers à supprimer la prochaine fois que son objet Database parent est modifié par la méthode Alter.
	MarkForDropImpl	Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.)
	MemberwiseClone	(hérité de Object.)
	PostAlter	Méthode activée après la modification du SqlSmoObject. (hérité de SqlSmoObject.)
	PostCreate	Méthode activée après la création du SqlSmoObject. (hérité de SqlSmoObject.)
	PostDrop	Méthode activée après la suppression du SqlSmoObject. (hérité de SqlSmoObject.)
	Refresh	Actualise l'objet et récupère les propriétés lors du prochain accès à l'objet. (hérité de SqlSmoObject.)
	Rename	Renomme le groupe de fichiers.
	RenameImpl	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.)
	RenameImplWorker	Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. (hérité de NamedSmoObject.)
	ScriptAlter	Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
	ScriptChangeOwner	This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.)
	ScriptCreate	Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.)
	ScriptDdl	Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
	ScriptDrop	Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.)
	ScriptImpl() () () ()	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptImpl(ScriptingOptions)	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptImplWorker	Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.)
	ScriptOwner	Alters the script owner authorization. (hérité de NamedSmoObject.)
	ScriptRename	This method supports the SMO infrastructure and is not intended to be used directly from your code. (hérité de NamedSmoObject.)
	SetParentImpl	Définit le parent du SqlSmoObject sur le paramètre newParent. (hérité de SqlSmoObject.)
	SetSchemaOwned	Sets the schema owned value. (hérité de NamedSmoObject.)
	ToString	Retourne un String qui représente l'objet référencé. (hérité de SqlSmoObject.)
	TouchImpl	Non implémenté. (hérité de SqlSmoObject.)
	UnbindDefaultImpl	Annule la liaison des colonnes par défaut du SqlSmoObject. (hérité de SqlSmoObject.)
	UnbindRuleImpl	Annule la liaison des règles du SqlSmoObject. (hérité de SqlSmoObject.)
	Validate	Validates the state of an object. (hérité de SmoObjectBase.)

Haut de la page

Événements

	Nom	Description
	PropertyChanged	Représente l'événement qui se produit lorsqu'une propriété est modifiée. (hérité de SqlSmoObject.)
	PropertyMetadataChanged	Représente l'événement qui se produit lorsque les métadonnées de la propriété sont modifiées. (hérité de SqlSmoObject.)

Haut de la page

Champs

	Nom	Description
	m_ExtendedProperties	Représente une propriété définie pour étendre les propriétés fournies par un SqlSmoObject. (hérité de SqlSmoObject.)
	singletonParent	Représente le parent de singleton. (hérité de SqlSmoObject.)

Haut de la page

Implémentations d'interfaces explicites

	Nom	Description
	IAlienObject. . :: . .Discover	Découvre les éventuelles dépendances. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .GetDomainRoot	Retourne la racine du domaine. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .GetParent	Obtient le parent de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .GetPropertyType	Obtient le type de la propriété spécifiée. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .GetPropertyValue	Obtient la valeur de la propriété spécifiée. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .GetUrn	Obtient l'URN (Uniform Resource Name) de l'objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .Resolve	Obtient l'instance qui contient les informations relatives à l'objet de l'URN (Unified Resource Name) de l'objet. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .SetObjectState	Définit l'état de l'objet sur la valeur SfcObjectState spécifiée. (hérité de SqlSmoObject.)
	IAlienObject. . :: . .SetPropertyValue	Définit la valeur de la propriété. (hérité de SqlSmoObject.)
	ISfcPropertyProvider. . :: . .GetPropertySet	Obtient la référence d'interface au jeu de propriétés de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.)
	ISfcSupportsDesignMode. . :: . .IsDesignMode	Obtient une valeur booléenne qui indique si l'objet prend en charge le mode Création. Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Haut de la page

Notes

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

Tout membre statique public (Partagé dans Microsoft Visual Basic) de ce type est sûr dans le cadre des opérations à plusieurs threads. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Exemples

Utilisation de fichiers ou de groupes de fichiers pour stocker des données

Sécurité des threads

Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.

Voir aussi

Référence

Espace de noms Microsoft.SqlServer.Management.Smo

Autres ressources

ALTER TABLE (Transact-SQL)

Utilisation des fichiers et des groupes de fichiers

CREATE TABLE (Transact-SQL)