Tipi definiti dall'utente di grandi dimensioni

  • Articolo

I tipi definiti dall'utente (UDT) consentono agli sviluppatori di estendere il sistema di tipi scalare del server archiviando oggetti Common Language Runtime (CLR) in un database di SQL Server. I tipi definiti dall'utente possono contenere più elementi e avere comportamenti che, a differenza dei tradizionali tipi di dati alias, sono costituiti da un solo tipo di dati di sistema di SQL Server.

Nota

Per sfruttare il supporto SqlClient migliorato per i tipi UDT di grandi dimensioni, è necessario installare .NET Framework 3.5 SP1 (o versione successiva).

In precedenza, i tipi definiti dall'utente erano limitati a una dimensione massima di 8 kilobyte. In SQL Server 2008 questa limitazione è stata rimossa per i tipi definiti dall'utente con il formato UserDefined.

Per la documentazione completa relativa ai tipi definiti dall'utente, vedere Tipi CLR definiti dall'utente.

Recupero di schemi UDT tramite GetSchema

Il metodo GetSchema di SqlConnection restituisce le informazioni sullo schema del database in un DataTable. Per altre informazioni, vedere Raccolte di schemi di SQL Server.

Valori della colonna GetSchemaTable per i tipi UDT

Il metodo GetSchemaTable di un SqlDataReader restituisce un DataTable che descrive i metadati della colonna. Nella tabella seguente vengono descritte le differenze tra SQL Server 2005 e SQL Server 2008 riguardo ai metadati delle colonne per i tipi definiti dall'utente di grandi dimensioni.

Colonna SqlDataReader SQL Server 2005 SQL Server 2008 e versioni successive
ColumnSize Variabile Variabile
NumericPrecision 255 255
NumericScale 255 255
DataType Byte[] Istanza UDT
ProviderSpecificDataType SqlTypes.SqlBinary Istanza UDT
ProviderType 21 (SqlDbType.VarBinary) 29 (SqlDbType.Udt)
NonVersionedProviderType 29 (SqlDbType.Udt) 29 (SqlDbType.Udt)
DataTypeName SqlDbType.VarBinary Nome in tre parti specificato come Database.SchemaName.TypeName.
IsLong Variabile Variabile

Considerazioni su SqlDataReader

SqlDataReader è stato esteso a partire da SQL Server 2008 per supportare il recupero di valori UDT di grandi dimensioni. La modalità di elaborazione dei valori UDT di grandi dimensioni da parte di un SqlDataReader dipende dalla versione di SQL Server in uso, nonché dall'elemento Type System Version specificato nella stringa di connessione. Per ulteriori informazioni, vedere ConnectionString.

I metodi seguenti di SqlDataReader restituiranno un SqlBinary anziché un tipo definito dall'utente quando Type System Version è impostato su SQL Server 2005:

I metodi seguenti restituiranno una matrice di Byte[] anziché un tipo definito dall'utente quando Type System Version è impostato su SQL Server 2005:

Si noti che non viene eseguita alcuna conversione per la versione corrente di ADO.NET.

Specifica di SqlParameter

Le proprietà SqlParameter seguenti sono state estese per funzionare con i tipi definiti dall'utente di grandi dimensioni.

Proprietà SqlParameter Descrizione
Value Ottiene o imposta un oggetto che rappresenta il valore del parametro. Il valore predefinito è Null. La proprietà può essere SqlBinary, Byte[] o un oggetto gestito.
SqlValue Ottiene o imposta un oggetto che rappresenta il valore del parametro. Il valore predefinito è Null. La proprietà può essere SqlBinary, Byte[] o un oggetto gestito.
Size Ottiene o imposta la dimensione del valore del parametro da risolvere. Il valore predefinito è 0. La proprietà può essere un numero intero che rappresenta la dimensione del valore del parametro. Per gli UDT di grandi dimensioni, può trattarsi delle dimensioni effettive dell'UDT oppure di -1 per i tipi sconosciuti.

Esempio di recupero di dati

Il frammento di codice seguente illustra come recuperare dati UDT di grandi dimensioni. La variabile connectionString presuppone una connessione valida a un database SQL Server e la variabile commandString presuppone un'istruzione SELECT valida con la colonna chiave primaria elencata per prima.

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

Vedi anche