Udostępnij przez

Duże UDT

Typy zdefiniowane przez użytkownika umożliwiają deweloperowi rozszerzenie systemu typów skalarnych serwera przez przechowywanie obiektów środowiska uruchomieniowego języka wspólnego (CLR) w bazie danych programu SQL Server. Typy zdefiniowane przez użytkownika (UDT) mogą składać się z wielu elementów i mogą posiadać określone zachowania, w przeciwieństwie do tradycyjnych aliasowych typów danych, które składają się z jednego typu danych systemowych w SQL Server.

Uwaga

Aby móc korzystać z rozszerzonej obsługi dużych typów zdefiniowanych przez użytkownika (UDT) w SqlClient, należy zainstalować .NET Framework 3.5 z dodatkiem SP1 (lub nowszym).

Wcześniej typy danych zdefiniowane przez użytkownika były ograniczone do maksymalnego rozmiaru 8 kilobajtów. W programie SQL Server 2008 to ograniczenie zostało usunięte dla typów zdefiniowanych przez użytkownika (UDT) o formacie UserDefined.

Aby uzyskać pełną dokumentację typów zdefiniowanych przez użytkownika, zobacz CLR User-Defined Types (Typy zdefiniowane przez użytkownika).

Pobieranie schematów UDT przy użyciu polecenia GetSchema

Metoda GetSchema zwraca informacje o schemacie bazy danych SqlConnection w obiekcie DataTable. Aby uzyskać więcej informacji, zobacz Kolekcje schematów programu SQL Server.

Wartości kolumn GetSchemaTable dla UDTs

Metoda GetSchemaTable obiektu SqlDataReader zwraca DataTable opisujący metadane kolumny. W poniższej tabeli opisano różnice w metadanych kolumn dla dużych tras zdefiniowanych przez użytkownika między programem SQL Server 2005 i programem SQL Server 2008.

Kolumna SqlDataReader SQL Server 2005 SQL Server 2008 i nowsze
ColumnSize Różne Różne
NumericPrecision 255 255
NumericScale 255 255
DataType Byte[] Wystąpienie UDT
ProviderSpecificDataType SqlTypes.SqlBinary Instancja UDT
ProviderType 21 (SqlDbType.VarBinary) 29 (SqlDbType.Udt)
NonVersionedProviderType 29 (SqlDbType.Udt) 29 (SqlDbType.Udt)
DataTypeName SqlDbType.VarBinary Trzyczęściowa nazwa określona jako Database.SchemaName.TypeName.
IsLong Różne Różne

Zagadnienia dotyczące elementu SqlDataReader

Funkcjonalność SqlDataReader została rozszerzona od programu SQL Server 2008, aby obsługiwać pobieranie dużych wartości UDT. Sposób przetwarzania dużych wartości UDT przez SqlDataReader zależy od używanej wersji programu SQL Server, a także od Type System Version określonej w ciągu połączenia. Aby uzyskać więcej informacji, zobacz ConnectionString.

Następujące metody SqlDataReader zwrócą SqlBinary zamiast UDT, gdy Type System Version jest ustawione na SQL Server 2005.

Następujące metody zwracają tablicę Byte[] zamiast UDT, gdy Type System Version jest ustawiony na SQL Server 2005.

Należy pamiętać, że dla bieżącej wersji ADO.NET nie są wykonywane żadne konwersje.

Określanie parametrów SqlParameters

Następujące SqlParameter właściwości zostały rozszerzone w celu działania z dużymi typami zdefiniowanymi przez użytkownika.

SqlParameter, właściwość opis
Value Pobiera lub ustawia obiekt reprezentujący wartość parametru. Domyślny ma wartość null. Właściwość może mieć SqlBinarywartość, Byte[]lub obiekt zarządzany.
SqlValue Pobiera lub ustawia obiekt reprezentujący wartość parametru. Domyślny ma wartość null. Właściwość może być SqlBinary, Byte[] lub obiektem zarządzanym.
Size Pobiera lub ustawia rozmiar wartości parametru do rozpoznania. Wartość domyślna to 0. Właściwość może być liczbą całkowitą reprezentującą rozmiar wartości parametru. W przypadku dużych tras zdefiniowanych przez użytkownika może to być rzeczywisty rozmiar udT lub -1 dla nieznanego.

Przykład pobierania danych

Poniższy fragment kodu przedstawia sposób pobierania dużych danych UDT. Zmienna connectionString zakłada prawidłowe połączenie z bazą danych programu SQL Server, a commandString zmienna zakłada prawidłową instrukcję SELECT z pierwszą kolumną klucza podstawowego.

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

Zobacz też

  • Last updated on