System.Classes.TStringList.AddObject
Delphi
function AddObject(const S: string; AObject: TObject): Integer; override;
C++
virtual int __fastcall AddObject(const System::UnicodeString S, System::TObject* AObject);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStringList |
Beschreibung
Fügt der Liste einen String hinzu und ordnet dem String ein Objekt zu.
Mit AddObject fügen Sie der Liste einen String hinzu und ordnen dem String ein Objekt zu. AddObject gibt den Index des neuen String und des neuen Objekts zurück.
Hinweis: Wenn die Eigenschaft OwnsObjects False ist, ist das TStringList-Objekt kein Eigentümer der Objekte, die auf diese Weise hinzugefügt werden. Diese Objekte existieren weiter, auch wenn die TStringList-Instanz freigegeben wird. Sie müssen explizit von der Anwendung freigegeben werden. Um die Objekte automatisch beim Freigeben des TStringList-Objekts freizugeben, setzen Sie beim Erstellen des TStringList-Objekts OwnsObjects auf True oder verwenden Sie den Konstruktor Create, der den booleschen Parameter
OwnsObjectsübernimmt.
Hinweis: Wenn Sie versuchen, den String S durch einen Aufruf von AddObject zu einer sortierten Liste hinzuzufügen, die diesen String bereits enthält, wird eine EListError-Exception ausgelöst und die Eigenschaft Duplicates auf dupError gesetzt. Wenn Duplicates den Wert dupIgnore hat und versucht wird, ein Duplikat hinzuzufügen, gibt AddObject den Index des vorhandenen Eintrags zurück.