DBSETPROP( )-Funktion

Stellt eine Eigenschaft der aktuellen Datenbank oder von Feldern, benannten Verbindungen, Tabellen oder Sichten (Ansichten) der aktuellen Datenbank ein.

DBSETPROP(cName, cType, cProperty, ePropertyValue)

Rückgabewerte

Logisch

Parameter

• cName
  Gibt den Namen der momentan geöffneten Datenbank, des Feldes, der benannten Verbindung, der Tabelle oder der Sicht in der momentan geöffneten Datenbank an, für die DBGETPROP( ) Informationen zurückgibt.

  Wenn Sie eine Eigenschaft eines Feldes in einer Tabelle oder einer Sicht einstellen möchten, müssen Sie dem Namen des Feldes den Namen der Tabelle oder der Sicht voranstellen, die das Feld enthält. Zum Festlegen einer Eigenschaft für das Feld custid in der Tabelle customer geben Sie Folgendes für cName ein:

  customer.custid
  

• cType
  Gibt an, ob es sich bei cName um die aktuelle Datenbank oder ein Feld, eine benannte Verbindung, eine Tabelle oder eine Sicht in der aktuellen Datenbank handelt.

  In der folgenden Tabelle sind die Werte aufgeführt, die Sie für cType angeben können.

  cType	Beschreibung
  CONNECTION	cName ist eine benannte Verbindung in der aktuellen Datenbank.
  DATABASE	cName ist die aktuelle Datenbank.
  FIELD	cName ist ein Feld in der aktuellen Datenbank.
  TABLE	cName ist eine Tabelle in der aktuellen Datenbank.
  VIEW	cName ist eine Sicht in der aktuellen Datenbank.

• cProperty
  Gibt die Bezeichnung der einzustellenden Eigenschaft an. Ist eine Eigenschaft schreibgeschützt, kann ihr Wert mit DBSETPROP( ) nicht geändert werden. Wenn Sie versuchen, eine schreibgeschützte Eigenschaft zu ändern, zeigt Visual FoxPro eine Fehlermeldung an.

  Weitere Informationen zu Eigenschaften, die mit cProperty angegeben werden können, einschließlich ihrer Datentypen, finden Sie unter DBGETPROP( ).

• ePropertyValue
  Gibt den Wert an, auf den cProperty eingestellt wird. ePropertyValue muss von demselben Datentyp sein wie die Eigenschaft.

  Vorsicht   Visual FoxPro überprüft nicht, ob der angegebene Wert für die Eigenschaft zulässig ist. Es ist deshalb möglich, mit DBSETPROP( ) eine Eigenschaft auf einen unzulässigen Wert einzustellen. Sie können z. B. mit DBSETPROP( ) als feldbezogene Gültigkeitsregel einen Ausdruck festlegen, der für das jeweilige Feld nicht zulässig ist, ohne dass Visual FoxPro einen Fehler erzeugt. Um einen Fehler beim Festlegen der Tables-Eigenschaft für eine Sicht zu vermeiden, sollten Sie entsprechend der folgenden Syntax vor ePropertyValue die Datenbankbezeichnung setzen:

         <databaseName>!ePropertyValue

Hinweise

Mit DBSETPROP( ) legen Sie Eigenschaften der aktuellen Datenbank oder von Feldern, benannten Verbindungen, Tabellen oder Sichten in der aktuellen Datenbank fest. Verwenden Sie DBGETPROP( ), um die aktuellen Werte der Eigenschaften zu ermitteln.

DBSETPROP( ) gibt den Wert Wahr (.T.) zurück, wenn Visual FoxPro die angegebene Eigenschaft erfolgreich einstellt. Visual FoxPro erzeugt einen Fehler, wenn die angegebene Eigenschaft nicht eingestellt werden kann.

Weitere Informationen zu den Eigenschaften, die für Verbindungen, Datenbanken, Felder, Tabellen und Sichten abgerufen werden können, finden Sie in den in der folgenden Tabelle aufgelisteten Themen.

Informationen zu	Finden Sie unter	Im Abschnitt
Datenbankeigenschaften	Anzeigen und Festlegen von Datenbankeigenschaften	Erstellen von Datenbanken
Verbindungen	Zugreifen auf Remotedaten	Erstellung von Ansichten
Ansichten		Erstellung von Ansichten
Trigger	Verwendung von Triggern	Funktionsweise von Tabellen
Beschriftungen	Steuern der Anzeige von Feldern	Funktionsweise von Tabellen
Standardwerte	Erstellen von Standardfeldwerten	Funktionsweise von Tabellen
	Festlegen von Standardwerten für die Felder einer Ansicht	Erstellung von Ansichten
Kommentar	"Hinzufügen von Kommentaren zu Feldern" unter Auswählen von Datentypen	Funktionsweise von Tabellen
	Anzeigen und Festlegen von Datenbankeigenschaften	Erstellen von Datenbanken
Primärschlüssel	Steuern von Duplikatwerten	Funktionsweise von Tabellen
Regeln	Erzwingen von Geschäftsregeln	Funktionsweise von Tabellen
	Festlegen oder Ändern von Gültigkeitsregeln auf Feld- oder Datensatzebene	Funktionsweise von Tabellen
	Erstellen von Regeln für Felder und Datensätze einer Ansicht	Erstellung von Ansichten

Beispiel

Im folgenden Beispiel wird DBSETPROP( ) zum Angeben eines Kommentars für das Feld cust_id in der Tabelle customer verwendet Der Kommentar wird anschließend mit DBGETPROP( ) angezeigt.

CLOSE DATABASES
CLEAR

OPEN DATABASE (HOME(2) + 'data\testdata')
USE customer     && Open customer table

= DBSETPROP("customer.cust_id", "Field", "Comment", ;
  "Property has been set by DBSETPROP.")  && New field comments

cRESULTS = DBGETPROP("customer.cust_id", "Field", "Comment")
WAIT WINDOW "Cust_id field comments: "+ cRESULTS  && Display comments

Siehe auch

ADD TABLE | CREATE DATABASE | CURSORGETPROP( ) | CURSORSETPROP( ) | DBGETPROP( ) | DISPLAY DATABASE | LIST DATABASE | OPEN DATABASE | SQLCOMMIT( ) | SQLROLLBACK( )