New shared object

Home

4D v20 R7

New shared object


New shared object {( Eigenschaft ; Wert {; Eigenschaft2 ; Wert2 ; ... ; EigenschaftN ; WertN} )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
Eigenschaft	Text	Name der zu erstellenden Eigenschaft
Wert	Text, Datum, Boolean, Zeiger, Zahl, Objekt	Wert der Eigenschaft
Funktionsergebnis	Objekt	Neues shared object

Beschreibung

Die Funktion New shared object erstellt ein neues leeres oder vorab gefülltes shared object und gibt seine Referenz zurück. Ändern oder bearbeiten Sie dieses Objekt, muss es in die Struktur Use...End use eingebettet werden, sonst wird ein Fehler erzeugt. Es ist dagegen möglich, eine Eigenschaft ohne Struktur Use...End use zu lesen.

Hinweis: Weitere Informationen dazu finden Sie auf der Seite Shared Objects und Shared Collections.

Übergeben Sie keine Parameter, erstellt New shared object ein leeres Objekt und gibt seine Referenz zurück. Sie müssen diese Referenz einer 4D Variablen zuweisen, die mit dem Befehl _O_C_OBJECT deklariert wurde.

Hinweis: Beachten Sie, dass _O_C_OBJECT eine Variable vom Typ Objekt deklariert, aber kein Objekt erstellt.

Optional können Sie das neue Objekt vorab füllen, indem Sie ein oder mehrere Eigenschaft/Wert Paare als Parameter übergeben:

Im Parameter Eigenschaft übergeben Sie den Namen der zu erstellenden Eigenschaft (bis zu 255 Zeichen). Beachten Sie, dass Eigenschaft zwischen Groß- und Kleinschreibung unterscheidet.
Im Parameter Wert übergeben Sie den Wert, den Sie für die Eigenschaft setzen wollen. Für Shared objects werden Werte mit folgendem Typ unterstützt:
- Numerisch (Zahl, Lange Ganzzahl...) Zahlenwerte werden immer als Zahl gespeichert
- Text
- Boolean
- Datum
- Zeit (gespeichert als Anzahl Millisekunden - Zahl)
- Null
- shared object(*)
- shared collection(*)
Hinweis: Im Gegensatz zu standardmäßigen Objekten unterstützen shared objects weder Bilder oder Zeiger, noch not-shared objects/collections.

(*) Wird ein shared object/collection zu einem anderen shared object hinzugefügt, teilen sie sich denselben Sperrschlüssel. Weitere informationen dazu finden Sie im Abschnitt Sperrschlüssel (Locking Identifier) - Wie shared groups funktioniert.

Beispiel 1

Ein neues vorab gefülltes shared object erstellen:

 C_OBJECT($contact)

 $contact:=New shared object("name";"Smith";"firstname";"John")

Beispiel 2

Ein shared object erstellen und ändern. Dieses Objekt benötigt die Struktur :

 C_OBJECT($s_obj)

 $s_obj:=New shared object("prop1";"alpha")

 Use($s_obj)

    $s_obj.prop1:="omega"

 End use

Siehe auch

New object
New shared collection
Shared Objects und Shared Collections