Database.PrefetchObjects Method
Prefetches database objects.
Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)
Syntax
'Declaration
Public Sub PrefetchObjects
'Usage
Dim instance As Database
instance.PrefetchObjects()
public void PrefetchObjects()
public:
void PrefetchObjects()
member PrefetchObjects : unit -> unit
public function PrefetchObjects()
Remarks
This lets collections be fully populated with objects by making one network trip to the instance of SQL Server. Prefetching is an optimization that is used when the whole collection of objects is required.
This method uses the default initialization of fields for prefetching database objects.
Examples
VB
'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks2008R2 database.
Dim db As Database
db = srv.Databases("AdventureWorks2008R2")
'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("AdventureWorks2008R2")
$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()