Sdílet prostřednictvím

Vytváření uživatelem definovaných typů

  • Článek

platí pro:SQL Server

Chcete-li vytvořit uživatelem definovaný typ (UDT), který je schopen nainstalovat na SQL Server, musíte nejprve vytvořit třídu v jednom z podporovaných programovacích jazyků rozhraní .NET Framework, jako je C# nebo Visual Basic .NET, který odpovídá specifikacím pro vytváření UDT. Třída je pak možné zkompilovat jako dynamickou knihovnu (DLL), kterou lze načíst na SQL Server. Můžete také vytvářet a nasazovat UDT pomocí sady Visual Studio.

Možnost spouštění kódu CLR (Common Language Runtime) je ve výchozím nastavení v SQL Serveru vypnutá. Modul CLR lze povolit pomocí sp_configure systémové uložené procedury, jak je znázorněno v následujících příkazech Transact-SQL:

EXECUTE sp_configure 'clr enabled', 1;
RECONFIGURE;

V této části

Článek Popis
požadavky na uživatelem definovaný typ (UDT) Popisuje požadavky pro kódování uživatelsky definovaných typů.
Vytváření uživatelsky definovaných typů pomocí ADO.NET Demonstruje techniky kódování, které se týkají vytváření uživatelsky definovaných typů.

Příklady

Následující výpis kódu definuje Point UDT, který je podrobně popsán v Vytváření uživatelsky definovaných typů pomocí ADO.NET.

using System;
using System.Data;
using System.Data.SqlTypes;
using Microsoft.SqlServer.Server;
using System.Text;

[Serializable]
[Microsoft.SqlServer.Server.SqlUserDefinedType(Format.Native,
     IsByteOrdered=true, ValidationMethodName = "ValidatePoint")]
public struct Point : INullable
{
    private bool is_Null;
    private Int32 _x;
    private Int32 _y;

    public bool IsNull
    {
        get
        {
            return (is_Null);
        }
    }

    public static Point Null
    {
        get
        {
            Point pt = new Point();
            pt.is_Null = true;
            return pt;
        }
    }

    // Use StringBuilder to provide string representation of UDT.
    public override string ToString()
    {
        // Since InvokeIfReceiverIsNull defaults to 'true'
        // this test is unnecessary if Point is only being called
        // from SQL.
        if (this.IsNull)
            return "NULL";
        else
        {
            StringBuilder builder = new StringBuilder();
            builder.Append(_x);
            builder.Append(",");
            builder.Append(_y);
            return builder.ToString();
        }
    }

    [SqlMethod(OnNullCall = false)]
    public static Point Parse(SqlString s)
    {
        // With OnNullCall=false, this check is unnecessary if
        // Point only called from SQL.
        if (s.IsNull)
            return Null;

        // Parse input string to separate out points.
        Point pt = new Point();
        string[] xy = s.Value.Split(",".ToCharArray());
        pt.X = Int32.Parse(xy[0]);
        pt.Y = Int32.Parse(xy[1]);

        // Call ValidatePoint to enforce validation
        // for string conversions.
        if (!pt.ValidatePoint())
            throw new ArgumentException("Invalid XY coordinate values.");
        return pt;
    }

    // X and Y coordinates exposed as properties.
    public Int32 X
    {
        get
        {
            return this._x;
        }
        // Call ValidatePoint to ensure valid range of Point values.
        set
        {
            Int32 temp = _x;
            _x = value;
            if (!ValidatePoint())
            {
                _x = temp;
                throw new ArgumentException("Invalid X coordinate value.");
            }
        }
    }

    public Int32 Y
    {
        get
        {
            return this._y;
        }
        set
        {
            Int32 temp = _y;
            _y = value;
            if (!ValidatePoint())
            {
                _y = temp;
                throw new ArgumentException("Invalid Y coordinate value.");
            }
        }
    }

    // Validation method to enforce valid X and Y values.
    private bool ValidatePoint()
    {
        // Allow only zero or positive integers for X and Y coordinates.
        if ((_x >= 0) && (_y >= 0))
        {
            return true;
        }
        else
        {
            return false;
        }
    }

    // Distance from 0 to Point method.
    [SqlMethod(OnNullCall = false)]
    public Double Distance()
    {
        return DistanceFromXY(0, 0);
    }

    // Distance from Point to the specified point method.
    [SqlMethod(OnNullCall = false)]
    public Double DistanceFrom(Point pFrom)
    {
        return DistanceFromXY(pFrom.X, pFrom.Y);
    }

    // Distance from Point to the specified x and y values method.
    [SqlMethod(OnNullCall = false)]
    public Double DistanceFromXY(Int32 iX, Int32 iY)
    {
        return Math.Sqrt(Math.Pow(iX - _x, 2.0) + Math.Pow(iY - _y, 2.0));
    }
}

Související obsah