DataFile-Klasse
The DataFile object represents a SQL Server data file.
Vererbungshierarchie
System.Object
Microsoft.SqlServer.Management.Smo.SmoObjectBase
Microsoft.SqlServer.Management.Smo.SqlSmoObject
Microsoft.SqlServer.Management.Smo.NamedSmoObject
Microsoft.SqlServer.Management.Smo.DatabaseFile
Microsoft.SqlServer.Management.Smo.DataFile
Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)
Syntax
'Declaration
<PhysicalFacetAttribute> _
<SfcElementTypeAttribute("File")> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class DataFile _
Inherits DatabaseFile _
Implements ICreatable, ISfcSupportsDesignMode
'Usage
Dim instance As DataFile
[PhysicalFacetAttribute]
[SfcElementTypeAttribute("File")]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)]
public sealed class DataFile : DatabaseFile,
ICreatable, ISfcSupportsDesignMode
[PhysicalFacetAttribute]
[SfcElementTypeAttribute(L"File")]
[EvaluationModeAttribute(AutomatedPolicyEvaluationMode::CheckOnSchedule)]
public ref class DataFile sealed : public DatabaseFile,
ICreatable, ISfcSupportsDesignMode
[<SealedAttribute>]
[<PhysicalFacetAttribute>]
[<SfcElementTypeAttribute("File")>]
[<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)>]
type DataFile =
class
inherit DatabaseFile
interface ICreatable
interface ISfcSupportsDesignMode
end
public final class DataFile extends DatabaseFile implements ICreatable, ISfcSupportsDesignMode
Der DataFile-Typ macht folgende Elemente verfügbar.
Konstruktoren
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Methode") |
DataFile() | Initializes a new instance of the DataFile class. |
|
DataFile(FileGroup, String) | Initializes a new instance of the DataFile class on the specified file group with the specified name. |
|
DataFile(FileGroup, String, String) | Initializes a new instance of the DataFile class on the specified file group with the specified name and file name. |
Zum Anfang
Eigenschaften
| Name | Beschreibung | |
|---|---|---|
.gif "Öffentliche Eigenschaft") |
AvailableSpace | Gets the amount of available space in the data file in KB. |
|
BytesReadFromDisk | Gets the number of bytes read from disk. |
|
BytesWrittenToDisk | Gets the number of bytes written to disk. |
|
FileName | Gets or sets the data file name. |
|
Growth | Gets or sets the growth increment for the data file in KB or percent. |
|
GrowthType | Gets or sets the growth type for the data file in kilobytes or percent. |
|
ID | Gets the ID value that uniquely identifies the data file. |
|
IsOffline | Gets the Boolean property value that specifies whether the data file is offline or not. |
|
IsPrimaryFile | Gets the Boolean property value that specifies whether the data file is the primary file of the database. |
|
IsReadOnly | Gets the Boolean property value that specifies whether the data file is read-only or can be updated. |
|
IsReadOnlyMedia | Gets the Boolean property value that specifies whether the data file is stored on read-only media. |
|
IsSparse | Gets the Boolean value that specifies whether the file is a sparse file. Sparse files are used in database snapshots. |
|
MaxSize | Gets or set the maximum size to which the data file can grow in KB. |
|
Name | Gets or sets the name of the object. (Geerbt von NamedSmoObject.) |
|
NumberOfDiskReads | Gets the number of disk reads. |
|
NumberOfDiskWrites | Gets the number of disk writes. |
|
Parent | Gets or sets the FileGroup object that is the parent of the DataFile object. |
|
Properties | Gets a collection of Property objects that represent the object properties. (Geerbt von SqlSmoObject.) |
|
Size | Gets or sets the current size of the data file 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.) |
|
UsedSpace | Gets the amount of used space in the data file in KB. |
|
UserData | Gets or sets user-defined data associated with the referenced object. (Geerbt von SmoObjectBase.) |
|
VolumeFreeSpace | Gets the volume free space in bytes. |
Zum Anfang
Methoden
| Name | Beschreibung | |
|---|---|---|
|
Alter | Updates any property changes to the object to the instance of Microsoft SQL Server. (Geerbt von DatabaseFile.) |
|
Create | Creates a data file on the instance of SQL Server as defined by the DataFile object. |
|
Discover | Discovers a list of type Object. (Geerbt von SqlSmoObject.) |
|
Drop | Drops a database file. (Geerbt von DatabaseFile.) |
|
Equals | (Geerbt von Object.) |
.gif "Geschützte Methode") |
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 database file to be dropped next time its parent object is altered by the Alter method. (Geerbt von DatabaseFile.) |
|
Refresh | Refreshes the object and retrieves properties when the object is next accessed. (Geerbt von SqlSmoObject.) |
|
Rename | Renames a database file. (Geerbt von DatabaseFile.) |
|
SetOffline | Sets the database file status to offline. |
|
SetParentImpl | Sets the parent of the SqlSmoObject to the newParent parameter. (Geerbt von SqlSmoObject.) |
|
Shrink | Shrinks a database file. (Geerbt von DatabaseFile.) |
|
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 | |
|---|---|---|
.gif "Öffentliches Ereignis") |
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 | |
|---|---|---|
.gif "Explizite Schnittstellenimplementierung") .gif "Private Methode") |
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.) |
.gif "Private Eigenschaft") |
ISfcSupportsDesignMode.IsDesignMode | Gets a Boolean value that indicates whether the object supports design mode. |
Zum Anfang
Hinweise
To get the DataFile object properties, users can be a member of the public fixed server role.
To set the DataFile object properties, users must have ALTER permission on the database or be a member of the db_owner fixed database role.
To create a data file, users must have ALTER permission on the database or be a member of the db_owner fixed database role.
To drop a data file, users must have ALTER permission on the database or be a member of the db_owner fixed database 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