Article
03/31/2012

Méthode SetDefaultInitFields (Type, StringCollection)

Spécifie les propriétés qui sont extraites lorsque les objets du type spécifié sont instanciés.

Espace de noms : Microsoft.SqlServer.Management.Smo
Assembly : Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)

Syntaxe

'Déclaration
Public Sub SetDefaultInitFields ( _
    typeObject As Type, _
    fields As StringCollection _
)
'Utilisation
Dim instance As Server
Dim typeObject As Type
Dim fields As StringCollection

instance.SetDefaultInitFields(typeObject, _
    fields)

public void SetDefaultInitFields(
    Type typeObject,
    StringCollection fields
)

public:
void SetDefaultInitFields(
    Type^ typeObject, 
    StringCollection^ fields
)

member SetDefaultInitFields : 
        typeObject:Type * 
        fields:StringCollection -> unit

public function SetDefaultInitFields(
    typeObject : Type, 
    fields : StringCollection
)

Paramètres

typeObject
Type : System. . :: . .Type
Valeur de l'objet système Type qui spécifie le type d'objet.

fields
Type : System.Collections.Specialized. . :: . .StringCollection
Valeur de l'objet système StringCollection qui spécifie les champs de propriété à extraire lorsque l'objet est initialisé.

Notes

SMO optimization allows only the minimum properties to be loaded when an object is created. When uninitialized properties are accessed, SMO makes individual requests to load the information from the instance of SQL Server. You can use this method to adjust which properties are initialized for an object when it is first created to further optimize performance.

Exemples

Visual Basic

'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
'Assign the current default initialization fields for the Table object type to a 
'StringCollection object variable.
Dim sc As StringCollection
sc = srv.GetDefaultInitFields(typ)
'Set the default initialization fields for the Table object type to the CreateDate property.
srv.SetDefaultInitFields(typ, "CreateDate")
'Retrieve the Schema, Name, and CreateDate properties for every table in AdventureWorks2008R2.
'Note that the improvement in performance can be viewed in SQL Profiler.
For Each tb In db.Tables
    Console.WriteLine(tb.Schema + "." + tb.Name + " " + tb.CreateDate)
Next
'Set the default initialization fields for the Table object type back to the original settings.
srv.SetDefaultInitFields(typ, sc)

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()
$sc = $srv.GetDefaultInitFields($typ)
$srv.SetDefaultInitFields($typ, "CreateDate")
foreach ($tb in $db.Tables)
{
   Write-Host $tb.Schema,".",$tb.Name,".",$tb.CreateDate
}
$srv.SetDefaultInitFields($typ, $sc)