
	Version 6.3.8 für Windows	SUCHEN INHALT \| PDF-SEITE PDF-BÜCHER \| HOME HOCH ZURÜCK VOR

— Statements —

CREATE OBJECT

`CREATE OBJECT` `operand1` `OF` [`CLASS`] `operand2`
[`ON` [`NODE`] `operand3`]
[`GIVING` `operand4`]

Dieses Dokument behandelt folgende Themen:

Funktion
Syntax-Beschreibung

Eine Erläuterung der in dem Syntax-Diagramm verwendeten Symbole entnehmen Sie dem Abschnitt Syntax-Symbole.

Verwandte Statements: DEFINE CLASS | INTERFACE | METHOD | PROPERTY | SEND METHOD

Gehört zur Funktionsgruppe: Komponenten-basierte Anwendungen erstellen

Funktion

Das Statement CREATE OBJECT dient zum Erstellen einer Instanz einer Klasse.

Wenn ein CREATE OBJECT-Statement auf Windows-Plattformen ausgeführt wird, prüft Natural, ob der Name der in dem Statement angegebenen Klasse als DCOM-Klasse registriert ist. Falls dies der Fall ist, wird das Objekt mittels DCOM erstellt. Andernfalls sucht Natural in der aktuellen Library oder in den Steplibs nach einer Klasse dieses Namens und erstellt das Objekt lokal.

Syntax-Beschreibung

Operanden-Definitionstabelle:

Operand	Mögliche Struktur			Mögliche Formate			Referenzierung erlaubt	Dynam. Definition
`operand1`		S				O	nein	nein
`operand2`	C	S		A			ja	nein
`operand3`	C	S		A			ja	nein
`operand4`		S	N		I		ja	nein

Syntax-Element-Beschreibung:

`operand1`	Objekt-Handle: `operand1` muss als Objekt-Handle (`HANDLE OF OBJECT`) definiert sein. Die Objekt-Handle wird gefüllt, wenn das Objekt erfolgreich erstellt wurde. Wenn `operand1` nicht erfolgreich zurückgegeben wird, enthält er den Wert `NULL-HANDLE`.
OF CLASS `operand2`	Klassen-Name: `operand2` ist der Name der Klasse, für die das Objekt erstellt werden soll. Bei Klassen, die nicht als DCOM-Klassen registriert sind, muss er den im `DEFINE CLASS`-Statement definierten Klassen-Namen enthalten. Bei Klassen, die registriert sind, muss er entweder die `ProgID` der Klasse oder die Klasse `GUID` enthalten. Bei als DCOM registrierten Natural-Klassen entspricht die `ProgID` dem im `DEFINE CLASS`-Statement angegebenen Klassen-Namen. Weitere Informationen entnehmen Sie dem Unterabschnitt Registration with Natural im Abschnitt Distributing Object-based Natural Applications (siehe NaturalX im Leitfaden zur Programmierung). CREATE OBJECT #O1 OF CLASS "Employee" or CREATE OBJECT #O1 OF CLASS "653BCFE0-84DA-11D0-BEB3-10005A66D231"
ON NODE `operand3`	Node: Als `operand3` geben Sie den Node an, unter dem das Objekt erstellt wird. Dies ist nur dann möglich, wenn die Klasse eine registrierte DCOM-Klasse ist. Wenn Sie die Node-Klausel verwenden, versucht Natural, das Objekt unter diesem Node zu erstellen. Wenn Sie die Node-Klausel nicht verwenden oder wenn diese einen leeren Wert enthält, wird das Objekt unter dem Node erstellt, der für diese Klasse in der System Registry unter dem Schlüssel `RemoteServerName` erstellt. Wird der Registry-Schlüssel nicht angegeben, wird das Objekt in der lokalen Natural-Session erstellt. Zum Beispiel: CREATE OBJECT #O1 OF CLASS "Employee" ON NODE "volcano.iceland.com"
GIVING `operand4`	GIVING-Klausel: Wenn die `GIVING`-Klausel angegeben wird, enthält `operand4` entweder die Natural-Meldungsnummer, falls ein Fehler auftritt, oder Null bei fehlerfreier Ausführung. Wenn die `GIVING`-Klausel nicht angegeben wird, wird die Natural-Laufzeitfehlerverarbeitung ausgelöst, falls ein Fehler auftritt.

SUCHEN INHALT | PDF-SEITE PDF-BÜCHER | HOME HOCH ZURÜCK VOR