每个字段对象通常对应于数据库表中的列。 但是,字段还表示到另一个指针记录集,名为一章。 将在本指南的后面介绍异常,如章节列。
使用值的属性字段对象设置或返回当前记录的数据。 根据的功能提供程序用于公开,一些集合、 方法或属性的字段对象可能不可用。
使用集合、 方法和属性的字段对象,您可以执行以下操作:
-
通过使用返回的字段名称名称属性。
-
查看或更改字段中的数据通过使用值属性。 值是默认属性字段对象。
-
通过使用返回的字段的基本特征类型,精度,并NumericScale属性。
-
通过使用返回的字段声明的大小DefinedSize属性。
-
使用给定字段中返回数据的实际大小ActualSize属性。
-
确定给定字段的使用支持哪些类型的功能特性属性和属性集合。
-
操作通过使用包含长度的二进制或长字符数据字段的值AppendChunk并GetChunk方法。
解决使用批更新过程中的字段值中的差异OriginalValue并UnderlyingValue属性,如果提供程序支持批更新。
描述字段
按照将的主题讨论的属性字段对象,它表示描述的信息字段对象本身 — 即,有关该字段的元数据。 此信息可以用于确定许多有关的架构记录集。 这些属性包括类型, DefinedSize并ActualSize,名称,和NumericScale并精度。
发现的数据类型
类型属性指示该字段的数据类型。 中介绍了支持的 ADO 枚举的常量的数据类型DataTypeEnum中ADO 程序员参考。
为浮点型数值类型等adNumeric,可以获取详细信息。 NumericScale属性指示用于代表的值小数点右侧的位数字段。 精度属性指定用于表示值的最大位数字段。
确定字段大小
使用DefinedSize属性来确定的数据容量字段对象。
使用ActualSize属性返回的实际长度字段对象的值。 为所有字段ActualSize属性是只读的。 如果 ADO 无法确定的长度字段对象的值ActualSize属性返回adUnknown。
DefinedSize并ActualSize属性具有不同的用途。 例如,考虑字段对象的声明的类型adVarChar和一个DefinedSize属性值为 50,包含单个字符。 ActualSize它将返回的属性值是单个字符的长度以字节为单位。
确定字段内容
表示数据源的列的标识符名称的属性字段。 值的属性字段对象返回或设置字段的实际数据内容。 这是默认属性。
若要更改一个字段中的数据,请设置值属性等于正确类型的新值。 游标类型必须支持更新,才能更改字段的内容。 数据库验证不是此处在批处理模式下,因此将需要检查是否有错误时调用UpdateBatch这种情况。 某些提供程序还支持 ADO字段对象的UnderlyingValue并OriginalValue属性可帮助您进行时尝试解决冲突执行批处理更新。 有关如何解决此类冲突的详细信息,请参阅编辑数据。
Note: 记录集字段值不能设置新追加字段到记录集。 相反,新字段可将其附加到已关闭记录集。 然后记录集必须是已打开,并仅然后可以将值分配给这些字段。
获取字段的详细信息
ADO 对象具有两种类型的属性: 内置和动态。 到目前为止的内置属性仅字段讨论了对象。
内置属性是这些属性在 ADO 中实现,并立即可用于任何新对象,请使用MyObject.Property语法。 它们不显示为属性对象中的对象属性集合。
动态属性定义的基础数据提供程序,并且显示在属性为适当的 ADO 对象的集合。 例如,可能表示特定于提供程序的属性,如果记录集对象支持的事务或更新。 这些附加属性将显示为属性对象中的记录集对象的属性集合。 动态属性可以引用仅遍历该集合,使用语法MyObject.Properties(0)或MyObject.Properties("Name")。
不能删除这两种属性。
动态属性对象都有其自己的四个内置属性:
-
名称属性是一个字符串,标识的属性。
-
类型属性是一个整数,指定属性数据类型。
-
值属性是变体,其中包含属性设置。 值是默认属性属性对象。
-
特性属性是长值,该值指示属性特定于提供程序的特征。
属性集合字段对象包含有关字段的其他元数据。 此集合的内容因提供程序而异。 下面的代码示例将检查属性的示例集合记录集引入了在本部分的开头。 它首先会查看集合的内容。 此代码使用OLE DB Provider for SQL Server,因此属性集合包含与该提供程序相关的信息。
'BeginFieldProps
Dim objProp As ADODB.Property
For intLoop = 0 To (objFields.Count - 1)
Debug.Print objFields.Item(intLoop).Name
For Each objProp In objFields(intLoop).Properties
Debug.Print vbTab & objProp.Name & " = " & objProp.Value
Next objProp
Next intLoop
'EndFieldProps
处理二进制数据
使用AppendChunk方法字段要用长二进制或字符数据填充对象。 在系统内存有限的情况下,你可以使用AppendChunk方法来操作部分而不是很长的值。
如果adFldLong位特性属性字段对象设置为True,可以使用AppendChunk为该字段的方法。
第一个AppendChunk上调用字段对象将数据写入到字段中,覆盖任何现有数据。 后续AppendChunk调用添加到现有数据。 如果将数据追加到的一个字段,然后设置或读取的当前记录中的另一个字段的值,ADO 将假定您已完成了将数据追加到第一个字段。 如果您调用AppendChunk同样,第一个字段 ADO 方法将解释为一个新的调用AppendChunk操作,并覆盖现有数据。 访问其他字段记录集不是第一个克隆的对象记录集对象不会破坏AppendChunk操作。
使用GetChunk方法字段要检索其长二进制或字符数据的部分或全部对象。 在系统内存有限的情况下,你可以使用GetChunk方法来操作部分,而不是很长的值。
数据的GetChunk调用返回分配给变量。 如果大小大于剩余数据GetChunk方法仅返回的其余数据而无需填充变量具有空白空间。 如果该字段为空, GetChunk方法将返回 null 值。
每个后续GetChunk调用会检索数据从何处开始以前GetChunk离开的调用。 但是,如果从一个字段中检索数据和设置或读取的当前记录中的另一个字段的值,ADO 假定你已完成从第一个字段中检索数据。 如果您调用GetChunk同样,第一个字段 ADO 方法将解释为一个新的调用GetChunk操作并开始读取数据的起始位置。 访问其他字段记录集不是第一个克隆的对象记录集对象不会破坏GetChunk操作。
如果adFldLong位特性属性字段对象设置为True,可以使用GetChunk为该字段的方法。
如果没有最新记录时使用GetChunk或AppendChunk方法字段对象时,会发生错误 3021 (最新记录)。
有关使用这些方法来处理二进制数据的示例,请参阅AppendChunk 方法并GetChunk 方法中的示例ADO 程序员参考。
历史资料。此文对应 2018-11-30 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 MightyPen)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
