UDTs grandes

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.

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 método GetSchema de SqlConnection retorna informações de esquema de banco de dados em um DataTable. Para obter mais informações, confira Coleções de esquema do SQL Server.

Valores de coluna de GetSchemaTable para UDTs

O método GetSchemaTable de um SqlDataReader retorna um DataTable que descreve os metadados da coluna. 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.

Considerações do SqlDataReader

O SqlDataReader foi estendido a partir do SQL Server 2008 para dar suporte à recuperação de UDTs de valores grandes. A forma como as UDT de valores grandes são processadas por um SqlDataReader dependem da versão do SQL Server que você está usando, bem como do Type System Version especificado na cadeia de conexão. Para obter mais informações, consulte ConnectionString.

Os seguintes métodos de SqlDataReader retornarão um SqlBinary em vez de uma UDT quando o Type System Version for definido como SQL Server 2005:

• GetProviderSpecificFieldType
• GetProviderSpecificValue
• GetProviderSpecificValues
• GetSqlValue
• GetSqlValues

Os seguintes métodos retornarão uma matriz de Byte[] em vez de uma UDT quando o Type System Version for definido como SQL Server 2005:

• GetValue
• GetValues

Observe que nenhuma das conversões são feitas para a versão atual do ADO.NET.

Especificar SqlParameters

As propriedades SqlParameter a seguir foram estendidas para funcionar com UDTs grandes.

Recuperando exemplo de dados

O fragmento de código a seguir demonstra como recuperar dados de uma UDT grande. A variável connectionString assume uma conexão válida com um banco de dados SQL Server, e a variável commandString pressupõe uma instrução SELECT válida com a coluna de chave primária listada primeiro.

using (SqlConnection connection = new SqlConnection(
    connectionString, commandString))
{
  connection.Open();
  SqlCommand command = new SqlCommand(commandString);
  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, commandString)
    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

Confira também

• Configurar parâmetros e tipos de dados de parâmetro
• Como recuperar informações de esquema de banco de dados
• Mapeamentos de tipo de dados do SQL Server
• Dados binários e de valor grande do SQL Server
• Visão geral do ADO.NET