Idioma
Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Os UDTs (tipos definidos pelo usuário) permitem que os desenvolvedores estendam o sistema de tipo escalar do servidor armazenando objetos de CLR (Common Language Runtime) em um banco de dados SQL Server. Os UDTs podem conter vários elementos e ter comportamentos, diferentemente dos tipos de dados de alias tradicionais, que consistem em um único tipo de dados do sistema no SQL Server.
Observação
Para acesso do cliente a UDTs grandes, instale o pacote NuGet Microsoft.Data.SqlClient NuGet package e importe Microsoft.Data.SqlClient. Os tipos SQL CLR que definem o UDT do lado do servidor permanecem em Microsoft.SqlServer.Server; não substitua esses tipos por tipos de cliente-provedor.
Os UDTs eram anteriormente restritas a um tamanho máximo de 8 kilobytes. No SQL Server 2008, essa restrição foi removida para UDTs que têm um formato de UserDefined.
Para obter a documentação completa dos tipos definidos pelo usuário, confira Tipos CLR definidos pelo usuário.
Recuperando esquemas de UDT usando GetSchema
O GetSchema método retorna informações de esquema de banco de dados no DataTable objeto. Para obter mais informações, confira Coleções de esquema do SQL Server.
Valores de coluna de GetSchemaTable para UDTs
O GetSchemaTable método retorna metadados de coluna no DataTable objeto. A tabela a seguir descreve as diferenças nos metadados da coluna para UDTs grandes entre o SQL Server 2005 e o SQL Server 2008.
| Coluna do SqlDataReader | SQL Server 2005 | SQL Server 2008 e posterior |
|---|---|---|
ColumnSize |
Variedade | Variedade |
NumericPrecision |
255 | 255 |
NumericScale |
255 | 255 |
DataType |
Byte[] |
Instância UDT |
ProviderSpecificDataType |
SqlTypes.SqlBinary |
Instância UDT |
ProviderType |
21 (SqlDbType.VarBinary) |
29 (SqlDbType.Udt) |
NonVersionedProviderType |
29 (SqlDbType.Udt) |
29 (SqlDbType.Udt) |
DataTypeName |
SqlDbType.VarBinary |
O nome de três partes especificado como Database.SchemaName.TypeName. |
IsLong |
Variedade | Variedade |
Considerações do SqlDataReader
A SqlDataReader classe dá suporte a valores UDT grandes em SQL Server 2008 e versões posteriores. A forma como o leitor processa esses valores depende da versão do SQL Server e do Type System Version na string de conexão. Para obter mais informações, consulte ConnectionString.
Quando Type System Version for SQL Server 2005, os seguintes SqlDataReader métodos usam a representação binária de UDTs grandes:
- GetProviderSpecificFieldType retorna o Type objeto para SqlBinary.
- GetProviderSpecificValue e GetSqlValue retornam SqlBinary valores.
- GetProviderSpecificValues e GetSqlValues preenchem a matriz fornecida com valores de coluna específicos do provedor e retornam o número de elementos preenchidos. Valores UDT grandes nessa matriz usam SqlBinary.
Para a mesma configuração de sistema de tipo, GetValue retorna o valor grande de UDT como Byte[].
GetValues preenche o array fornecido com valores de coluna e retorna o número de elementos preenchidos. Valores UDT grandes nesse array usam Byte[].
Observe que nenhuma das conversões são feitas para a versão atual do ADO.NET.
Especificar SqlParameters
As propriedades a seguir SqlParameter dão suporte a UDTs grandes.
| Propriedade SqlParameter | Descrição |
|---|---|
| Value | Obtém ou define um objeto que representa o valor do parâmetro. O padrão é nulo. A propriedade pode ser SqlBinary, Byte[] ou um objeto gerenciado. |
| SqlValue | Obtém ou define um objeto que representa o valor do parâmetro. O padrão é nulo. A propriedade pode ser SqlBinary, Byte[] ou um objeto gerenciado. |
| Size | Obtém ou define o tamanho do valor do parâmetro a ser resolvido. O valor padrão é 0. A propriedade pode ser um inteiro que representa o tamanho do valor do parâmetro. Para UDTs grandes, pode ser o tamanho real da UDT ou -1 para desconhecido. |
Recuperando exemplo de dados
O fragmento de código a seguir demonstra como recuperar dados de uma UDT grande. A variável connectionString pressupõe uma conexão válida com um banco de dados SQL Server e a variável commandString assume uma instrução válida SELECT com a coluna de chave primária listada primeiro.
using (SqlConnection connection = new SqlConnection(
connectionString))
{
connection.Open();
SqlCommand command = new SqlCommand(commandString, connection);
SqlDataReader reader = command.ExecuteReader();
while (reader.Read())
{
// Retrieve the value of the Primary Key column.
int id = reader.GetInt32(0);
// Retrieve the value of the UDT.
LargeUDT udt = (LargeUDT)reader[1];
// You can also use GetSqlValue and GetValue.
// LargeUDT udt = (LargeUDT)reader.GetSqlValue(1);
// LargeUDT udt = (LargeUDT)reader.GetValue(1);
Console.WriteLine(
"ID={0} LargeUDT={1}", id, udt);
}
reader.Close();
}
Using connection As New SqlConnection( _
connectionString)
connection.Open()
Dim command As New SqlCommand(commandString, connection)
Dim reader As SqlDataReader
reader = command.ExecuteReader
While reader.Read()
' Retrieve the value of the Primary Key column.
Dim id As Int32 = reader.GetInt32(0)
' Retrieve the value of the UDT.
Dim udt As LargeUDT = CType(reader(1), LargeUDT)
' You can also use GetSqlValue and GetValue.
' Dim udt As LargeUDT = CType(reader.GetSqlValue(1), LargeUDT)
' Dim udt As LargeUDT = CType(reader.GetValue(1), LargeUDT)
' Print values.
Console.WriteLine("ID={0} LargeUDT={1}", id, udt)
End While
reader.Close()
End Using