Classe DataFile
The DataFile object represents a SQL Server data file.
Hierarquia de herança
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 (em Microsoft.SqlServer.Smo.dll)
Sintaxe
'Declaração
<PhysicalFacetAttribute> _
<SfcElementTypeAttribute("File")> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class DataFile _
Inherits DatabaseFile _
Implements ICreatable, ISfcSupportsDesignMode
'Uso
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
O tipo DataFile expõe os membros a seguir.
Construtores
| Nome | Descrição | |
|---|---|---|
.gif "Método público") |
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. |
Início
Propriedades
| Nome | Descrição | |
|---|---|---|
.gif "Propriedade pública") |
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. (Herdado de 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. (Herdado de SqlSmoObject.) |
|
Size | Gets or sets the current size of the data file in KB. |
|
State | Gets the state of the referenced object. (Herdado de SmoObjectBase.) |
|
Urn | Gets the Uniform Resource Name (URN) address value that uniquely identifies the object. (Herdado de 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. (Herdado de SmoObjectBase.) |
|
VolumeFreeSpace | Gets the volume free space in bytes. |
Início
Métodos
| Nome | Descrição | |
|---|---|---|
|
Alter | Updates any property changes to the object to the instance of Microsoft SQL Server. (Herdado de 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. (Herdado de SqlSmoObject.) |
|
Drop | Drops a database file. (Herdado de DatabaseFile.) |
|
Equals | (Herdado de Object.) |
.gif "Método protegido") |
FormatSqlVariant | Formats an object as SqlVariant type. (Herdado de SqlSmoObject.) |
|
GetContextDB | Gets the context database that is associated with this object. (Herdado de SqlSmoObject.) |
|
GetDBName | Gets the database name that is associated with the object. (Herdado de SqlSmoObject.) |
|
GetHashCode | (Herdado de Object.) |
|
GetPropValue | Gets a property value of the SqlSmoObject object. (Herdado de SqlSmoObject.) |
|
GetPropValueOptional | Gets a property value of the SqlSmoObject object. (Herdado de SqlSmoObject.) |
|
GetPropValueOptionalAllowNull | Gets a property value of the SqlSmoObject object. (Herdado de SqlSmoObject.) |
|
GetServerObject | Gets the server of the SqlSmoObject object. (Herdado de SqlSmoObject.) |
|
GetType | (Herdado de Object.) |
|
Initialize() | Initializes the object and forces the properties be loaded. (Herdado de SqlSmoObject.) |
|
Initialize(Boolean) | Initializes the object and forces the properties be loaded. (Herdado de SqlSmoObject.) |
|
IsObjectInitialized | Verifies whether the object has been initialized. (Herdado de SqlSmoObject.) |
|
IsObjectInSpace | Verifies whether the object is isolated or connected to the instance of SQL Server. (Herdado de SqlSmoObject.) |
|
MarkForDrop | Marks the database file to be dropped next time its parent object is altered by the Alter method. (Herdado de DatabaseFile.) |
|
Refresh | Refreshes the object and retrieves properties when the object is next accessed. (Herdado de SqlSmoObject.) |
|
Rename | Renames a database file. (Herdado de DatabaseFile.) |
|
SetOffline | Sets the database file status to offline. |
|
SetParentImpl | Sets the parent of the SqlSmoObject to the newParent parameter. (Herdado de SqlSmoObject.) |
|
Shrink | Shrinks a database file. (Herdado de DatabaseFile.) |
|
ToString | Returns a String that represents the referenced object. (Herdado de SqlSmoObject.) |
|
Validate | Validates the state of an object. (Herdado de SmoObjectBase.) |
Início
Eventos
| Nome | Descrição | |
|---|---|---|
.gif "Evento público") |
PropertyChanged | Represents the event that occurs when a property is changed. (Herdado de SqlSmoObject.) |
|
PropertyMetadataChanged | Represents the event that occurs when property metadata changes. (Herdado de SqlSmoObject.) |
Início
Implementações de interfaces explícitas
| Nome | Descrição | |
|---|---|---|
.gif "Implementações de interfaces explícitas") .gif "Método privado") |
IAlienObject.Discover | Discovers any dependencies. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SqlSmoObject.) |
|
IAlienObject.GetDomainRoot | Returns the root of the domain. (Herdado de SqlSmoObject.) |
|
IAlienObject.GetParent | Gets the parent of this object. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SqlSmoObject.) |
|
IAlienObject.GetPropertyType | Gets the type of the specified property. (Herdado de SqlSmoObject.) |
|
IAlienObject.GetPropertyValue | Gets the value of the specified property. (Herdado de SqlSmoObject.) |
|
IAlienObject.GetUrn | Gets the Unified Resource Name (URN) of the object. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SqlSmoObject.) |
|
IAlienObject.Resolve | Gets the instance that contains the information about the object from the Unified Resource Name (URN) of the object. (Herdado de SqlSmoObject.) |
|
IAlienObject.SetObjectState | Sets the object state to the specified SfcObjectState value. (Herdado de SqlSmoObject.) |
|
IAlienObject.SetPropertyValue | Sets the property value. (Herdado de SqlSmoObject.) |
|
ISfcPropertyProvider.GetPropertySet | Gets the interface reference to the set of properties of this object. (Herdado de SqlSmoObject.) |
.gif "Propriedade privada") |
ISfcSupportsDesignMode.IsDesignMode | Gets a Boolean value that indicates whether the object supports design mode. |
Início
Comentários
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
Qualquer membro público estático (Compartilhado no Microsoft Visual Basic) desse tipo é seguro para operações multi-threaded. Não há garantia de que qualquer membro de instância seja seguro para threads.
Exemplos
Usando grupos de arquivos e arquivos para armazenar dados
Segurança de thread
Qualquer membro público static (Shared no Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.
Consulte também
Referência
Namespace Microsoft.SqlServer.Management.Smo