项目
12/14/2010

设置属性

属性是存储有关对象的说明性信息的值。例如，MicrosoftSQL Server 配置选项由 Configuration 对象的属性表示。使用属性集合可以直接或间接访问属性。直接访问属性使用以下语法：

objInstance.PropertyName

可以修改或检索属性值，具体取决于该属性是拥有读/写访问权限还是只读访问权限。此外，还必须在创建对象之前设置某些特定属性。有关详细信息，请参阅特定对象的 SMO 参考资料。

注意
某一对象的子对象集合显示为该对象的属性。例如，Tables 集合是 Server 对象的属性。有关详细信息，请参阅使用集合。

对象的属性是属性集合的成员。属性集合可用于遍历对象的每个属性。

有时某一属性不可用，其原因如下：

服务器版本不支持该属性，例如当尝试在旧版本的 SQL Server 上访问表示 SQL Server 新功能的属性时。
服务器未提供该属性的相应数据，例如当尝试访问表示尚未安装的 SQL Server 组件的属性时。

通过捕获 UnknownPropertyException 和 PropertyCannotBeRetrievedException SMO 异常，可以处理上述情况。

设置默认的初始化字段

SMO 检索对象时将执行优化功能。通过在以下状态之间进行缩放，此优化功能最大程度地减少了加载的属性数目：

部分加载。首次引用某一对象时，该对象具有最少的可用属性（例如 Name 和 Schema）。
完全加载。当引用任一属性时，将初始化剩余属性中可快速加载的属性并使其可用。
占用大量内存的属性。剩余的不可用属性占用大量内存，并将 Expensive 属性值设置为 True（例如 DataSpaceUsage）。只有专门引用这些属性时才会进行加载。

除在部分加载状态中提供的属性之外，如果应用程序的确还需要提取额外属性，则会提交检索这些额外属性的查询，并向上扩展到完全加载状态。这可能会在客户端和服务器之间造成不必要的通信流量。调用 SetDefaultInitFields 方法可以实现更多优化。使用 SetDefaultInitFields 方法可以指定在初始化对象时加载的属性。

SetDefaultInitFields 方法设置其余应用程序或重置应用程序后的属性加载行为。您可以使用 GetDefaultInitFields 方法保存原始行为，并根据需要还原。

示例

若要使用所提供的任何代码示例，您必须选择创建应用程序所需的编程环境、编程模板和编程语言。有关详细信息，请参阅 SQL Server 联机丛书中的“How to: Create a Visual Basic SMO Project in Visual Studio .NET”或“How to: Create a Visual C# SMO Project in Visual Studio .NET”。

在 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# 中遍历对象的所有属性