Share via

  • Статья

Общие сведения о пользовательских атрибутах интеграции со средой CLR

В среде CLR .NET Framework допускается использование описательных ключевых слов, именуемых атрибутами. Эти атрибуты содержат дополнительную информацию по многим элементам, таким, как методы и классы. Эти атрибуты сохраняются в сборке с метаданными объекта и могут быть использованы для описания кода другим инструментальным средствам разработки или для изменения поведения на этапе выполнения внутри SQL Server.

При регистрации подпрограммы в SQL Server SQL Server получает набор свойств этой подпрограммы. Эти свойства подпрограммы определяют возможности подпрограммы и в частности указывают на то, может ли она быть индексирована. Так, если свойству DataAccess задается значение DataAccessKind.Read, тем самым открывается возможность обращения к данным из пользовательских таблиц SQL Server внутри функции CLR. Следующий пример демонстрирует простую ситуацию, в которой задается значение свойства 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 SystemImports System.DataImports System.Data.SqlImports System.Data.SqlTypesImports Microsoft.SqlServer.ServerImports 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 FunctionEnd Class

Что же касается подпрограмм Transact-SQL, SQL Server получает свойства подпрограмм непосредственно из их определений. Сервер не анализирует тексты подпрограмм CLR для получения этих свойств. Вместо этого можно использовать пользовательские атрибуты для классов и членов классов, реализованных в языке .NET Framework.

Пользовательские атрибуты, необходимые для подпрограмм CLR, пользовательских типов и агрегатов, определяются в пространстве имен Microsoft.SqlServer.Server.