Compartir a través de


Asignar datos de parámetros CLR

Se aplica a: SQL Server

En la tabla siguiente se enumeran los tipos de datos de Microsoft SQL Server, sus equivalentes en Common Language Runtime (CLR) para SQL Server en el espacio de nombres System.Data.SqlTypes y sus equivalentes CLR nativos en Microsoft .NET Framework.

Tipo de datos de SQL Server Tipo (en System.Data.SqlTypes o Microsoft.SqlServer.Types) Tipo de datos CLR (.NET Framework)
bigint SqlInt64 Int64, Nullable<Int64>
binary SqlBytes, SqlBinary Byte[]
bit SqlBoolean Boolean, booleano que admite<valores NULL>
char None None
cursor None None
date SqlDateTime DateTime, DateTime que acepta<valores NULL>
datetime SqlDateTime DateTime, DateTime que acepta<valores NULL>
datetime2 None DateTime, DateTime que acepta<valores NULL>
DATETIMEOFFSET None DateTimeOffset, DateTimeOffset que acepta valores<NULL>
decimal SqlDecimal Decimal, Decimal que acepta<valores NULL>
float SqlDouble Double, Nullable<Double>
geography SqlGeography

SqlGeography se define en Microsoft.SqlServer.Types.dll, que se instala con SQL Server y se puede descargar desde el paquete de características de SQL Server.
None
geometry SqlGeometry

SqlGeometry se define en Microsoft.SqlServer.Types.dll, que se instala con SQL Server y se puede descargar desde el paquete de características de SQL Server.
None
hierarchyid SqlHierarchyId

SqlHierarchyId se define en Microsoft.SqlServer.Types.dll, que se instala con SQL Server y se puede descargar desde el paquete de características de SQL Server.
None
image None None
int SqlInt32 Int32, Nullable<Int32>
money SqlMoney Decimal, Decimal que acepta<valores NULL>
nchar SqlChars, SqlString String, Char[]
ntext None None
numeric SqlDecimal Decimal, Decimal que acepta<valores NULL>
nvarchar SqlChars, SqlString

SQLChars es una mejor coincidencia para la transferencia y el acceso de datos, y SQLString es una mejor coincidencia para realizar operaciones de cadena.
String, Char[]
nvarchar(1), nchar(1) SqlChars, SqlString Char, String, Char[], Nullable<char>
real SqlSingle (el intervalo de SqlSingle, sin embargo, es mayor que real) Single, NULLable<Single>
rowversion None Byte[]
smallint SqlInt16 Int16, Nullable<Int16>
smallmoney SqlMoney Decimal, Decimal que acepta<valores NULL>
sql_variant None Object
table None None
text None None
time None TimeSpan, TimeSpan que acepta<valores NULL>
timestamp None None
tinyint SqlByte Byte, Byte que acepta<valores NULL>
uniqueidentifier SqlGuid Guid, Guid que acepta<valores NULL>
Tipo definido por el usuario (UDT) None La misma clase que está enlazada al tipo definido por el usuario en el mismo ensamblado o en un ensamblado dependiente.
varbinary SqlBytes, SqlBinary Byte[]
varbinary(1), binary(1) SqlBytes, SqlBinary byte, Byte[], byte que acepta<valores NULL>
varchar None None
xml SqlXml None

Conversión automática de tipos de datos con parámetros OUT

Un método CLR puede devolver información al código o programa de llamada marcando un parámetro de entrada con el modificador out (Microsoft Visual C#) o< Out()> ByRef (Microsoft Visual Basic) Si el parámetro de entrada es un tipo de datos CLR en el espacio de nombres System.Data.SqlTypes y el programa de llamada especifica su tipo de datos equivalente de SQL Server como parámetro de entrada, Una conversión de tipos se produce automáticamente cuando el método CLR devuelve el tipo de datos.

Por ejemplo, el siguiente procedimiento almacenado CLR tiene un parámetro de entrada del tipo de datos CLR SqlInt32 marcado con out (C#) o <Out()> ByRef (Visual Basic):

[Microsoft.SqlServer.Server.SqlProcedure]  
public static void PriceSum(out SqlInt32 value)  
{ ... }  
\<Microsoft.SqlServer.Server.SqlProcedure> _  
Public Shared Sub PriceSum( \<Out()> ByRef value As SqlInt32)  
...  
End Sub  

Una vez compilado y creado el ensamblado en la base de datos, el procedimiento almacenado se crea en SQL Server con el siguiente transact-SQL, que especifica un tipo de datos de SQL Server de int como parámetro OUTPUT:

CREATE PROCEDURE PriceSum (@sum int OUTPUT)  
AS EXTERNAL NAME TestStoredProc.StoredProcedures.PriceSum  

Cuando se llama al procedimiento almacenado CLR, el tipo de datos SqlInt32 se convierte automáticamente en un tipo de datos int y se devuelve al programa de llamada.

Sin embargo, no todos los tipos de datos CLR se pueden convertir automáticamente a sus tipos de datos equivalentes de SQL Server a través de un parámetro out. En la tabla siguiente se enumeran estas excepciones.

Tipo de datos CLR (SQL Server) Tipo de datos de SQL Server
Decimal smallmoney
SqlMoney SMALLMONEY
Decimal money
DateTime smalldatetime
SQLDateTime smalldatetime

Historial de cambios

Contenido actualizado
Se agregaron tipos SqlGeography, SqlGeometry y SqlHierarchyId a la tabla de asignación.

Consulte también

Tipos de datos de SQL Server en .NET Framework