發行項
09/24/2010

設定屬性

屬性是儲存有關物件之描述性資訊的値。例如，MicrosoftSQL Server 組態選項是由 Configuration 物件的屬性所代表。您可以使用屬性集合來直接或間接地存取屬性。直接存取屬性會使用下列語法：

objInstance.PropertyName

您可以根據屬性是否具有讀/寫存取權或唯讀存取權來修改或擷取屬性値。也必須先設定特定的屬性，才能建立物件。如需詳細資訊，請參閱該特定物件的 SMO 參考。

[!附註]

子物件的集合會顯示為物件的屬性。例如，Tables 集合是 Server 物件的屬性。如需詳細資訊，請參閱＜使用集合＞。

物件的屬性是 Properties 集合的成員。Properties 集合可用來反覆運算物件的每個屬性。

有時屬性會因為下列原因而無法使用：

伺服器版本不支援該屬性，例如您在舊版的 SQL Server 上嘗試存取的屬性代表新增的 SQL Server 功能。
伺服器沒有提供該屬性的資料，例如您嘗試存取的屬性代表未安裝的 SQL Server 元件。

您可以藉由捕捉 UnknownPropertyException 和 PropertyCannotBeRetrievedException SMO 例外狀況來處理這些情況。

設定預設的初始化欄位

SMO 在擷取物件時會執行最佳化。最佳化會藉由在下列狀況之間自動調整，而將載入的屬性數目最小化：

部分載入。初次參考物件時，該物件會擁有最少的可用屬性 (例如「名稱」和「結構描述」)。
完整載入。在參考任何屬性時，系統會初始化可快速載入的剩餘屬性並使這些屬性可供使用。
使用大量記憶體的屬性。不可使用的剩餘屬性會使用許多記憶體，並具有 true 的 Expensive 屬性値 (例如，DataSpaceUsage)。這些屬性只有在特別參考時才會載入。

如果您的應用程式真的會擷取額外的屬性，則除了以部分載入狀態提供的屬性外，該應用程式還會提交查詢以擷取這些額外的屬性，並擴充至完全載入的狀態。這樣可能會造成用戶端和伺服器之間出現不必要的傳輸。呼叫 SetDefaultInitFields 方法可以達到更高的最佳化。SetDefaultInitFields 方法可用來指定在物件初始化時載入的屬性。

SetDefaultInitFields 方法會針對其餘的應用程式設定屬性載入行為，或等到應用程式重設為止。您可以使用 GetDefaultInitFields 方法來儲存原始的行為，並依需求加以還原。

範例

如果要使用所提供的任何程式碼範例，您必須選擇建立應用程式用的程式設計環境、程式設計範本，及程式設計語言。如需詳細資訊，請參閱《SQL Server 線上叢書》中的＜如何：在 Visual Studio .NET 中建立 Visual Basic SMO 專案＞(英文) 或＜如何：在 Visual Studio .NET 中建立 Visual C# SMO 專案＞(英文)。

在 Visual Basic 中取得和設定屬性

此程式碼範例示範如何取得 Information 物件的 Edition 屬性，以及如何將 ConnectionContext 屬性的 SqlExecutionModes 屬性設定為 SqlExecutionModes 列舉型別的 ExecuteSql 成員。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Get a property.
Console.WriteLine(srv.Information.Version)
'Set a property.
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.ExecuteSql

在 Visual C# 中取得和設定屬性

{ 
//Connect to the local, default instance of SQL Server. 
Server srv; 
srv = new Server(); 
//Get a property. 
Console.WriteLine(srv.Information.Version); 
//Set a property. 
srv.ConnectionContext.SqlExecutionModes = SqlExecutionModes.ExecuteSql; 
}

在 Visual Basic 中建立物件之前先設定各種屬性

此程式碼範例示範如何直接設定 Table 物件的 AnsiNullsStatus 屬性，以及如何在建立 Table 物件之前，先建立和加入資料行。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Create a new table in the AdventureWorks database. 
Dim db As Database
db = srv.Databases("AdventureWorks")
Dim tb As Table
'Specify the parent database, table schema and the table name in the constructor.
tb = New Table(db, "Test_Table", "HumanResources")
'Add columns because the table requires columns before it can be created. 
Dim c1 As Column
'Specify the parent table, the column name and data type in the constructor.
c1 = New Column(tb, "ID", DataType.Int)
tb.Columns.Add(c1)
c1.Nullable = False
c1.Identity = True
c1.IdentityIncrement = 1
c1.IdentitySeed = 0
Dim c2 As Column
c2 = New Column(tb, "Name", DataType.NVarChar(100))
c2.Nullable = False
tb.Columns.Add(c2)
tb.AnsiNullsStatus = True
'Create the table on the instance of SQL Server.
tb.Create()

在 Visual C# 中建立物件之前先設定各種屬性

此程式碼範例示範如何直接設定 Table 物件的 AnsiNullsStatus 屬性，以及如何在建立 Table 物件之前，先建立和加入資料行。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Create a new table in the AdventureWorks database. 
Dim db As Database
db = srv.Databases("AdventureWorks")
Dim tb As Table
'Specify the parent database, table schema and the table name in the constructor.
tb = New Table(db, "Test_Table", "HumanResources")
'Add columns because the table requires columns before it can be created. 
Dim c1 As Column
'Specify the parent table, the column name and data type in the constructor.
c1 = New Column(tb, "ID", DataType.Int)
tb.Columns.Add(c1)
c1.Nullable = False
c1.Identity = True
c1.IdentityIncrement = 1
c1.IdentitySeed = 0
Dim c2 As Column
c2 = New Column(tb, "Name", DataType.NVarChar(100))
c2.Nullable = False
tb.Columns.Add(c2)
tb.AnsiNullsStatus = True
'Create the table on the instance of SQL Server.
tb.Create()

{ 
//Connect to the local, default instance of SQL Server. 
Server srv; 
srv = new Server(); 
//Create a new table in the AdventureWorks database. 
Database db; 
db = srv.Databases("AdventureWorks"); 
Table tb; 
//Specify the parent database, table schema, and the table name in the constructor. 
tb = new Table(db, "Test_Table", "HumanResources"); 
//Add columns because the table requires columns before it can be created. 
Column c1; 
//Specify the parent table, the column name, and data type in the constructor. 
c1 = new Column(tb, "ID", DataType.Int); 
tb.Columns.Add(c1); 
c1.Nullable = false; 
c1.Identity = true; 
c1.IdentityIncrement = 1; 
c1.IdentitySeed = 0; 
Column c2; 
c2 = new Column(tb, "Name", DataType.NVarChar(100)); 
c2.Nullable = false; 
tb.Columns.Add(c2); 
tb.AnsiNullsStatus = true; 
//Create the table on the instance of SQL Server. 
tb.Create(); 
}

在 Visual Basic 中反覆運算物件的所有屬性

此程式碼範例會反覆運算 StoredProcedure 物件的 Properties 集合，並在 Visual Studio 輸出畫面上加以顯示。

在此範例中已將 Property 物件放入方括號中，因為它也是 Visual Basic 關鍵字。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Set properties on the uspGetEmployeedManagers stored procedure on the AdventureWorks database.
Dim db As Database
db = srv.Databases("AdventureWorks")
Dim sp As StoredProcedure
sp = db.StoredProcedures("uspGetEmployeeManagers")
sp.AnsiNullsStatus = False
sp.QuotedIdentifierStatus = False
'Iterate through the properties of the stored procedure and display.
'Note the Property object requires [] parentheses to distinguish it from the Visual Basic key word.
Dim p As [Property]
For Each p In sp.Properties
    Console.WriteLine(p.Name & p.Value)
Next

在 Visual C# 中反覆運算物件的所有屬性

此程式碼範例會反覆運算 StoredProcedure 物件的 Properties 集合，並在 Visual Studio 輸出畫面上加以顯示。

{ 
//Connect to the local, default instance of SQL Server. 
Server srv; 
srv = new Server(); 
//Set properties on the uspGetEmployeedManagers stored procedure on the AdventureWorks database. 
Database db; 
db = srv.Databases("AdventureWorks"); 
StoredProcedure sp; 
sp = db.StoredProcedures("uspGetEmployeeManagers"); 
sp.AnsiNullsStatus = false; 
sp.QuotedIdentifierStatus = false; 
//Iterate through the properties of the stored procedure and display. 
  Property p; 
  foreach ( p in sp.Properties) { 
    Console.WriteLine(p.Name + p.Value); 
  } 
}

在 Visual Basic 中設定預設的初始化欄位

此程式碼範例示範如何將在 SMO 程式中初始化的物件屬性數目最小化。您必須包含 using System.Collections.Specialized，即使用 StringCollection 物件的陳述式。

SQL Server Profiler 可用來將此最佳化與傳送至 SQL Server 執行個體的數字陳述式進行比較。

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the AdventureWorks database.
Dim db As Database
db = srv.Databases("AdventureWorks")
'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 AdventureWorks.
'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)

在 Visual C# 中設定預設的初始化欄位