Database.PrefetchObjects 方法 (Type, ScriptingOptions)

發行項
04/26/2013

Prefetches database objects of a specified type with scripting options.

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

語法

'宣告
Public Sub PrefetchObjects ( _
    objectType As Type, _
    scriptingOptions As ScriptingOptions _
)
'用途
Dim instance As Database 
Dim objectType As Type 
Dim scriptingOptions As ScriptingOptions

instance.PrefetchObjects(objectType, _
    scriptingOptions)

public void PrefetchObjects(
    Type objectType,
    ScriptingOptions scriptingOptions
)

public:
void PrefetchObjects(
    Type^ objectType, 
    ScriptingOptions^ scriptingOptions
)

member PrefetchObjects : 
        objectType:Type * 
        scriptingOptions:ScriptingOptions -> unit

public function PrefetchObjects(
    objectType : Type, 
    scriptingOptions : ScriptingOptions
)

參數

objectType
型別：System.Type
A Type object that limits the type of object that is prefetched.

scriptingOptions
型別：Microsoft.SqlServer.Management.Smo.ScriptingOptions
A ScriptingOptions object value that specifies the scripting options for the prefetched database object.

備註

This lets collections be fully populated with objects by making one network trip to the instance of SQL Server. Prefetching is an optimization used when the whole collection of objects is required.

This method uses the scripting initialization of fields for prefetching database objects.

範例

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server

'Reference the AdventureWorks2012 database.
Dim db As Database
db = srv.Databases("AdventureWorks2012")

'Assign the Table object type to a System.Type object variable.
Dim tb As Table
Dim typ As Type
tb = New Table
typ = tb.GetType

'Set scripting options.
Dim so As ScriptingOptions
so = New ScriptingOptions
so.AllowSystemObjects = True

'Prefetch all Table type objects, including system objects.
db.PrefetchObjects(typ, so)

PowerShell

$srv = new-Object Microsoft.SqlServer.Management.Smo.Server("(local)")
$db = New-Object Microsoft.SqlServer.Management.Smo.Database
$db = $srv.Databases.Item("AdventureWorks2012")

$tb = New-Object Microsoft.SqlServer.Management.Smo.Table
$typ = $tb.GetType()

$so = New-Object Microsoft.SqlServer.Management.Smo.ScriptingOptions
$so.AllowSystemObjects = $TRUE

$db.PrefetchObjects($typ, $so)

Write-Host $db.GetTransactionCount()