FireDAC.Phys.MongoDBWrapper.TMongoCollection.Insert
Delphi
procedure Insert(ADocument: TMongoDocument; AFlags: TInsertFlags = []); overload;
procedure Insert(AInsert: TMongoInsert; AFlags: TInsertFlags = []); overload;
function Insert(AFlags: TInsertFlags = []): TMongoInsert; overload;
C++
void __fastcall Insert(TMongoDocument* ADocument, TInsertFlags AFlags = TInsertFlags() )/* overload */;
void __fastcall Insert(TMongoInsert* AInsert, TInsertFlags AFlags = TInsertFlags() )/* overload */;
TMongoInsert* __fastcall Insert(TInsertFlags AFlags = TInsertFlags() )/* overload */;
Inhaltsverzeichnis
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | FireDAC.Phys.MongoDBWrapper.pas FireDAC.Phys.MongoDBWrapper.hpp |
FireDAC.Phys.MongoDBWrapper | TMongoCollection |
Beschreibung
Fügt das angegebene Dokument in die Sammlung ein oder führt den angegebenen Einfüge-Generator für die Sammlung aus.
Für die Arbeit mit einem Einfüge-Generator unterstützt Insert zwei verschiedene Programmierstile.
Sie können optional eine Menge von Einfüge-Flags angeben.
Wenn der Einfüge-Befehl erfolgreich ist, können Sie die Anzahl der eingefügten Dokumente aus der Eigenschaft DocsInserted abrufen.
Wenn der Einfüge-Befehl fehlschlägt, wird eine Exception ausgelöst.
Mit Insert kann nur ein einzelnes Dokument eingefügt werden. Um in einer einzigen Operation mehrere Dokumente einzufügen, führen Sie die Insert-Aufrufe zwischen den Aufrufen von BeginBulk und EndBulk aus.
Beispiel
Das folgende Beispiel fügt ein neues Dokument ein.
MongDB-Shell:
db.restaurants.insert({
"name": "La Bella Italia",
"cuisine": "Italian",
"grades": [
{
"date": ISODate("2015-11-02T14:38:00Z"),
"grade": "A",
"score": 8
}
]
})
Delphi:
MyDocument := TMongoDocument.Create(MyConnection.Env)
.Add('name', 'La Bella Italia')
.Add('cuisine', 'Italian')
.BeginArray('grades')
.BeginObject('')
.Add('date', ISO8601ToDate('2015-11-02T14:38:00Z'))
.Add('grade', 'A')
.Add('score', 8)
.EndObject
.EndArray;
MyCollection.Insert(MyDocument);
MyDocument.Free;
C++:
TMongoDocument* MyDocument = new TMongoDocument(MyConnection->Env);
MyDocument
->Add("name", String("La Bella Italia"))
->Add("cuisine", String("Italian"))
->BeginArray("grades")
->BeginObject("")
->Add("date", ISO8601ToDate("2015-11-02T14:38:00Z"))
->Add("grade", String("A"))
->Add("score", 8)
->EndObject()
->EndArray();
MyCollection->Insert(MyDocument);
delete MyDocument;