CLR 整合自訂屬性的概觀
.NET Framework 的 Common Language Runtime (CLR) 允許使用描述性的關鍵字 (稱為屬性)。 這些屬性會針對許多元素 (如方法和類別) 提供其他資訊。 屬性會隨著物件的中繼資料儲存在組件中，而且可用來將程式碼描述給其他開發工具知道，或是影響 SQL Server 內的執行階段行為。
當您向 SQL Server 註冊 CLR 常式時，SQL Server 會衍生一組有關此常式的屬性。 這些常式屬性會決定該常式的功能，包括是否可以為此常式建立索引。 例如，將 DataAccess 屬性設定為 DataAccessKind.Read 可讓您從 CLR 函數內的 SQL Server 使用者資料表存取資料。 下列範例示範一個簡單案例，其中會設定 DataAccess 屬性，讓您從使用者資料表 table1 方便地存取資料。
using System;
using System.Data;
using System.Data.Sql;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
using System.Data.SqlClient;
public partial class UserDefinedFunctions
{
[SqlFunction(DataAccess = DataAccessKind.Read)]
public static string func1()
{
// Open a connection and create a command
SqlConnection conn = new SqlConnection("context connection = true");
conn.Open();
SqlCommand cmd = conn.CreateCommand();
cmd.CommandText = "SELECT str_val FROM table1 WHERE int_val = 10";
// where table1 is a user table
// Execute this command
SqlDataReader rd = cmd.ExecuteReader();
// Set string ret_val to str_val returned from the query
string ret_val = rd.GetValue(0).ToString();
rd.Close();
return ret_val;
}
}
Imports System
Imports System.Data
Imports System.Data.Sql
Imports System.Data.SqlTypes
Imports Microsoft.SqlServer.Server
Imports System.Data.SqlClient
Public partial Class UserDefinedFunctions
<SqlFunction(DataAccess = DataAccessKind.Read)> _
Public Shared Function func1() As String
' Open a connection and create a command
Dim conn As SqlConnection = New SqlConnection("context connection = true")
conn.Open()
Dim cmd As SqlCommand = conn.CreateCommand()
cmd.CommandText = "SELECT str_val FROM table1 WHERE int_val = 10"
' where table1 is a user table
' Execute this command
Dim rd As SqlDataReader = cmd.ExecuteReader()
' Set string ret_val to str_val returned from the query
Dim ret_val As String = rd.GetValue(0).ToString()
rd.Close()
Return ret_val
End Function
End Class
如果是 Transact-SQL 常式，SQL Server 會直接從常式定義衍生常式屬性。 如果是 CLR 常式，伺服器不會分析常式的主體來衍生這些屬性。 您可以改為將自訂屬性用於使用 .NET Framework 語言實作的類別和類別成員。
CLR 常式、使用者定義型別和彙總所需的自訂屬性會定義在 Microsoft.SqlServer.Server 命名空間內。