Click here to Skip to main content
11,805,310 members (63,394 online)
Click here to Skip to main content

Tagged as

Using CLR functions with T-SQL

, 25 Nov 2011 CPOL 13.3K
Rate this:
Please Sign up or sign in to vote.
Why use CLR?Before using CLR, you should question ‘Why’. When using CLR functions within T-SQL, you have to maintain two different programming environments, unless what you gain worth more than having it.We need to use the CLR functions when occasions such as:When we have to access system resources

Why use CLR?

Before using CLR, you should question ‘Why’. When using CLR functions within T-SQL, you have to maintain two different programming environments, unless what you gain is worth more than having it. We need to use CLR functions on occasions such as: when we have to access system resources like file system or network. (**Extended Stored Procedures can do the same. But they are deprecated and will be removed from future versions of SQL.) Or when the business logic is too complex to write in T-SQL, which can be easily done using .NET languages (reusing logic already written without duplicating them using T-SQL).

To illustrate this, I will create a CLR function which will create a text file and append the text which is passed from a T-SQL statement. Open Visual Studio and create a new ‘SQL Server Project’.


In the next dialog, you will be prompted to select the database which you plan to deploy for your extension. You can either select from an existing one or connect to a different one.


In the next screen, you will be prompted whether you want to debug your .NET code. Select ‘yes’ or ‘no’ depending on your requirement.


Right click on the newly created project and add a new user-defined function.


I have named it ‘WriteToTextFileSample’.


Use the following code:

using System;
using System.Data;
using System.Data.SqlClient;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;

using System.IO;
using System.Text;

public partial class UserDefinedFunctions {
public static SqlString WriteToTextFileSample(string filename, string data) {
FileStream fs = File.Open(filename, FileMode.Append);
byte[] b = new UTF8Encoding(true).GetBytes(data);

fs.Write(b, 0, data.Length);

return new SqlString("Completed");

**The functions should be 'public static' and all the functions should have the '[Microsoft.SqlServer.Server.SqlFunction]' attribute or you will not be able to call it from SQL.

Go to the project properties and change the ‘Permission Level’ to ‘Unsafe’ in the Database section. (This is only required if you are performing tasks such as writing to files and accessing system related resources. You do not need this if you are performing calculations, etc..)

Save your project. Before deploying this, you have to enable ‘clr enable’ to ‘1’. Use the following T-SQL statement to do so.

sp_configure 'show advanced options', 1;
sp_configure 'clr enabled', 1;

Once executed, deploy the project (Build—> Deploy Solution). You will be prompted with the SQL credentials.


Once it’s deployed successfully, use the following sample statement to use the function which we have created.

select dbo.WriteToTextFileSample(
N'Hello from SQL !!!'



This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Manjuke Fernando
Technical Lead Air Liquide Industrial Services (Singapore)
Singapore Singapore
I have been in software industry for more than 8 years. I have developed different type of software using different languages. Many of them are database related (both web & window based), SQL being as the back end most of the time. Up-to-date I have knowledge in languages such as C#, VB.Net, T-SQL, JAVA, VB6 & C++, making C# the most proficient of all. Also I have worked using different technologies like ASP.Net, SharePoint, Crystal Reports (But I really hate designing reports) & MS SQL Server and have involved in designing & developing software for major companies like FedEx, Softlogic Holdings, IronOne Technologies & Brandix. Currently I am working as a Tech Lead in Singapore.

You may also be interested in...

Comments and Discussions

-- There are no messages in this forum --
| Advertise | Privacy | Terms of Use | Mobile
Web02 | 2.8.151002.1 | Last Updated 26 Nov 2011
Article Copyright 2011 by Manjuke Fernando
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid