發行項
04/02/2012

ReadMediaHeader 方法

Reads the media header and returns the media header values.

命名空間： Microsoft.SqlServer.Management.Smo
組件： Microsoft.SqlServer.SmoExtended (在 Microsoft.SqlServer.SmoExtended.dll 中)

語法

'宣告
Public Function ReadMediaHeader ( _
    srv As Server _
) As DataTable
'用途
Dim instance As Restore
Dim srv As Server
Dim returnValue As DataTable

returnValue = instance.ReadMediaHeader(srv)

public DataTable ReadMediaHeader(
    Server srv
)

public:
DataTable^ ReadMediaHeader(
    Server^ srv
)

member ReadMediaHeader : 
        srv:Server -> DataTable

public function ReadMediaHeader(
    srv : Server
) : DataTable

參數

srv
型別：Microsoft.SqlServer.Management.Smo. . :: . .Server
A Server object that represents the instance of SQL Server that provides access to the targeted media.

傳回值

型別：System.Data. . :: . .DataTable
A DataTable object that specifies the media header data.

備註

For information about the media contents, see, see RESTORE HEADERONLY (Transact-SQL).

範例

The following code example demonstrates how to back up file for the AdventureWorks2008R22008R2 database and read the header values of the backup media.

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:\AdventureWorks2008R22008R2Backup.bak", DeviceType.File)
backup.Database = "AdventureWorks2008R22008R2"
backup.Action = BackupActionType.Database
backup.Initialize = True
backup.SqlBackup(srv)

res.Devices.AddDevice("C:\AdventureWorks2008R22008R2Backup.BAK", DeviceType.File)
dt = res.ReadMediaHeader(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:\AdventureWorks2008R2Backup.bak", [Microsoft.SqlServer.Management.Smo.DeviceType]::File)
$backup.Database = "AdventureWorks2008R2"
$backup.Action = [Microsoft.SqlServer.Management.Smo.BackupActionType]::Database
$backup.Initialize = $TRUE
$backup.SqlBackup($srv)

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

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