文本字符串

ISequentialStream

适用于 SQL Server 的 OLE DB 驱动程序不包含 SAX 读取器，但 ISequentialStream 可在 MSXML 中轻松传递到 SAX 和 DOM 对象 。

ISequentialStream 须用于检索大型 XML 文档 。 用于其他大值类型的相同技术也适用于 XML。 有关详细信息，请参阅 使用大型数据类型 。

还可以通过常见接口（如 IRow::GetColumns、IRowChange::SetColumns 和 ICommand::Execute）检索、插入或更新行集中类型为 XML 的列中存储的数据 。 与检索情况类似，应用程序可将文本字符串或 ISequentialStream 传递给适用于 SQL Server 的 OLE DB 驱动程序 。

要通过 ISequentialStream 接口以字符串格式发送 XML 数据，必须通过指定 DBTYPE_IUNKNOWN 获取 ISequentialStream 并在绑定中将其 pObject 参数设置为 Null 。

当由于使用者缓冲区过小而导致已检索的 XML 数据被截断时，长度可能作为 0xffffffff 返回，这意味着长度为未知的。 此行为与将它实现为数据类型的行为一致，就是数据类型流式传输到客户端，但在实际数据之前不发送长度信息。 在某些情况下，如果提供程序已缓冲整个值（如 IRowset::GetData）且已执行数据转换，可能返回实际长度 。

服务器会将发送到 SQL Server 的 XML 数据视为二进制数据。 此行为防止发生任何转换并允许 XML 分析器自动检测 XML 编码。 这样，就可以接受更广泛的 XML 文档（例如，以 UTF-8 编码的文档）作为 SQL Server 的输入。

如果将输入 XML 绑定为 DBTYPE_WSTR，则应用程序必须确保已对其进行 Unicode 编码，以避免由于不必要的数据转换而可能导致损坏。

数据绑定和强制

下表描述将所列数据类型与 SQL Server xml 数据类型一同使用时出现的绑定和强制转换。

¹ 如果使用 ICommandWithParameters::SetParameterInfo 指定了除 DBTYPE_XML 以外的服务器类型，而取值函数类型为 DBTYPE_XML，那么就会在执行语句时出错（DB_E_ERRORSOCCURRED，参数状态为 DBSTATUS_E_BADACCESSOR）；否则，数据发送到服务器，但服务器会返回错误，指明不存在将 XML 转换为参数的数据类型的隐式转换。

² 超出本文的范围。

³ 格式为 UTF-16、无字节顺序标记 (BOM)、无编码规格，且无空终止。

⁴ 格式为 UTF-16、无 BOM、无编码规格，且空终止。

⁵ 格式为在客户端代码页中编码的带有空终止符的多字节字符。 从服务器提供的 Unicode 进行转换可能导致数据损坏，因此建议不要使用此绑定。

⁶ 可使用 BY_REF。

⁷ UTF-16 必须以 BOM 开头。 否则，服务器可能无法正确地识别编码。

⁸ 在创建取值函数时或在提取时，可能进行验证。 此错误为 DB_E_ERRORSOCCURRED，绑定状态设置为 DBBINDSTATUS_UNSUPPORTEDCONVERSION。

⁹ 使用客户端代码页将数据转换为 Unicode，然后发送到服务器。 如果文档编码与客户端代码页不匹配，则可能发生数据损坏，因此强烈建议不要使用此绑定。

¹⁰ 始终向发送到服务器的数据添加一个 BOM。 如果数据的开头已具有 BOM，则缓冲区的开头可能具有两个 BOM。 服务器使用第一个 BOM 将编码识别为 UTF-16，然后放弃它。 第二个 BOM 将被解释为零宽度不间断空格字符。

¹¹ 格式为 UTF-16、无编码规格，且向从服务器收到的数据添加一个 BOM。 如果服务器返回了空字符串，则仍将 BOM 返回给应用程序。 如果缓冲区长度的字节数为奇数，则正确截断数据。 如果分块区返回了整个值，则可将其进行连接，重新构建正确的值。

¹² 如果缓冲区长度少于两个字符（即空间不够，不能包含空终止），则报告溢出错误。

对于 NULL XML 值，不返回值。

XML 标准要求 UTF-16 编码的 XML，以便以字节顺序标记 (BOM) UTF-16 字符代码 0xFEFF 开头。 使用 WSTR 和 BSTR 绑定时，适用于 SQL Server 的 OLE DB 驱动程序不要求 BOM 或添加 BOM，因为绑定隐含了编码。 当使用 BYTES、XML 或 IUNKNOWN 绑定时，目的是为了在处理其他 XML 处理器和存储系统时提供简便性。 在此情况下，应向 UTF-16 编码的 XML 提供 BOM，并且应用程序无需关心实际编码，因为绝大多数的 XML 处理器（包括 SQL Server）会通过检查该值的前几个字节推导出编码。 对于使用 BYTES、XML 或 IUNKNOWN 绑定从适用于 SQL Server 的 OLE DB 驱动程序收到的 XML 数据，它们始终以 UTF-16 进行编码、带有 BOM 且未嵌入编码声明。

OLE DB 核心服务 (IDataConvert) 提供的数据转换不适用于 DBTYPE_XML 。

当向服务器发送数据时将执行验证。 应由应用程序处理客户端验证和编码更改。 建议不要直接处理 XML 数据，而应使用 DOM 或 SAX 读取器来处理该数据。

可绑定 DBTYPE_NULL 和 DBTYPE_EMPTY 用于输入参数，但不能用于输出参数或结果。 当将它们绑定用于输入参数时，状态必须设置为 DBSTATUS_S_ISNULL 或 DBSTATUS_S_DEFAULT。

可以将 DBTYPE_XML 转换为 DBTYPE_EMPTY 和 DBTYPE_NULL，并可以将 DBTYPE_EMPTY 转换为 DBTYPE_XML，但无法将 DBTYPE_NULL 转换为 DBTYPE_XML。 这与 DBTYPE_WSTR 相一致。

DBTYPE_IUNKNOWN 是支持的绑定（如上表中所示），但在 DBTYPE_XML 与 DBTYPE_IUNKNOWN 之间不存在转换。 DBTYPE_IUNKNOWN 不能与 DBTYPE_BYREF 一起使用。

OLE DB 行集的添加和更改内容

OLE DB Driver for SQL Server 在许多核心 OLE DB 架构行集中添加了新值或进行了更改。

COLUMNS 和 PROCEDURE_PARAMETERS 架构行集

在 COLUMNS 和 PROCEDURE_PARAMETERS 架构行集添加了以下列：

PROVIDER_TYPES 架构行集

在 PROVIDER_TYPES 架构行集中，xml 数据类型的 COLUMN_SIZE 值为 0，且 DATA_TYPE 为 DBTYPE_XML 。

SS_XMLSCHEMA 架构行集

所引入的新的架构行集 SS_XMLSCHEMA 可供客户端检索 XML 架构信息。 SS_XMLSCHEMA 行集包含以下列：

OLE DB 属性集的添加和更改内容

OLE DB Driver for SQL Server 在许多核心 OLE DB 属性集中添加了新值或进行了更改。

DBPROPSET_SQLSERVERPARAMETER 属性集

为通过 OLE DB 支持 xml 数据类型，适用于 SQL Server 的 OLE DB 驱动程序实现了新的 DBPROPSET_SQLSERVERPARAMETER 属性集，它包含下列值 。

DBPROPSET_SQLSERVERCOLUMN 属性集

为支持在 ITableDefinition 接口中创建表，适用于 SQL Server 的 OLE DB 驱动程序向 DBPROPSET_SQLSERVERCOLUMN 属性集添加三个新列 。

与 SSPROP_PARAM 值类似，所有这些属性都是可选的且默认值为空。 仅当指定 SSPROP_COL_XML_SCHEMACOLLECTIONNAME 时，才能指定 SSPROP_COL_XML_SCHEMACOLLECTION_CATALOGNAME 和 SSPROP_COL_XML_SCHEMACOLLECTION_SCHEMANAME。 在将 XML 传递到服务器时，如果包含这些值，则将针对当前数据库检查它们是否存在（有效性），并且针对架构检查实例数据。 在所有情况下，要使这些值有效，它们必须全部为空或全部添入这些值。

OLE DB 接口的添加和更改内容

OLE DB Driver for SQL Server 在许多核心 OLE DB 接口中添加了新值或进行了更改。

ISSCommandWithParameters 接口

为通过 OLE DB 支持 xml 数据类型，适用于 SQL Server 的 OLE DB 驱动程序实现了大量更改，包括添加 ISSCommandWithParameters 接口。 这一新接口继承自核心 OLE DB 接口 ICommandWithParameters 。 除了从 ICommandWithParameters 继承的三个方法（GetParameterInfo、MapParameterNames 和 SetParameterInfo），ISSCommandWithParameters 还提供 GetParameterProperties 和 SetParameterProperties 方法，它们用于处理服务器特定的数据类型。

ISSCommandWithParameters 接口也利用新的 SSPARAMPROPS 结构 。

IColumnsRowset 接口

适用于 SQL Server 的 OLE DB 驱动程序在 IColumnRowset::GetColumnsRowset 方法返回的行集中添加 SQL Server 特定的如下列 。 这些列包含 XML 架构集合的由三个部分组成的名称。 对于非 XML 列或非类型化 XML 列，所有这三列均取默认值 NULL。

IRowset 接口

通过 IRowset::GetData 方法检索 XML 列中的 XML 实例 。 根据由客户端指定的绑定，可以将 XML 实例作为 DBTYPE_BSTR、DBTYPE_WSTR、DBTYPE_VARIANT、DBTYPE_XML、DBTYPE_STR、DBTYPE_BYTES 进行检索，或者通过 DBTYPE_IUNKNOWN 将其作为接口检索。 如果使用者指定 DBTYPE_BSTR、DBTYPE_WSTR 或 DBTYPE_VARIANT，则访问接口将 XML 实例转换为用户请求的类型，并将其放入在相应绑定中指定的位置。

如果使用者指定 DBTYPE_IUNKNOWN 并将 pObject 参数设置为 NULL，或将 pObject 参数设置为 IID_ISequentialStream，则提供程序将 ISequentialStream 接口返回到使用者，让其可流式处理该列之外的 XML 数据 。 然后，ISequentialStream 将 XML 数据作为 Unicode 字符流返回 。

当返回与 DBTYPE_IUNKNOWN 绑定的 XML 值时，访问接口将报告 sizeof (IUnknown *) 的大小值。 此行为与在将某列绑定为 DBTYPE_IUnknown 或 DBTYPE_IDISPATCH 时采用的方法，以及无法确定实际列大小时 DBTYPE_IUNKNOWN/ISequentialStream 采用的方式一致。

IRowsetChange 接口

使用者可以通过两种方法更新列中的 XML 实例。 第一种方法是使用提供程序创建的存储对象 ISequentialStream 。 使用者可调用 ISequentialStream::Write 方法直接更新提供程序返回的 XML 实例 。

第二种方法是通过 IRowsetChange::SetData 或 IRowsetChange::InsertRow 方法 。 使用这种方法，可以在类型为 DBTYPE_BSTR、DBTYPE_WSTR、DBTYPE_VARIANT、DBTYPE_XML 或 DBTYPE_IUNKNOWN 的绑定中，指定使用者缓冲区内的 XML 实例。

如果指定 DBTYPE_BSTR、DBTYPE_WSTR 或 DBTYPE_VARIANT，则提供程序将在适当的列中存储使用者缓冲区中的 XML 实例存储。

如果指定 DBTYPE_IUNKNOWN/ISequentialStream，且使用者未指定任何存储对象，则使用者必须提前创建 ISequentialStream 对象，将 XML 文档与此对象绑定，然后通过 IRowsetChange::SetData 方法将此对象传递给提供程序 。 使用者还可以创建存储对象，将 pObject 参数设置为 IID_ISequentialStream，创建 ISequentialStream 对象，然后将 ISequentialStream 对象传递给 IRowsetChange::SetData 方法 。 在这两种情况下，提供程序都可以通过 ISequentialStream 对象检索 XML 对象，然后将其插入适当的列中 。

IRowsetUpdate 接口

IRowsetUpdate 接口提供了用于延迟更新的功能 。 在使用者调用 IRowsetUpdate::Update 方法之前，供行集使用的数据不可用于其他事务 。

IRowsetFind 接口

IRowsetFind::FindNextRow 方法不使用 xml 数据类型 。 调用 IRowsetFind::FindNextRow 且 hAccessor 参数指定 DBTYPE_XML 列时，返回 DB_E_BADBINDINFO 。 此时不考虑正在搜索的列的类型。 对于任何其他绑定类型，如果要搜索的列属于 xml 数据类型，则 FindNextRow 将失败并返回 DB_E_BADCOMPAREOP 。

适用于 SQL Server 的 OLE DB 驱动程序功能
ISSCommandWithParameters (OLE DB)