Restore.ReadBackupHeader メソッド

バックアップ ヘッダーを読み取り、メディアの内容に関する情報を返します。

名前空間:  Microsoft.SqlServer.Management.Smo
アセンブリ:  Microsoft.SqlServer.SmoExtended (Microsoft.SqlServer.SmoExtended.dll)

構文

'宣言
Public Function ReadBackupHeader ( _
    srv As Server _
) As DataTable
'使用
Dim instance As Restore 
Dim srv As Server 
Dim returnValue As DataTable 

returnValue = instance.ReadBackupHeader(srv)

public DataTable ReadBackupHeader(
    Server srv
)

public:
DataTable^ ReadBackupHeader(
    Server^ srv
)

member ReadBackupHeader : 
        srv:Server -> DataTable

public function ReadBackupHeader(
    srv : Server
) : DataTable

パラメーター

• srv
  型: Microsoft.SqlServer.Management.Smo.Server
  対象メディアへのアクセスを提供する SQL Server のインスタンスを表す Server オブジェクトです。

戻り値

型: System.Data.DataTable
メディアの内容に関する情報を示す DataTable オブジェクトです。

説明

メディアの内容の詳細については、「RESTORE HEADERONLY (Transact-SQL)」を参照してください。

使用例

次のコード例では、バックアップを作成して、復元クラスのインスタンスに関連付け、ReadBackupHeader メソッドを使用して復元のメディアの内容に関する情報を表示する方法を示します。

VB

Dim srv As Server = New Server()
Dim res As Restore = New Restore()
Dim backup As Backup = New Backup()
Dim dt As DataTable

backup.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", DeviceType.File)
backup.Database = "AdventureWorks2012"
backup.Action = BackupActionType.Database
backup.Initialize = True
backup.SqlBackup(srv)

res.Devices.AddDevice("C:\AdventureWorks2012Backup.BAK", DeviceType.File)
dt = res.ReadBackupHeader(srv)

For Each r As DataRow In dt.Rows
   For Each c As DataColumn In dt.Columns
      Console.WriteLine(c.ToString + " = " + r(c).ToString())
   Next
Next

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$res = new-object Microsoft.SqlServer.Management.Smo.Restore
$backup = new-object Microsoft.SqlServer.Management.Smo.Backup

$backup.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$backup.Database = "AdventureWorks2012"
$backup.Action = [Microsoft.SqlServer.Management.Smo.BackupActionType]::Database
$backup.Initialize = $TRUE
$backup.SqlBackup($srv)

$res.Devices.AddDevice("C:\AdventureWorks2012Backup.bak", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$dt = $res.ReadBackupHeader($srv)

foreach($r in $dt.Rows)
{
   foreach ($c in $dt.Columns)
   {
      Write-Host $c "=" $r[$c]
   }
}

関連項目

参照

Restore クラス

Microsoft.SqlServer.Management.Smo 名前空間

その他の技術情報

RESTORE (Transact-SQL)

SQL Server データベースのバックアップと復元