Skip to content

Latest commit

 

History

History
49 lines (40 loc) · 3.92 KB

data-access-from-clr-database-objects.md

File metadata and controls

49 lines (40 loc) · 3.92 KB
title description author ms.author ms.date ms.service ms.subservice ms.topic helpviewer_keywords
Data Access from CLR Database Objects
CLR routines can access data from within a CLR database object by using the .NET Framework Data Provider for SQL Server, also referred to as SqlClient.
rwestMSFT
randolphwest
03/14/2017
sql
clr
reference
common language runtime [SQL Server], data access
routines [CLR integration]
data access [CLR integration]
ADO.NET [CLR integration]
internal data access [CLR integration]
common language runtime [SQL Server], ADO.NET
database objects [CLR integration], data access
managed code [SQL Server], database objects
.NET Data Access Provider for SQL Server [CLR integration]
managed code [SQL Server], data access
SqlClient provider
in-process data access providers [CLR integration]

Data Access from CLR Database Objects

[!INCLUDE SQL Server] A common language runtime (CLR) routine may easily access data stored in the instance of [!INCLUDEmsCoName] [!INCLUDEssNoVersion] in which it runs, as well as data stored in remote instances. Which particular data the routine can access is determined by the user context in which the code is running. Access data from within a CLR database object by using the .NET Framework Data Provider for [!INCLUDEssNoVersion], also referred to as SqlClient. This is the same provider used by developers accessing [!INCLUDEssNoVersion] data from managed client and middle-tier applications. Because of this, you can leverage your knowledge of ADO.NET and SqlClient in client and middle-tier applications.

Note

User-defined type methods and user-defined functions are not allowed to perform data access by default. You must set the DataAccess property of SqlMethodAttribute or SqlFunctionAttribute to DataAccessKind.Read to enable read-only data access from user-defined type (UDT) methods or user-defined functions. Data modification operations are not allowed from UDTs or user-defined functions, and throws exceptions at execution time if attempted.

This section discusses only the specific functional and behavioral differences when accessing data from within a CLR database object. For more information about the features and functionality of ADO.NET, see the ADO.NET documentation included in the .NET Framework SDK.

The following table lists the topics in this section.

Context Connection
Describes the context connection to SQL Server.

Impersonation and Credentials for Connections
Describes impersonating connections and connection credentials.

SQL Server In-Process Specific Extensions to ADO.NET
Discusses the in-process specific SqlPipe, SqlContext, SqlTriggerContext, and SqlDataRecord objects.

CLR Integration and Transactions
Describes how the new transaction framework provided in the System.Transactions namespace integrates with ADO.NET and [!INCLUDEssNoVersion] CLR integration.

XML Serialization from CLR Database Objects
Explains how to enable XML serialization scenarios of CLR database objects inside [!INCLUDEssNoVersion].