Recuperación de datos de tipo definido por el usuario (UDT) en ADO.NET

Se aplica a:SQL Server

Para crear un tipo definido por el usuario (UDT) en el cliente, el ensamblado registrado como UDT en una base de datos de SQL Server debe estar disponible para la aplicación cliente. El ensamblado UDT se puede colocar en el mismo directorio que la aplicación o en la caché de ensamblados global (GAC). También puede establecer una referencia al ensamblado en su proyecto.

Requisitos para usar udT en ADO.NET

El ensamblado cargado en SQL Server y el ensamblado en el cliente deben ser compatibles para que el UDT se cree en el cliente. Para los UDT definidos con el formato de serialización Native, los ensamblados deben ser estructuralmente compatibles. Para los ensamblados definidos con el formato UserDefined, el ensamblado debe estar disponible en el cliente.

No necesita una copia del ensamblado UDT en el cliente para recuperar los datos sin procesar de una columna UDT de una tabla.

Nota:

SqlClient es posible que no se cargue un UDT si las versiones udT no coinciden u otros problemas se producen. En este caso, use mecanismos de solución de problemas normales para determinar por qué el ensamblado que contiene el UDT no se puede encontrar mediante la aplicación que realiza la llamada. Para obtener más información, consulte Diagnosticar errores con asistentes de depuración administrada.

Los ejemplos de código de este artículo usan Microsoft.Data.SqlClient, que está disponible como un paquete NuGet. Para agregar esta dependencia al proyecto, ejecute el siguiente comando:

dotnet add package Microsoft.Data.SqlClient

Acceso a udT con sqlDataReader

Use un Microsoft.Data.SqlClient.SqlDataReader objeto de código de cliente para recuperar un conjunto de resultados que contenga una columna UDT, que se expone como una instancia del objeto.

Ejemplo

En este ejemplo se muestra cómo usar el método Main para crear un nuevo objeto SqlDataReader. En el ejemplo de código se producen las siguientes acciones:

El método Main crea un nuevo objeto SqlDataReader y recupera los valores de la tabla Points, que tiene una columna UDT denominada Point.
El Point UDT expone coordenadas X e Y definidas como enteros.
El UDT define un método Distance y un método GetDistanceFromXY.
El código de ejemplo recupera los valores de la clave principal y las columnas UDT para mostrar las funcionalidades del UDT.
El código de ejemplo llama a los métodos Point.Distance y Point.GetDistanceFromXY.
Los resultados se muestran en la ventana de la consola.

Nota:

La aplicación ya debe tener una referencia al ensamblado UDT.

de C#
de Visual Basic para .NET

using System;
using Microsoft.Data.SqlClient;

namespace Microsoft.Samples.SqlServer
{
    class ReadPoints
    {
        static void Main()
        {
            string connectionString = GetConnectionString();
            using (SqlConnection cnn = new SqlConnection(connectionString))
            {
                cnn.Open();
                SqlCommand cmd = new SqlCommand(
                    "SELECT ID, Pnt FROM dbo.Points", cnn);
                SqlDataReader rdr = cmd.ExecuteReader();

                while (rdr.Read())
                {
                    // Retrieve the value of the Primary Key column
                    int id = rdr.GetInt32(0);

                    // Retrieve the value of the UDT
                    Point pnt = (Point)rdr[1];

                    // You can also use GetSqlValue and GetValue
                    // Point pnt = (Point)rdr.GetSqlValue(1);
                    // Point pnt = (Point)rdr.GetValue(1);

                    Console.WriteLine(
                        "ID={0} Point={1} X={2} Y={3} DistanceFromXY={4} Distance={5}",
                        id, pnt, pnt.X, pnt.Y, pnt.DistanceFromXY(1, 9), pnt.Distance());
                }
                rdr.Close();
                Console.WriteLine("done");
            }
            static private string GetConnectionString()
            {
                // To avoid storing the connection string in your code,
                // you can retrieve it from a configuration file.
                return "Data Source=(local);Initial Catalog=AdventureWorks2022"
                       + "Integrated Security=SSPI";
            }
        }
    }
}

Option Explicit On
Option Strict On

Imports System
Imports Microsoft.Data.SqlClient

Module ReadPoints
    Sub Main()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection(connectionString)
            cnn.Open()
            Dim cmd As New SqlCommand( _
             "SELECT ID, Pnt FROM dbo.Points", cnn)
            Dim rdr As SqlDataReader
            rdr = cmd.ExecuteReader

            While rdr.Read()
                ' Retrieve the value of the Primary Key column
                Dim id As Int32 = rdr.GetInt32(0)

                ' Retrieve the value of the UDT
                Dim pnt As Point = CType(rdr(1), Point)

             ' You can also use GetSqlValue and GetValue
             ' Dim pnt As Point = CType(rdr.GetSqlValue(1), Point)
             ' Dim pnt As Point = CType(rdr.GetValue(1), Point)

                ' Print values
                Console.WriteLine( _
                 "ID={0} Point={1} X={2} Y={3} DistanceFromXY={4} Distance={5}", _
                  id, pnt, pnt.X, pnt.Y, pnt.DistanceFromXY(1, 9), pnt.Distance())
            End While
            rdr.Close()
            Console.WriteLine("done")
        End Using
    End Sub
    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=AdventureWorks2022" _
         & "Integrated Security=SSPI;"
    End Function
End Module

Enlazar UDT como bytes

En algunas situaciones, es posible que desee recuperar los datos sin procesar de la columna UDT. Quizás el tipo no esté disponible localmente o no quiera crear instancias de una instancia del UDT. Puede leer los bytes sin procesar en una matriz de bytes mediante el GetBytes método de .SqlDataReader Este método lee un flujo de bytes a partir del desplazamiento de la columna especificada en el búfer de una matriz, comenzando en el desplazamiento del búfer especificado. Otra opción es usar uno de los métodos GetSqlBytes o GetSqlBinary y leer todo el contenido en una sola operación. En cualquier caso, nunca se crea una instancia del objeto UDT, por lo que no es necesario establecer una referencia al UDT en el ensamblado de cliente.

Ejemplo

En este ejemplo se muestra cómo recuperar los Point datos como bytes sin procesar en una matriz de bytes mediante un SqlDataReader. El código usa un System.Text.StringBuilder para convertir los bytes sin procesar en una representación de cadena que se mostrará en la ventana de la consola.

de C#
de Visual Basic para .NET

using System;
using Microsoft.Data.SqlClient;
using System.Data.SqlTypes;
using System.Text;

class GetRawBytes
{
    static void Main()
    {
        string connectionString = GetConnectionString();
        using (SqlConnection cnn = new SqlConnection(connectionString))
        {
            cnn.Open();
            SqlCommand cmd = new SqlCommand("SELECT ID, Pnt FROM dbo.Points", cnn);
            SqlDataReader rdr = cmd.ExecuteReader();

            while (rdr.Read())
            {
                // Retrieve the value of the Primary Key column
                int id = rdr.GetInt32(0);

                // Retrieve the raw bytes into a byte array
                byte[] buffer = new byte[32];
                long byteCount = rdr.GetBytes(1, 0, buffer, 0, 32);

                // Format and print bytes
                StringBuilder str = new StringBuilder();
                str.AppendFormat("ID={0} Point=", id);

                for (int i = 0; i < byteCount; i++)
                    str.AppendFormat("{0:x}", buffer[i]);
                Console.WriteLine(str.ToString());
            }
            rdr.Close();
            Console.WriteLine("done");
        }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks2022"
            + "Integrated Security=SSPI";
    }
  }
}

Option Explicit On
Option Strict On

Imports System
Imports Microsoft.Data.SqlClient
Imports System.Data.SqlTypes
Imports System.Text

Module GetRawBytes
    Sub Main()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection(connectionString)
            cnn.Open()
            Dim cmd As New SqlCommand( _
             "SELECT ID, Pnt FROM dbo.Points", cnn)
            Dim rdr As SqlDataReader
            rdr = cmd.ExecuteReader

            While rdr.Read()

                ' Retrieve the value of the Primary Key column
                Dim id As Int32 = rdr.GetInt32(0)

                ' Retrieve the raw bytes into a byte array
                Dim buffer(31) As Byte
                Dim byteCount As Integer = _
                 CInt(rdr.GetBytes(1, 0, buffer, 0, 31))

                ' Format and print bytes
                Dim str As New StringBuilder
                str.AppendFormat("ID={0} Point=", id)

                Dim i As Integer
                For i = 0 To (byteCount - 1)
                    str.AppendFormat("{0:x}", buffer(i))
                Next
                Console.WriteLine(str.ToString)

            End While
            rdr.Close()
            Console.WriteLine("done")
        End Using
    End Sub
    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=AdventureWorks2022" _
           & "Integrated Security=SSPI;"
    End Function
End Module

Ejemplo de uso de GetSqlBytes

En este ejemplo se muestra cómo recuperar los Point datos como bytes sin procesar en una sola operación mediante el GetSqlBytes método . El código usa un StringBuilder para convertir los bytes sin procesar en una representación de cadena que se mostrará en la ventana de la consola.

de C#
de Visual Basic para .NET

using System;
using Microsoft.Data.SqlClient;
using System.Data.SqlTypes;
using System.Text;

class GetRawBytes
{
    static void Main()
    {
         string connectionString = GetConnectionString();
        using (SqlConnection cnn = new SqlConnection(connectionString))
        {
            cnn.Open();
            SqlCommand cmd = new SqlCommand(
                "SELECT ID, Pnt FROM dbo.Points", cnn);
            SqlDataReader rdr = cmd.ExecuteReader();

            while (rdr.Read())
            {
                // Retrieve the value of the Primary Key column
                int id = rdr.GetInt32(0);

                // Use SqlBytes to retrieve raw bytes
                SqlBytes sb = rdr.GetSqlBytes(1);
                long byteCount = sb.Length;

                // Format and print bytes
                StringBuilder str = new StringBuilder();
                str.AppendFormat("ID={0} Point=", id);

                for (int i = 0; i < byteCount; i++)
                    str.AppendFormat("{0:x}", sb[i]);
                Console.WriteLine(str.ToString());
            }
            rdr.Close();
            Console.WriteLine("done");
        }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks2022"
            + "Integrated Security=SSPI";
    }
  }
}

Option Explicit On
Option Strict On

Imports System
Imports Microsoft.Data.SqlClient
Imports System.Data.SqlTypes
Imports System.Text

Module GetRawBytes
    Sub Main()
        Dim connectionString As String = GetConnectionString()
        Using cnn As New SqlConnection(connectionString)
            cnn.Open()
            Dim cmd As New SqlCommand( _
             "SELECT ID, Pnt FROM dbo.Points", cnn)
            Dim rdr As SqlDataReader
            rdr = cmd.ExecuteReader

            While rdr.Read()
                ' Retrieve the value of the Primary Key column
                Dim id As Int32 = rdr.GetInt32(0)

                ' Use SqlBytes to retrieve raw bytes
                Dim sb As SqlBytes = rdr.GetSqlBytes(1)
                Dim byteCount As Long = sb.Length

                ' Format and print bytes
                Dim str As New StringBuilder
                str.AppendFormat("ID={0} Point=", id)

                Dim i As Integer
                For i = 0 To (byteCount - 1)
                    str.AppendFormat("{0:x}", sb(i))
                Next
                Console.WriteLine(str.ToString)

            End While
            rdr.Close()
            Console.WriteLine("done")
        End Using
    End Sub
    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=AdventureWorks2022" _
           & "Integrated Security=SSPI;"
    End Function
End Module

Trabajar con parámetros UDT

Puede usar udT como parámetros de entrada y salida en el código de ADO.NET.

Uso de UDT en parámetros de consulta

Puede usar udT como valores de parámetro al configurar un SqlParameter para un Microsoft.Data.SqlClient.SqlCommand objeto . La SqlDbType.Udt enumeración de un SqlParameter objeto indica que el parámetro es un UDT al llamar al Add método a la Parameters colección. La UdtTypeName propiedad de un SqlCommand objeto especifica el nombre completo del UDT de la base de datos mediante la <database>.<schema_name>.<object_name> sintaxis . Use el nombre completo para evitar ambigüedad en el código.

Debe haber una copia local del ensamblado UDT disponible para el proyecto del cliente.

Ejemplo

El código de este ejemplo crea SqlCommand y SqlParameter objetos para insertar datos en una columna UDT de una tabla. El código usa la enumeración SqlDbType.Udt para especificar el tipo de datos y la propiedad UdtTypeName del objeto SqlParameter para especificar el nombre completo del UDT en la base de datos.

de C#
de Visual Basic para .NET

using System;
using System.Data;
using Microsoft.Data.SqlClient;

class Class1
{
static void Main()
{
  string ConnectionString = GetConnectionString();
     using (SqlConnection cnn = new SqlConnection(ConnectionString))
     {
       SqlCommand cmd = cnn.CreateCommand();
       cmd.CommandText =
         "INSERT INTO dbo.Points (Pnt) VALUES (@Point)";
       cmd.CommandType = CommandType.Text;

       SqlParameter param = new SqlParameter("@Point", SqlDbType.Udt);       param.UdtTypeName = "TestPoint.dbo.Point";       param.Direction = ParameterDirection.Input;       param.Value = new Point(5, 6);       cmd.Parameters.Add(param);

       cnn.Open();
       cmd.ExecuteNonQuery();
       Console.WriteLine("done");
     }
    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code,
        // you can retrieve it from a configuration file.
        return "Data Source=(local);Initial Catalog=AdventureWorks2022"
            + "Integrated Security=SSPI";
    }
  }
}

Option Explicit On
Option Strict On

Imports System
Imports System.Data
Imports Microsoft.Data.SqlClient

Module Module1

  Sub Main()
    Dim ConnectionString As String = GetConnectionString()
    Dim cnn As New SqlConnection(ConnectionString)
    Using cnn
      Dim cmd As SqlCommand = cnn.CreateCommand()
      cmd.CommandText = "INSERT INTO dbo.Points (Pnt) VALUES (@Point)"
      cmd.CommandType = CommandType.Text

      Dim param As New SqlParameter("@Point", SqlDbType.Udt)
      param.UdtTypeName = "TestPoint.dbo.Point"
      param.Direction = ParameterDirection.Input
      param.Value = New Point(5, 6)
      cmd.Parameters.Add(param)

      cnn.Open()
      cmd.ExecuteNonQuery()
      Console.WriteLine("done")
    End Using
  End Sub
    Private Function GetConnectionString() As String
        ' To avoid storing the connection string in your code,
        ' you can retrieve it from a configuration file.
        Return "Data Source=(local);Initial Catalog=AdventureWorks2022;" _
           & "Integrated Security=SSPI;"
    End Function
End Module

Acceso a tipos definidos por el usuario en ADO.NET

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-03-24

Compartir a través de

Recuperación de datos de tipo definido por el usuario (UDT) en ADO.NET

Requisitos para usar udT en ADO.NET

Acceso a udT con sqlDataReader

Ejemplo

Enlazar UDT como bytes

Ejemplo

Ejemplo de uso de GetSqlBytes

Trabajar con parámetros UDT

Uso de UDT en parámetros de consulta

Ejemplo

Contenido relacionado

Comentarios

Recursos adicionales