Megosztás a következőn keresztül:

Felhasználó által definiált típusok létrehozása

A következőkre vonatkozik:SQL Server

Az SQL Serveren telepíthető felhasználó által definiált típus (UDT) létrehozásához először létre kell hoznia egy osztályt az egyik támogatott .NET-keretrendszer programozási nyelvben, például C# vagy Visual Basic .NET nyelven, amely megfelel az UDT-k létrehozásának specifikációinak. Az osztály ezután lefordítható dinamikus csatolású kódtárként (DLL), amely betölthető az SQL Serverbe. UdT-eket a Visual Studióval is létrehozhat és üzembe helyezhet.

A közös nyelvi futtatókörnyezeti (CLR) kód végrehajtásának lehetősége alapértelmezés szerint ki van kapcsolva az SQL Serverben. A CLR a sp_configure rendszer által tárolt eljárással engedélyezhető, ahogy az a következő Transact-SQL utasításokban is látható:

EXECUTE sp_configure 'clr enabled', 1;
RECONFIGURE;

Ebben a szakaszban

Cikk Leírás
felhasználó által definiált típusú (UDT) követelmények A felhasználó által definiált típusok kódolásának követelményeit ismerteti.
Felhasználó által definiált típusok létrehozása ADO.NET Bemutatja a felhasználó által definiált típusok létrehozásához használt kódolási technikákat.

Példák

Az alábbi kódlista az Point UDT-t határozza meg, amelyet részletesen Felhasználó által definiált típusok létrehozása 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));
    }
}

Kapcsolódó tartalom

  • Last updated on