DataFile クラス
DataFile オブジェクトは、SQL Server データ ファイルを表します。
継承階層
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
名前空間: Microsoft.SqlServer.Management.Smo
アセンブリ: Microsoft.SqlServer.Smo (Microsoft.SqlServer.Smo.dll)
構文
'宣言
<PhysicalFacetAttribute> _
<SfcElementTypeAttribute("File")> _
<EvaluationModeAttribute(AutomatedPolicyEvaluationMode.CheckOnSchedule)> _
Public NotInheritable Class DataFile _
Inherits DatabaseFile _
Implements ICreatable, ISfcSupportsDesignMode
'使用
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
DataFile 型は、以下のメンバーを公開しています。
コンストラクター
名前 | 説明 | |
---|---|---|
DataFile() | DataFile クラスの新しいインスタンスを初期化します。 | |
DataFile(FileGroup, String) | 指定したファイル グループで、指定した名前を使用して DataFile クラスの新しいインスタンスを初期化します。 | |
DataFile(FileGroup, String, String) | 指定したファイル グループで、指定した名前およびファイル名を使用して DataFile クラスの新しいインスタンスを初期化します。 |
先頭に戻る
プロパティ
名前 | 説明 | |
---|---|---|
AvailableSpace | データ ファイルの使用可能な領域のサイズを KB 単位で取得します。 | |
BytesReadFromDisk | ディスクから読み取るバイト数を取得します。 | |
BytesWrittenToDisk | ディスクに書き込むバイト数を取得します。 | |
FileName | データ ファイル名を取得または設定します。 | |
Growth | データ ファイルのサイズ増分値を KB または % 単位で取得または設定します。 | |
GrowthType | データ ファイルのサイズ増分値の指定方法 (KB または % 単位) を取得または設定します。 | |
ID | データ ファイルを一意に識別する ID 値を取得します。 | |
IsOffline | データ ファイルがオフラインかどうかを示す Boolean プロパティ値を取得します。 | |
IsPrimaryFile | データ ファイルがデータベースのプライマリ ファイルかどうかを示す Boolean プロパティ値を取得します。 | |
IsReadOnly | データ ファイルが読み取り専用であるか更新可能であるかを示す Boolean プロパティ値を取得します。 | |
IsReadOnlyMedia | データ ファイルが読み取り専用メディアに格納されているかどうかを示す Boolean プロパティ値を取得します。 | |
IsSparse | ファイルがスパース ファイルであるかどうかを示す Boolean 値を取得します。スパース ファイルはデータベース スナップショットで使用されます。 | |
MaxSize | データ ファイルの拡張可能な最大サイズを KB 単位で取得または設定します。 | |
Name | オブジェクトの名前を取得または設定します。 (NamedSmoObject から継承されています。) | |
NumberOfDiskReads | ディスクの読み取り回数を取得します。 | |
NumberOfDiskWrites | ディスクの書き込み回数を取得します。 | |
Parent | DataFile オブジェクトの親である FileGroup オブジェクトを取得または設定します。 | |
Properties | オブジェクトのプロパティを表す Property オブジェクトのコレクションを取得します。 (SqlSmoObject から継承されています。) | |
Size | データ ファイルの現在のサイズを KB 単位で取得または設定します。 | |
State | 参照先のオブジェクトの状態を取得します。 (SmoObjectBase から継承されています。) | |
Urn | オブジェクトを一意に識別する URN (Uniform Resource Name) アドレスの値を取得します。 (SqlSmoObject から継承されています。) | |
UsedSpace | データ ファイルの使用済み領域のサイズを KB 単位で取得します。 | |
UserData | 参照先のオブジェクトに関連付けられたユーザー定義データを取得します。値の設定も可能です。 (SmoObjectBase から継承されています。) | |
VolumeFreeSpace | ボリュームの空き領域をバイト単位で取得します。 |
先頭に戻る
メソッド
名前 | 説明 | |
---|---|---|
Alter | Microsoft SQL Server のインスタンスのオブジェクトのプロパティに対する変更をすべて更新します。 (DatabaseFile から継承されています。) | |
Create | SQL Server のインスタンスで、DataFile オブジェクトによる定義に基づいてデータ ファイルを作成します。 | |
Discover | Object 型の一覧を検出します。 (SqlSmoObject から継承されています。) | |
Drop | データベース ファイルを削除します。 (DatabaseFile から継承されています。) | |
Equals | (Object から継承されています。) | |
FormatSqlVariant | SqlVariant 型としてオブジェクトの書式を設定します。 (SqlSmoObject から継承されています。) | |
GetContextDB | このオブジェクトに関連付けられているコンテキスト データベースを取得します。 (SqlSmoObject から継承されています。) | |
GetDBName | オブジェクトに関連付けられたデータベース名を取得します。 (SqlSmoObject から継承されています。) | |
GetHashCode | (Object から継承されています。) | |
GetPropValue | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) | |
GetPropValueOptional | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) | |
GetPropValueOptionalAllowNull | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) | |
GetServerObject | SqlSmoObject オブジェクトのサーバーを取得します。 (SqlSmoObject から継承されています。) | |
GetType | (Object から継承されています。) | |
Initialize() | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) | |
Initialize(Boolean) | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) | |
IsObjectInitialized | オブジェクトが初期化されたかどうかを確認します。 (SqlSmoObject から継承されています。) | |
IsObjectInSpace | オブジェクトが孤立しているか、または SQL Server のインスタンスに接続されているかを確認します。 (SqlSmoObject から継承されています。) | |
MarkForDrop | データベース ファイルの親オブジェクトが Alter メソッドによって次回変更されるときに、削除されるデータベース ファイルをマークします。 (DatabaseFile から継承されています。) | |
Refresh | オブジェクトが次回アクセスされるときに、オブジェクトを更新し、プロパティを取得します。 (SqlSmoObject から継承されています。) | |
Rename | データベース ファイルの名前を変更します。 (DatabaseFile から継承されています。) | |
SetOffline | データベース ファイルの状態をオフラインに設定します。 | |
SetParentImpl | SqlSmoObject の親を newParent パラメーターに設定します。 (SqlSmoObject から継承されています。) | |
Shrink | データベース ファイルを圧縮します。 (DatabaseFile から継承されています。) | |
ToString | 参照するオブジェクトを表す String を返します。 (SqlSmoObject から継承されています。) | |
Validate | オブジェクトの状態を検証します。 (SmoObjectBase から継承されています。) |
先頭に戻る
イベント
名前 | 説明 | |
---|---|---|
PropertyChanged | プロパティが変更されるときに発生するイベントを表します。 (SqlSmoObject から継承されています。) | |
PropertyMetadataChanged | プロパティ メタデータが変更されたときに発生するイベントを表します。 (SqlSmoObject から継承されています。) |
先頭に戻る
明示的なインターフェイスの実装
名前 | 説明 | |
---|---|---|
IAlienObject.Discover | 依存関係を検出します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) | |
IAlienObject.GetDomainRoot | ドメインのルートを返します。 (SqlSmoObject から継承されています。) | |
IAlienObject.GetParent | このオブジェクトの親を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) | |
IAlienObject.GetPropertyType | 指定したプロパティの種類を取得します。 (SqlSmoObject から継承されています。) | |
IAlienObject.GetPropertyValue | 指定されたプロパティの値を取得します。 (SqlSmoObject から継承されています。) | |
IAlienObject.GetUrn | オブジェクトの Unified Resource Name (URN) を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) | |
IAlienObject.Resolve | オブジェクトに関する情報を含むインスタンスを、オブジェクトの Unified Resource Name (URN) から取得します。 (SqlSmoObject から継承されています。) | |
IAlienObject.SetObjectState | オブジェクトの状態を、指定した SfcObjectState 値に設定します。 (SqlSmoObject から継承されています。) | |
IAlienObject.SetPropertyValue | プロパティの値を設定します。 (SqlSmoObject から継承されています。) | |
ISfcPropertyProvider.GetPropertySet | このオブジェクトのプロパティ セットへのインターフェイス リファレンスを取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) | |
ISfcSupportsDesignMode.IsDesignMode | オブジェクトがデザイン モードをサポートしているかどうかを示すブール値を取得します。 |
先頭に戻る
説明
DataFile オブジェクトのプロパティを取得するには、固定サーバー ロール public のメンバーでもかまいません。
DataFile オブジェクトのプロパティを設定するには、データベースの ALTER 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
データ ファイルを作成するには、データベースの ALTER 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
データ ファイルを削除するには、データベースの ALTER 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
スレッド セーフ
この型の public static (Microsoft Visual Basic では Shared) のすべてのメンバーは、マルチスレッド操作で安全に使用できます。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
使用例
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
関連項目
参照
Microsoft.SqlServer.Management.Smo 名前空間