• Articolo

Classe DataFile

The DataFile object represents a SQL Server data file.

Spazio dei nomi  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Sintassi

'Dichiarazione
<PhysicalFacetAttribute> _
<SfcElementTypeAttribute("File")> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class DataFile _
    Inherits DatabaseFile _
    Implements ICreatable, ISfcSupportsDesignMode
'Utilizzo
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

Nel tipo DataFile sono esposti i membri seguenti.

Costruttori

  Nome Descrizione
Metodo pubblico DataFile() () () () Initializes a new instance of the DataFile class.
Metodo pubblico DataFile(FileGroup, String) Initializes a new instance of the DataFile class on the specified file group with the specified name.
Metodo pubblico 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 alto

Proprietà

  Nome Descrizione
Proprietà pubblica AvailableSpace Gets the amount of available space in the data file in KB.
Proprietà pubblica BytesReadFromDisk Gets the number of bytes read from disk.
Proprietà pubblica BytesWrittenToDisk Gets the number of bytes written to disk.
Proprietà protetta ExecuteForScalar Ottiene o imposta il valore della proprietà Boolean che specifica se l'oggetto viene impostato su Esegui per l'opzione scalare. Ereditato da SqlSmoObject.
Proprietà pubblica FileName Gets or sets the data file name.
Proprietà pubblica Growth Gets or sets the growth increment for the data file in KB or percent.
Proprietà pubblica GrowthType Gets or sets the growth type for the data file in kilobytes or percent.
Proprietà pubblica ID Gets the ID value that uniquely identifies the data file.
Proprietà pubblica IsOffline Gets the Boolean property value that specifies whether the data file is offline or not.
Proprietà pubblica IsPrimaryFile Gets the Boolean property value that specifies whether the data file is the primary file of the database.
Proprietà pubblica IsReadOnly Gets the Boolean property value that specifies whether the data file is read-only or can be updated.
Proprietà pubblica IsReadOnlyMedia Gets the Boolean property value that specifies whether the data file is stored on read-only media.
Proprietà pubblica IsSparse Gets the Boolean value that specifies whether the file is a sparse file. Sparse files are used in database snapshots.
Proprietà protetta IsTouched Ottiene il valore della proprietà Boolean che specifica se le proprietà dell'oggetto sono state aggiornate ma non sono ancora persistenti nel server. Ereditato da SqlSmoObject.
Proprietà pubblica MaxSize Gets or set the maximum size to which the data file can grow in KB.
Proprietà pubblica Name Gets or sets the name of the object. Ereditato da NamedSmoObject.
Proprietà pubblica NumberOfDiskReads Gets the number of disk reads.
Proprietà pubblica NumberOfDiskWrites Gets the number of disk writes.
Proprietà protetta ObjectInSpace Ottiene il valore della proprietà Boolean che specifica se l'oggetto esiste in isolamento o se è connesso direttamente o indirettamente all'istanza di SQL Server. Ereditato da SqlSmoObject.
Proprietà pubblica Parent Gets or sets the FileGroup object that is the parent of the DataFile object.
Proprietà pubblica Properties Ottiene una raccolta di oggetti Property che rappresentano le proprietà dell'oggetto. Ereditato da SqlSmoObject.
Proprietà protetta ScalarResult Ottiene il risultato scalare per l'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Proprietà pubblica Size Gets or sets the current size of the data file in KB.
Proprietà pubblica State Gets the state of the referenced object. Ereditato da SmoObjectBase.
Proprietà pubblica Urn Ottiene il valore dell'indirizzo URN (Uniform Resource Name) che identifica in modo univoco l'oggetto. Ereditato da SqlSmoObject.
Proprietà pubblica UsedSpace Gets the amount of used space in the data file in KB.
Proprietà pubblica UserData Gets or sets user-defined data associated with the referenced object. Ereditato da SmoObjectBase.
Proprietà pubblica VolumeFreeSpace Gets the volume free space in bytes.

In alto

Metodi

  Nome Descrizione
Metodo protetto AddDatabaseContext(StringCollection) Aggiungere il contesto del database alla raccolta di query identificate dal parametro queries. Ereditato da SqlSmoObject.
Metodo protetto AddDatabaseContext(StringCollection, ScriptingOptions) Aggiungere il contesto del database alla raccolta di query identificate dal parametro queries e utilizzando le opzioni di scripting specificate. Ereditato da SqlSmoObject.
Metodo pubblico Alter Updates any property changes to the object to the instance of Microsoft SQL Server. Ereditato da DatabaseFile.
Metodo protetto AlterImpl Attiva l'evento modificato dall'oggetto. Ereditato da SqlSmoObject.
Metodo protetto AlterImplFinish Metodo chiamato quando l'evento modificato dall'oggetto viene completato. Ereditato da SqlSmoObject.
Metodo protetto AlterImplInit Metodo chiamato quando l'evento modificato dall'oggetto viene inizializzato. Ereditato da SqlSmoObject.
Metodo protetto AlterImplWorker Chiama i metodi Alter. Ereditato da SqlSmoObject.
Metodo protetto BindDefaultImpl Associa gli elementi predefiniti identificati dai parametri. Ereditato da SqlSmoObject.
Metodo protetto BindRuleImpl Associa lo schema della regola alla regola e alle colonne identificate dai parametri. Ereditato da SqlSmoObject.
Metodo protetto CheckCollation Verifica l'ordine delle opzioni di scripting mediante il metodo delle regole di confronto identificato dal parametro collationName. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectState() () () () Convalida lo stato dell'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectState(Boolean) Convalida lo stato dell'oggetto a cui si fa riferimento con l'opzione che specifica di generare un'eccezione se l'oggetto non è stato ancora creato. Ereditato da SqlSmoObject.
Metodo protetto CheckObjectStateImpl Verifica lo stato di un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion100 Verifica se la versione di SQL Server è SQL Server 2008. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion80 Verifica la validità dell'oggetto in SQL Server 2000. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion80SP3 Verifica la validità dell'oggetto in SQL Server 2000 SP3. Ereditato da SqlSmoObject.
Metodo protetto CheckVersion90 Verificare la validità dell'oggetto in SQL Server 2005. Ereditato da SqlSmoObject.
Metodo protetto CheckVersionBelow90 Verifica se la versione di SQL Server è precedente a SQL Server 2005. Ereditato da SqlSmoObject.
Metodo protetto CleanObject Imposta l'oggetto su uno stato non modificato. Ereditato da SqlSmoObject.
Metodo pubblico Create Creates a data file on the instance of SQL Server as defined by the DataFile object.
Metodo protetto CreateImpl Crea un oggetto con opzioni di scripting. Ereditato da SqlSmoObject.
Metodo protetto CreateImplFinish Metodo chiamato quando l'evento Create viene completato. Ereditato da SqlSmoObject.
Metodo protetto CreateImplInit Metodo chiamato quando l'evento Create viene inizializzato. Ereditato da SqlSmoObject.
Metodo pubblico Discover Individua un elenco di tipo Object. Ereditato da SqlSmoObject.
Metodo pubblico Drop Drops a database file. Ereditato da DatabaseFile.
Metodo protetto DropImpl Elimina un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto DropImplWorker Chiama i metodi Drop. Ereditato da SqlSmoObject.
Metodo protetto EnumScriptImpl Enumera gli script specificati dal parametro so. Ereditato da SqlSmoObject.
Metodo protetto EnumScriptImplWorker Chiama i metodi che enumerano gli script specificati dal parametro so. Ereditato da SqlSmoObject.
Metodo protetto EnumScriptImplWorkerSOChanged Restituisce una stringa IEnumerable che descrive le opzioni di scripting per un oggetto. Ereditato da SqlSmoObject.
Metodo pubblico Equals Ereditato da Object.
Metodo protetto ExecuteNonQuery Ereditato da SqlSmoObject.
Metodo protetto Finalize Ereditato da Object.
Metodo protetto FormatSqlVariant Formatta un oggetto come tipo SqlVariant. Ereditato da SqlSmoObject.
Metodo protetto GenerateDataSpaceFileStreamScript Genera uno script per creare file di dati. Ereditato da SqlSmoObject.
Metodo protetto GenerateDataSpaceScript Genera uno script per allocare spazio nel file di dati. Ereditato da SqlSmoObject.
Metodo protetto GetBindDefaultScript Ottiene lo script che associa le impostazioni predefinite specificate dai parametri defSchema e defName. Ereditato da SqlSmoObject.
Metodo protetto GetBindRuleScript Ottiene lo script che specifica le regole di associazione. Ereditato da SqlSmoObject.
Metodo protetto GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro booleano dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna una proprietà booleana dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetDateTimeParameter Assegna la proprietà datetime dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetDateTimeParameterAsInt Assegna la proprietà datetime dell'oggetto SqlSmoObject come valore intero se la proprietà datetime è diversa da null. Ereditato da SqlSmoObject.
Metodo protetto GetDBName Ottiene il nome del database associato all'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetEnumParameter Assegna una proprietà di enumerazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetFragOptionString Ottiene un oggetto FragmentationOption come valore stringa. Ereditato da SqlSmoObject.
Metodo protetto GetGuidParameter Assegna una proprietà Guid dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico GetHashCode Ereditato da Object.
Metodo protetto GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna un parametro dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValue Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptional Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetPropValueOptionalAllowNull Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetRealValue Ottiene un valore della proprietà dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetScriptingOptionsForCreate Ottiene l'oggetto ScriptingOptions per l'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetServerName Ottiene il nome dell'istanza di SQL Server a cui è associato l'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetServerObject Ottiene il server dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetSqlServerVersionName Ottiene il nome della versione dell'istanza di SQL Server a cui è associato l'oggetto. Ereditato da SqlSmoObject.
Metodo protetto GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) Assegna un parametro stringa dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) Assegna un parametro stringa dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetTimeSpanParameterAsInt Assegna un parametro periodo di tempo dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico GetType Ereditato da Object.
Metodo protetto GetUrnRecursive(StringBuilder) Assegna un oggetto Urn dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto GetUrnRecursive(StringBuilder, UrnIdOption) Assegna un oggetto Urn dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ImplInitialize Inizializza i campi dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico Initialize() () () () Inizializza l'oggetto e forza il caricamento delle proprietà. Ereditato da SqlSmoObject.
Metodo pubblico Initialize(Boolean) Inizializza l'oggetto e forza il caricamento delle proprietà. Ereditato da SqlSmoObject.
Metodo protetto IsObjectDirty Verifica se le proprietà dell'oggetto sono state modificate e se le modifiche non sono già persistenti nell'istanza di SQL Server. Ereditato da SqlSmoObject.
Metodo protetto IsObjectInitialized Verifica se l'oggetto è stato inizializzato. Ereditato da SqlSmoObject.
Metodo protetto IsObjectInSpace Verifica se l'oggetto è isolato o connesso all'istanza di SQL Server. Ereditato da SqlSmoObject.
Metodo protetto IsVersion80SP3 Determina se la versione di SQL Server è SQL Server 2000 con SP3. Ereditato da SqlSmoObject.
Metodo protetto IsVersion90AndAbove Determina se la versione di SQL Server è SQL Server 2005 o successiva. Ereditato da SqlSmoObject.
Metodo protetto MarkDropped Imposta l'oggetto SqlSmoState da eliminare. Ereditato da SqlSmoObject.
Metodo pubblico MarkForDrop Marks the database file to be dropped next time its parent object is altered by the Alter method. Ereditato da DatabaseFile.
Metodo protetto MarkForDropImpl Imposta l'oggetto SqlSmoState da eliminare. Ereditato da SqlSmoObject.
Metodo protetto MemberwiseClone Ereditato da Object.
Metodo protetto PostAlter Metodo attivato dopo che l'oggetto SqlSmoObject viene modificato. Ereditato da SqlSmoObject.
Metodo protetto PostCreate Metodo attivato dopo la creazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto PostDrop Metodo attivato dopo l'eliminazione dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico Refresh Aggiorna l'oggetto e recupera le proprietà al successivo accesso all'oggetto. Ereditato da SqlSmoObject.
Metodo pubblico Rename Renames a database file. Ereditato da DatabaseFile.
Metodo protetto RenameImpl Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future. Ereditato da NamedSmoObject.
Metodo protetto RenameImplWorker Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future. Ereditato da NamedSmoObject.
Metodo protetto ScriptAlter Alters the script that is used to create the file in the database. Ereditato da DatabaseFile.
Metodo protetto ScriptChangeOwner This method supports the SMO infrastructure and is not intended to be used directly from your code. Ereditato da NamedSmoObject.
Metodo protetto ScriptCreate Modifica l'oggetto SqlSmoObject in base ai parametri. Ereditato da SqlSmoObject.
Metodo protetto ScriptDdl Genera un oggetto InvalidSmoOperationException. Ereditato da SqlSmoObject.
Metodo protetto ScriptDrop Drops the script that is used to create the file in the database. Ereditato da DatabaseFile.
Metodo protetto ScriptImpl() () () () Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ScriptImpl(ScriptingOptions) Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ScriptImplWorker Ottiene una raccolta di script dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto ScriptOwner Alters the script owner authorization. Ereditato da NamedSmoObject.
Metodo protetto ScriptRename Renames the script in the database file. Ereditato da DatabaseFile.
Metodo pubblico SetOffline Sets the database file status to offline.
Metodo protetto SetParentImpl Imposta l'elemento padre dell'oggetto SqlSmoObject sul parametro newParent. Ereditato da SqlSmoObject.
Metodo protetto SetSchemaOwned Sets the schema owned value. Ereditato da NamedSmoObject.
Metodo pubblico Shrink Shrinks a database file. Ereditato da DatabaseFile.
Metodo pubblico ToString Restituisce un oggetto String che rappresenta l'oggetto a cui si fa riferimento. Ereditato da SqlSmoObject.
Metodo protetto TouchImpl Non implementato. Ereditato da SqlSmoObject.
Metodo protetto UnbindDefaultImpl Annulla l'associazione delle colonne predefinite dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo protetto UnbindRuleImpl Annulla l'associazione delle regole dell'oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Metodo pubblico Validate Validates the state of an object. Ereditato da SmoObjectBase.

In alto

Eventi

  Nome Descrizione
Evento pubblico PropertyChanged Rappresenta l'evento che si verifica quando viene modificata una proprietà. Ereditato da SqlSmoObject.
Evento pubblico PropertyMetadataChanged Rappresenta l'evento che si verifica quando vengono modificati i metadati di una proprietà. Ereditato da SqlSmoObject.

In alto

Campi

  Nome Descrizione
Campo protetto m_ExtendedProperties Rappresenta una proprietà definita per estendere le proprietà fornite da un oggetto SqlSmoObject. Ereditato da SqlSmoObject.
Campo protetto singletonParent Rappresenta il padre singleton. Ereditato da SqlSmoObject.

In alto

Implementazioni esplicite dell'interfaccia

  Nome Descrizione
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .Discover Individua eventuali dipendenze. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetDomainRoot Restituisce la radice del dominio. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetParent Ottiene l'elemento padre di questo oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetPropertyType Ottiene il tipo della proprietà specificata. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetPropertyValue Ottiene il valore della proprietà specificata. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .GetUrn Ottiene l'URN (Unified Resource Name) dell'oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .Resolve Ottiene l'istanza che contiene le informazioni sull'oggetto dall'URN (Unified Resource Name) dell'oggetto. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .SetObjectState Imposta lo stato dell'oggetto sul valore SfcObjectState specificato. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato IAlienObject. . :: . .SetPropertyValue Imposta il valore della proprietà. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaMetodo privato ISfcPropertyProvider. . :: . .GetPropertySet Ottiene il riferimento di interfaccia al set di proprietà di questo oggetto. Non fare riferimento direttamente a questo membro nel codice. Supporta l'infrastruttura di SQL Server. Ereditato da SqlSmoObject.
Implementazione esplicita dell'interfacciaProprietà privata ISfcSupportsDesignMode. . :: . .IsDesignMode Gets a Boolean value that indicates whether the object supports design mode.

In alto

Osservazioni

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

Tutti i membri statici pubblici (Shared in Microsoft Visual Basic) di questo tipo sono sicuri per le operazioni a thread multipli. Non è invece garantita la sicurezza dei membri dell'istanza.

Protezione dei thread

I membri static (Shared in Visual Basic) pubblici di questo tipo sono affidabili. Non è invece garantita la sicurezza dei membri dell'istanza.