Partilhar via

Mapear dados de parâmetros CLR

Aplica-se a:SQL Server

A tabela a seguir lista os tipos de dados do SQL Server, seus equivalentes no Common Language Runtime (CLR) para SQL Server no namespace System.Data.SqlTypes e seus equivalentes CLR nativos no .NET Framework.

Tipo de dados do SQL Server Tipo (em System.Data.SqlTypes ou Microsoft.SqlServer.Types) Tipo de dados CLR (.NET Framework)
bigint SqlInt64 Int64, Nullable<Int64>
binário SqlBytes, SqlBinary Byte[]
pouco SqlBoolean Boolean, Nullable<Boolean>
char Nenhum Nenhum
cursor Nenhum Nenhum
data SqlDateTime DateTime, Nullable<DateTime>
datetime SqlDateTime DateTime, Nullable<DateTime>
datetime2 Nenhum DateTime, Nullable<DateTime>
datetimeoffset None DateTimeOffset, Nullable<DateTimeOffset>
decimal SqlDecimal Decimal, Nullable<Decimal>
flutuar SqlDouble Double, Nullable<Double>
geografia SqlGeography 1 Nenhum
geometria SqlGeometry 1 Nenhum
hierarchyid SqlHierarchyId 1 Nenhum
imagem Nenhum Nenhum
int SqlInt32 Int32, Nullable<Int32>
dinheiro SqlMoney Decimal, Nullable<Decimal>
nchar SqlChars, SqlString String, Char[]
ntext Nenhum Nenhum
numérico SqlDecimal Decimal, Nullable<Decimal>
nvarchar SqlChars, SqlString

SQLChars é uma melhor correspondência para transferência e acesso de dados, e SQLString é uma melhor combinação para executar operações String.		 String, Char[]
nvarchar(1), nchar(1) SqlChars, SqlString Char, String, Char[], Nullable<char>
real SqlSingle (no entanto, o intervalo de SqlSingle é maior do que real) Single, Nullable<Single>
versão de linha Nenhum Byte[]
pequeno SqlInt16 Int16, Nullable<Int16>
dinheiro pequeno SqlMoney Decimal, Nullable<Decimal>
sql_variant Nenhum Object
tabela Nenhum Nenhum
texto Nenhum Nenhum
tempo Nenhum TimeSpan, Nullable<TimeSpan>
de carimbo de data/hora Nenhum Nenhum
minúsculo SqlByte Byte, Nullable<Byte>
identificador único SqlGuid Guid, Nullable<Guid>
Tipo definido pelo usuário (UDT) Nenhum A mesma classe que está vinculada ao tipo definido pelo usuário no mesmo assembly ou em um assembly dependente.
varbinary SqlBytes, SqlBinary Byte[]
varbinary(1), binary(1) SqlBytes, SqlBinary byte, Byte[], Nullable<byte>
varchar Nenhum Nenhum
xml SqlXml Nenhum

1 definido no Microsoft.SqlServer.Types.dll, que é instalado com o SQL Server e pode ser baixado do SQL Server feature pack.

Conversão automática de tipo de dados com parâmetros de saída

Um método CLR pode retornar informações para o código de chamada ou programa marcando um parâmetro de entrada com o modificador out (C#) ou <Out()> ByRef (Visual Basic .NET). Se o parâmetro de entrada for um tipo de dados CLR no namespace System.Data.SqlTypes e o programa de chamada especificar seu tipo de dados equivalente do SQL Server como o parâmetro de entrada, uma conversão de tipo ocorrerá automaticamente quando o método CLR retornar o tipo de dados.

Por exemplo, o seguinte procedimento armazenado CLR tem um parâmetro de entrada de SqlInt32 tipo de dados CLR marcado com out (C#) ou <Out()> ByRef (Visual Basic):

[Microsoft.SqlServer.Server.SqlProcedure]
public static void PriceSum(out SqlInt32 value)
{ ... }

Depois que o assembly é criado e criado no banco de dados, o procedimento armazenado é criado no SQL Server com o seguinte Transact-SQL, que especifica um tipo de dados do SQL Server de int como um parâmetro OUTPUT:

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

Quando o procedimento armazenado CLR é chamado, o tipo de dados SqlInt32 é convertido automaticamente em um tipo de dados int e retornado ao programa de chamada.

No entanto, nem todos os tipos de dados CLR podem ser convertidos automaticamente em seus tipos de dados equivalentes do SQL Server por meio de um parâmetro out. A tabela a seguir lista essas exceções.

Tipo de dados CLR (SQL Server) Tipo de dados do SQL Server
Decimal dinheiro pequeno
SqlMoney dinheiro pequeno
Decimal dinheiro
DateTime smalldatetime
SQLDateTime smalldatetime

Conteúdo relacionado

  • Last updated on