FileGroup-Klasse

The FileGroup object represents a SQL Server file group. For more information about file groups, see Verwenden von Dateigruppen und Dateien zur Speicherung von Daten.

Vererbungshierarchie

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

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

Syntax

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

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

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

[<SealedAttribute>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
[<PhysicalFacetAttribute>]
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

Der FileGroup-Typ macht folgende Elemente verfügbar.

Konstruktoren

	Name	Beschreibung
	FileGroup()	Initializes a new instance of the FileGroup class.
	FileGroup(Database, String)	Initializes a new instance of the FileGroup class on the specified database that has the specified name.
	FileGroup(Database, String, Boolean)	Initializes a new instance of the FileGroup class on the specified database with the specified name. Optionally, enables a FILESTREAM file group to be created.

Zum Anfang

Eigenschaften

	Name	Beschreibung
	Files	Represents a collection of DataFile objects. Each DataFile object represents a file belonging to the file group.
	ID	Gets the ID value that uniquely identifies the file group.
	IsDefault	Gets or sets the Boolean value that specifies whether the file group is the default file group for the database.
	IsFileStream	Gets the Boolean value that specifies whether the file group is of type FILESTREAM.
	Name	Gets or sets the name of the object. (Geerbt von NamedSmoObject.)
	Parent	Gets or sets the parent Database object of the FileGroup object.
	Properties	Gets a collection of Property objects that represent the object properties. (Geerbt von SqlSmoObject.)
	ReadOnly	Gets the Boolean value that specifies whether the file group is read-only.
	Size	Gets or sets the size of the file group in KB.
	State	Gets the state of the referenced object. (Geerbt von SmoObjectBase.)
	Urn	Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. (Geerbt von SqlSmoObject.)
	UserData	Gets or sets user-defined data associated with the referenced object. (Geerbt von SmoObjectBase.)

Zum Anfang

Methoden

	Name	Beschreibung
	Alter	Updates any property changes to the FileGroup object on the instance of SQL Server.
	CheckFileGroup	Scans and tests the integrity of database pages maintained in operating system files that implement the file group.
	CheckFileGroupDataOnly	Scans and tests the integrity of database pages that are used to maintain table data in operating system files that implement the file group.
	Create	Creates a new file group based on the FileGroup object.
	Discover	Discovers a list of type Object. (Geerbt von SqlSmoObject.)
	Drop	Drops the file group from the database.
	EnumObjects	Enumerates the system and user-defined tables, indexes, and statistics mechanisms stored within a file group.
	Equals	(Geerbt von Object.)
	FormatSqlVariant	Formats an object as SqlVariant type. (Geerbt von SqlSmoObject.)
	GetContextDB	Gets the context database that is associated with this object. (Geerbt von SqlSmoObject.)
	GetDBName	Gets the database name that is associated with the object. (Geerbt von SqlSmoObject.)
	GetHashCode	(Geerbt von Object.)
	GetPropValue	Gets a property value of the SqlSmoObject object. (Geerbt von SqlSmoObject.)
	GetPropValueOptional	Gets a property value of the SqlSmoObject object. (Geerbt von SqlSmoObject.)
	GetPropValueOptionalAllowNull	Gets a property value of the SqlSmoObject object. (Geerbt von SqlSmoObject.)
	GetServerObject	Gets the server of the SqlSmoObject object. (Geerbt von SqlSmoObject.)
	GetType	(Geerbt von Object.)
	Initialize()	Initializes the object and forces the properties be loaded. (Geerbt von SqlSmoObject.)
	Initialize(Boolean)	Initializes the object and forces the properties be loaded. (Geerbt von SqlSmoObject.)
	IsObjectInitialized	Verifies whether the object has been initialized. (Geerbt von SqlSmoObject.)
	IsObjectInSpace	Verifies whether the object is isolated or connected to the instance of SQL Server. (Geerbt von SqlSmoObject.)
	MarkForDrop	Marks the file group to be dropped next time its parent Database object is altered by the Alter method.
	Refresh	Refreshes the object and retrieves properties when the object is next accessed. (Geerbt von SqlSmoObject.)
	Rename	Renames the file group.
	SetParentImpl	Sets the parent of the SqlSmoObject to the newParent parameter. (Geerbt von SqlSmoObject.)
	ToString	Returns a String that represents the referenced object. (Geerbt von SqlSmoObject.)
	Validate	Validates the state of an object. (Geerbt von SmoObjectBase.)

Zum Anfang

Ereignisse

	Name	Beschreibung
	PropertyChanged	Represents the event that occurs when a property is changed. (Geerbt von SqlSmoObject.)
	PropertyMetadataChanged	Represents the event that occurs when property metadata changes. (Geerbt von SqlSmoObject.)

Zum Anfang

Explizite Schnittstellenimplementierungen

	Name	Beschreibung
	IAlienObject.Discover	Discovers any dependencies. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
	IAlienObject.GetDomainRoot	Returns the root of the domain. (Geerbt von SqlSmoObject.)
	IAlienObject.GetParent	Gets the parent of this object. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
	IAlienObject.GetPropertyType	Gets the type of the specified property. (Geerbt von SqlSmoObject.)
	IAlienObject.GetPropertyValue	Gets the value of the specified property. (Geerbt von SqlSmoObject.)
	IAlienObject.GetUrn	Gets the Unified Resource Name (URN) of the object. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.)
	IAlienObject.Resolve	Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. (Geerbt von SqlSmoObject.)
	IAlienObject.SetObjectState	Sets the object state to the specified SfcObjectState value. (Geerbt von SqlSmoObject.)
	IAlienObject.SetPropertyValue	Sets the property value. (Geerbt von SqlSmoObject.)
	ISfcPropertyProvider.GetPropertySet	Gets the interface reference to the set of properties of this object. (Geerbt von SqlSmoObject.)
	ISfcSupportsDesignMode.IsDesignMode	Gets a Boolean value that indicates whether the object supports design mode. Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.

Zum Anfang

Hinweise

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

Alle öffentlichen, statischen Elemente dieses Typs (Shared in Microsoft Visual Basic) sind für Vorgänge mit mehreren Threads sicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Beispiele

Verwenden von Dateigruppen und Dateien zur Speicherung von Daten

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.

Siehe auch

Verweis

Microsoft.SqlServer.Management.Smo-Namespace

Andere Ressourcen

ALTER TABLE (Transact-SQL)

Verwenden von Dateien und Dateigruppen

CREATE TABLE (Transact-SQL)