ObjectId.createFromHexString()
定义
从十六进制值创建 ObjectId 。
兼容性
此方法可用于以下环境中托管的部署:
MongoDB Atlas:用于云中 MongoDB 部署的完全托管服务
MongoDB Enterprise:基于订阅、自我管理的 MongoDB 版本
MongoDB Community:源代码可用、免费使用且可自行管理的 MongoDB 版本
语法
hexadecimalString
字段指定包含 24 个字符的十六进制值的字符串。 例如, "64c13ab08edf48a008793cac"
。
示例
以下示例展示了如何使用ObjectId.createFromHexString()
将ObjectId添加到文档中,以及ObjectId在检索时如何显示在输出中。
使用ObjectId创建包含文档的collection
以下示例创建了一个名为objectIdentifierValuesFromHex
的collection:
db.objectIdentifierValuesFromHex.insertOne( { _id: 0, objectIdentifierValue: ObjectId.createFromHexString( "64c13ab08edf48a008793cac" ) } )
objectIdentifierValue
字段包含从ObjectId.createFromHexString()
中指定的十六进制字符串创建的ObjectId。
使用ObjectId从collection中检索文档
以下示例检索文档:
db.objectIdentifierValuesFromHex.findOne( { _id: 0 } )
示例输出:
{ _id: 0, objectIdentifierValue: ObjectId("64c13ab08edf48a008793cac") }