ObjectId.createFromHexString()
Nesta página
Definição
Cria umObjectId a partir de um valor hexadecimal.
Compatibilidade
Esse método está disponível em implantações hospedadas nos seguintes ambientes:
MongoDB Atlas: o serviço totalmente gerenciado para implantações do MongoDB na nuvem
MongoDB Enterprise: a versão autogerenciada e baseada em assinatura do MongoDB
MongoDB Community: uma versão com código disponível, de uso gratuito e autogerenciada do MongoDB
Sintaxe
O campo hexadecimalString
especifica uma string que contém um valor hexadecimal de 24 caracteres. Por exemplo, "64c13ab08edf48a008793cac"
.
Exemplos
Os exemplos a seguir mostram como adicionar um identificador de objeto a um documento usando ObjectId.createFromHexString()
e como o identificador de objeto aparece na saída quando recuperado.
Criar documento contendo coleção com identificador de objeto
O exemplo a seguir cria uma collection chamada objectIdentifierValuesFromHex
:
db.objectIdentifierValuesFromHex.insertOne( { _id: 0, objectIdentifierValue: ObjectId.createFromHexString( "64c13ab08edf48a008793cac" ) } )
O campo objectIdentifierValue
contém o ObjectId criado a partir da string hexadecimal especificada em ObjectId.createFromHexString()
.
Recuperar documentos da coleção com o identificador de objeto
O exemplo a seguir recupera o documento:
db.objectIdentifierValuesFromHex.findOne( { _id: 0 } )
Saída de exemplo:
{ _id: 0, objectIdentifierValue: ObjectId("64c13ab08edf48a008793cac") }