大网数据广告活动
数据库与应用安全

用户定义的类型要求

· 52CE 我爱测

!INCLUDE[appliesto-ss-xxxx-xxxx-xxx-md] 在创建用户定义类型 (UDT) 中安装时,必须进行几个重要的设计决策!INCLUDE[msCoName] !INCLUDE[ssNoVersion]。 对于大多数 UDT,建议将 UDT 作为结构创建,尽管也可以选择将其作为类创建。 UDT 定义必须符合用于创建 UDT 的规范,以使其能够注册到 !INCLUDE[ssNoVersion]。

适用对象:yesSQL ServeryesAzure SQL 数据库noAzure SQL 数据仓库no并行数据仓库 在创建用户定义类型 (UDT) 中安装时,必须进行几个重要的设计决策Microsoft SQL Server。 对于大多数 UDT,建议将 UDT 作为结构创建,尽管也可以选择将其作为类创建。 UDT 定义必须符合用于创建 UDT 的规范,以使其能够注册到 SQL Server。

实现 UDT 的要求

为了在 SQL Server 中运行,您的 UDT 必须实现 UDT 定义中的以下要求:

该 UDT 必须指定Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute。 利用System.SerializableAttribute是可选的但建议执行。

  • 该 UDT 必须实现System.Data.SqlTypes.INullable中的类或结构通过创建一个公共接口静态(共享中MicrosoftVisualBasic) Null方法。 默认情况下,SQL Server 是可识别 Null 的。 这是为使在 UDT 中执行的代码能够识别 Null 值所必需的。

  • UDT 必须包含一个公共静态(或共享)分析支持从其进行分析的方法和公共ToString方法将转换为对象的字符串表示形式。

  • 使用用户定义序列化格式的 UDT 必须实现System.Data.IBinarySerialize接口,并提供读取和一个编写方法。

  • 该 UDT 必须实现System.Xml.Serialization.IXmlSerializable,或者所有公共字段和属性必须为这些类型是 XML 可序列化或使用修饰XmlIgnore特性重写标准序列化是必需的。

  • 一个 UDT 对象必须只存在一个序列化。 如果序列化或反序列化例程识别了某一特定对象的多个表示形式,则验证将失败。

  • SqlUserDefinedTypeAttribute.IsByteOrdered必须是true字节顺序中的数据进行比较。 如果未实现 IComparable 接口和SqlUserDefinedTypeAttribute.IsByteOrdered是false,字节顺序比较将失败。

  • 在类中定义的 UDT 必须具有不采用任何参数的公共构造函数。 您可以选择创建其他重载类构造函数。

  • 该 UDT 必须将数据元素作为公共字段或属性过程公开。

  • 公共名称长度不能超过 128 个字符,并且必须符合SQL Server中定义的标识符命名规则数据库标识符。

  • sql_variant列不能包含 UDT 的实例。

  • 继承的成员无法从 Transact-SQL 访问,因为 SQL Server 类型系统不知道 UDT 中的继承层次结构。 但是,您可以在创建类的结构时使用继承,并且可以在该类型的托管代码实现方式中调用此类方法。

  • 成员不能被重载,但类构造函数除外。 如果您创建某一重载方法,则在 SQL Server 中注册程序集或创建类型时将不会引发错误。 在运行时将检测到重载的方法,而不是在创建类型时检测到。 只要永不调用重载的方法,重载的方法就可以存在于类中。 一旦您调用重载的方法,就会引发错误。

  • 任何静态(或共享) 成员必须声明为常量或为只读的。 静态成员将无法改变。

  • 如果SqlUserDefinedTypeAttribute.MaxByteSize字段设置为-1,则序列化的 UDT 可以大至作为大型对象 (LOB) 大小限制 (目前为 2 GB)。 该 UDT 的大小不能超过中指定的值MaxByteSized字段。

Note:
尽管它不由服务器来执行比较,您可以选择实现System.IComparable接口,公开了一个方法,该接口CompareTo。 此方法用于客户端上希望精确比较或排序 UDT 值的情况中。

本机序列化

为您的 UDT 选择正确的序列化属性取决于您正尝试创建的 UDT 的类型。 本机序列化格式利用一个非常简单的结构,使SQL Server磁盘上存储 UDT 的有效本机表示形式。 本机如果 UDT 很简单,仅包含以下类型的字段,建议使用格式:

bool,字节, sbyte,短, ushort, int, uint,长, ulong, float, double,以,SqlInt16, SqlInt32, SqlInt64, SqlDateTime, SqlSingle, SqlDouble, SqlMoney, SqlBoolean

上述类型的字段的值类型组成,非常适合进行本机格式,例如结构在 Visual C# 中,(或结构大家所熟知中Visual Basic 中)。 例如,使用指定的 UDT本机序列化格式可能包含的其他 UDT 的使用也指定了字段本机格式。 如果 UDT 定义更复杂,包含不在上述列表的数据类型,必须指定UserDefined改为序列化格式。

本机格式具有以下要求:

  • 类型必须为指定值Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute.MaxByteSize。

  • 所有字段必须均可序列化。

  • System.Runtime.InteropServices.StructLayoutAttribute必须指定为StructLayout.LayoutKindSequential如果 UDT 定义一个类,而不是结构中。 此属性控制数据字段的物理布局,并用来按照成员的出现顺序对它们进行布局。 SQL Server 使用此属性确定具有多个值的 UDT 的字段顺序。

有关使用定义的 UDT 的示例本机序列化,请参阅中的 Point UDT类型。

UserDefined 序列化

UserDefined格式设置为Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute属性将使开发人员完全控制二进制格式。 指定时格式特性的属性作为UserDefined,必须在代码中执行以下操作:

  • 指定可选IsByteOrdered特性属性。 默认值是 false秒。

  • 指定MaxByteSize的属性Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute。

  • 编写代码以实现读并编写用于通过实现 UDT 方法System.Data.Sql.IBinarySerialize接口。

有关使用定义的 UDT 的示例UserDefined序列化,请参阅中的 Currency UDT类型。

Note:
为了编制索引,UDT 字段必须使用本机序列化或者是持久化的。

序列化属性

属性确定如何使用序列化来构造 UDT 的存储表示形式以及如何按值将 UDT 传输到客户端。 需要指定Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute时创建用户定义的类型。 Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute属性指示类是 UDT 并且指定的 UDT 的存储。 您可以选择指定Serializable属性,尽管SQL Server不需要它。

Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute具有以下属性。

格式
指定序列化格式,可以是本机或UserDefined,取决于用户定义的类型的数据类型。

IsByteOrdered
一个布尔值,该值确定如何SQL Server对 UDT 执行二进制比较。

IsFixedLength
指示此 UDT 的所有实例是否都具有相同的长度。

MaxByteSize
实例的最大大小(以字节为单位)。 必须指定MaxByteSize与UserDefined序列化格式。 有关与指定,用户定义序列化 UDT MaxByteSize定义的用户是指其序列化的窗体中的 UDT 的总大小。 值MaxByteSize必须在 1 到 8000 的范围内或设置为-1 以指示 UDT 大于 8000 个字节 (总大小不能超过最大 LOB 大小)。 考虑这样一个 UDT 属性值为 10 个字符的字符串 (System.Char)。 当使用 BinaryWriter 序列化 UDT 时,序列化字符串的总大小为 22 字节:每个 Unicode UTF-16 字符占 2 个字节,乘以最大字符数,再加上因序列化二进制流而导致的系统开销 2 个控制字节。 因此,确定的值时MaxByteSize,必须考虑序列化 UDT 的总大小: 以二进制格式序列化的数据加上因序列化所产生的开销大小。

ValidationMethodName
用于验证 UDT 的实例的方法的名称。

设置 IsByteOrdered

当Microsoft.SqlServer.Server.SqlUserDefinedTypeAttribute.IsByteOrdered属性设置为true,实际上保证的序列化的二进制数据,可以用于语义排序的信息。 因此,以字节排序的 UDT 对象的每个实例只能有一种序列化表示形式。 当在 SQL Server 中对序列化字节执行比较操作时,其结果应与在托管代码中执行同样的比较操作时的结果相同。 以下功能均支持何时IsByteOrdered设置为true:

  • 可以对此类型的列创建索引。

  • 可以对此类型的列创建主键和外键以及 CHECK 和 UNIQUE 约束。

  • 可以使用 Transact-SQL ORDER BY、GROUP BY 和 PARTITION BY 子句。 此时,将使用该类型的二进制表示形式确定顺序。

  • 可以在 Transact-SQL 语句中使用比较运算符。

  • 可以保持此类型的计算列。

请注意,同时本机并UserDefined序列化格式支持以下比较运算符时IsByteOrdered设置为 ,则返回 true:

  • 等于 (=)

  • 不等于 (!=)

  • 大于号 (>)

  • 小于号 (<)

  • 大于或等于 (> =)

  • 小于或等于 (<=)

实现为 Null 性

除了正确指定程序集的属性外,类还必须支持为 Null 性。 加载到 UdtSQL Server是可识别 null 的但为了使 UDT 能够识别 null 值,该类必须实现INullable接口。 有关详细信息和如何在 UDT 中实现为 null 性的示例,请参阅类型。

字符串转换

若要支持字符串转换到和从 UDT,必须提供分析方法和一个ToString中您的类的方法。 分析方法允许将字符串转换为 UDT。 它必须声明为静态(或共享在 Visual Basic 中),并且采用的类型参数System.Data.SqlTypes.SqlString。 有关详细信息和如何实现的示例分析并ToString方法,请参阅类型。

XML 序列化

Udt 必须支持转换来回xml通过符合 XML 序列化协定的数据类型。 System.Xml.Serialization命名空间包含用于对象序列化为 XML 格式的文档或流的类。 您可以选择实施xml使用的序列化IXmlSerializable接口,以便进行 XML 序列化和反序列化提供自定义格式设置。

除了执行从 UDT 到的显式转换xml,XML 序列化使你能够:

  • 使用Xquery UDT 后的实例转换为值xml数据类型。

  • 在 SQL Server 的具有本机 XML Web 服务的参数化查询和 Web 方法中使用 UDT。

  • 使用 UDT 可以接收 XML 数据的大容量加载。

  • 序列化包含具有 UDT 列的表的数据集。

UDT 在 FOR XML 查询中不序列化。 若要执行显示 Udt 的 XML 序列化的 FOR XML 查询,显式转换为每个 UDT 列xml SELECT 语句中的数据类型。 可以显式转换到的列varbinary, varchar,或nvarchar。

请参阅

创建用户定义类型

历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 rothja)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站展开固定版本仓库内的引用内容,将 Markdown 转为 HTML,规范化链接,移除外部媒体、发布器占位标签和导航标记。

资料来源与适用范围

资料来源
Microsoft / SQL Server 中文文档历史快照
适用范围
历史中文快照 2018-11-30;详见原文产品版本;文档日期 03/16/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。