Field-Objekt

Gilt für: Access 2013, Office 2013

Jedes Field-Objekt entspricht gewöhnlich einer Spalte in einer Datenbanktabelle. Ein Field-Objekt kann jedoch auch einen Zeiger auf ein anderes Recordset-Objekt darstellen, ein so genanntes Kapitel. Ausnahmen, wie z. B. Kapitelspalten, werden weiter unten in diesem Handbuch behandelt.

Verwenden Sie die Value -Eigenschaft von Field -Objekten, um Daten für den aktuellen Datensatz festzulegen oder zurückzugeben. In Abhängigkeit von der vom Anbieter unterstützten Funktionalität können bestimmte Auflistungen, Methoden oder Eigenschaften eines Field -Objekts nicht verfügbar sein.

Die Auflistungen, Methoden und Eigenschaften eines Field -Objekts ermöglichen Folgendes:

• Zurückgeben des Namens eines Felds mithilfe der Name -Eigenschaft.

• Anzeigen oder Ändern der Daten im Feld mithilfe der Value -Eigenschaft. Value ist die Standardeigenschaft des Field -Objekts.

• Zurückgeben der grundlegenden Merkmale eines Felds mithilfe der Eigenschaften Type, Precision und NumericScale.

• Zurückgeben der deklarierten Größe eines Felds mithilfe der DefinedSize -Eigenschaft.

• Zurückgeben der tatsächlichen Größe der Daten in einem bestimmten Feld mithilfe der ActualSize -Eigenschaft.

• Bestimmen der für ein bestimmtes Feld unterstützten Funktionalitätstypen mithilfe der Attributes -Eigenschaft und der Properties -Auflistung.

• Manipulate the values of fields containing long binary or long character data by using the AppendChunk and GetChunk methods.

• Auflösen von Diskrepanzen in Feldwerten während der Batchaktualisierung mithilfe der Eigenschaften OriginalValue und UnderlyingValue, falls der Anbieter Batchaktualisierungen unterstützt.

Beschreiben eines Felds

In den folgenden Themen werden Eigenschaften des Field-Objekts behandelt, die Informationen darstellen, die das Field -Objekt selbst beschreiben - also Metadaten zu dem Feld. Diese Informationen helfen bei der Bestimmung des Schemas des Recordset -Objekts. Zu diesen Eigenschaften zählen Type, DefinedSize, ActualSize, Name, NumericScale und Precision.

Ermitteln des Datentyps

Die Type -Eigenschaft gibt den Datentyp des Felds an. Die von ADO unterstützten Datentypkonstanten werden unter DataTypeEnum in der Referenz des ADO-Programmierers beschrieben.

Für numerische Gleitkomma-Datentypen wie z. B. adNumeric können Sie weitere Informationen abrufen. Die NumericScale-Eigenschaft gibt an, wie viele Stellen rechts des Dezimalzeichens zur Darstellung von Werten für das Field-Objekt verwendet werden. Die Precision-Eigenschaft gibt die maximale Anzahl von Stellen zur Darstellung von Werten für das Field-Objekt an.

Bestimmen der Feldgröße

Mithilfe der DefinedSize -Eigenschaft bestimmen Sie die Datenkapazität eines Field -Objekts.

Mithilfe der ActualSize -Eigenschaft geben Sie die tatsächliche Länge des Werts eines Field -Objekts zurück. Die ActualSize -Eigenschaft ist für alle Felder schreibgeschützt. Falls ADO die Länge des Werts für das Field -Objekt nicht bestimmen kann, wird adUnknown von der ActualSize -Eigenschaft zurückgegeben.

Die Eigenschaften DefinedSize und ActualSize haben unterschiedliche Verwendungszwecke. Angenommen, ein Field -Objekt mit dem deklarierten Typ adVarChar und einer DefinedSize -Eigenschaft von 50 enthält ein einzelnes Zeichen. Für die ActualSize -Eigenschaft wird als Wert die Länge in Bytes dieses Einzelzeichens zurückgegeben.

Bestimmen des Feldinhalts

Der Bezeichner der Spalte aus der Datenquelle wird durch die Name -Eigenschaft des Field -Objekts dargestellt. Mit der Value -Eigenschaft des Field -Objekts wird der tatsächliche Dateninhalt des Felds zurückgegeben oder festgelegt. Dies ist die Standardeigenschaft.

Um die Daten in einem Feld zu ändern, legen Sie die Value-Eigenschaft auf einen neuen Wert des richtigen Typs fest. Ihr Cursortyp muss Updates unterstützen, um den Inhalt eines Felds zu ändern. Die Datenbanküberprüfung erfolgt hier nicht im Batchmodus, sodass Sie beim Aufrufen von UpdateBatch in einem solchen Fall nach Fehlern suchen müssen. Einige Anbieter unterstützen auch die Eigenschaften UnderlyingValue und OriginalValue des ADO Field-Objekts, um Sie bei der Lösung von Konflikten zu unterstützen, wenn Sie versuchen, Batchupdates durchzuführen. Ausführliche Informationen zum Beheben solcher Konflikte finden Sie in Kapitel 4: Bearbeiten von Daten.

Hinweis

Recordset Field values cannot be set when appending new Fields to a Recordset. Rather, new Fields can be appended to a closed Recordset. Then the Recordset must be opened, and only then can values be assigned to these Fields.

Abrufen weiterer Feldinformationen

ADO-Objekte weisen zwei Arten von Eigenschaften auf, nämlich integrierte und dynamische Eigenschaften. Bisher wurden nur die integrierten Eigenschaften des Field -Objekts behandelt.

Integrierte Eigenschaften sind die Eigenschaften, die in ADO implementiert und sofort für jedes neue Objekt verfügbar sind, wobei die Syntax verwendet wird. Sie werden nicht als Property -Objekte in der Properties -Auflistung eines Objekts angezeigt.

Dynamische Eigenschaften werden durch den zugrunde liegenden Datenprovider definiert und in der Properties -Auflistung für das entsprechende ADO-Objekt angezeigt. Beispielsweise kann eine anbieterspezifische Eigenschaft kennzeichnen, ob Transaktionen oder Aktualisierungen von einem Recordset-Objekt unterstützt werden. Diese zusätzlichen Eigenschaften werden als Property-Objekte in der Properties-Auflistung dieses Recordset-Objekts angezeigt. Auf dynamische Eigenschaften kann nur über die Auflistung mit der Syntax MyObject.Properties(0) oder oder MyObject.Properties("Name") verwiesen werden.

Keiner der beiden Eigenschaftstypen kann gelöscht werden.

Ein dynamisches Property-Objekt weist vier integrierte Eigenschaften auf:

• Die Name-Eigenschaft ist eine Zeichenfolge zur Identifizierung der Eigenschaft.

• Die Type-Eigenschaft ist eine ganze Zahl zur Angabe des Datentyps der Eigenschaft.

• The Value property is a variant that contains the property setting. Value is the default property for a Property object.

• Die Attributes -Eigenschaft ist ein Wert vom Typ Long zur Angabe der Merkmale der anbieterspezifischen Eigenschaft.

Die Properties -Auflistung für das Field -Objekt enthält zusätzliche Metadaten zum Feld. Der Inhalt dieser Auflistung hängt vom Anbieter ab. Im folgenden Codebeispiel wird die Properties -Auflistung des Recordset -Beispielobjekts, das zu Beginn dieses Kapitels vorgestellt wurde, untersucht. Zunächst wird der Inhalt der Auflistung betrachtet. In diesem Code wird der OLE DB-Anbieter für SQL Server verwendet, weshalb die Properties -Auflistung relevante Informationen zu diesem Anbieter enthält.

 
'BeginFieldProps 
 Dim objProp As ADODB.Property 
 
 For intLoop = 0 To (objFields.Count - 1) 
 Debug.Print objFields.Item(intLoop).Name 
 
 For Each objProp In objFields(intLoop).Properties 
 Debug.Print vbTab & objProp.Name & " = " & objProp.Value 
 Next objProp 
 Next intLoop 
'EndFieldProps 

Umgang mit Binärdaten

Use the AppendChunk method on a Field object to fill it with long binary or character data. In situations where system memory is limited, you can use the AppendChunk method to manipulate long values in portions rather than in their entirety.

Wenn das adFldLong -Bit in der Attributes -Eigenschaft eines Field -Objekts auf True festgelegt ist, können Sie die AppendChunk -Methode für dieses Feld verwenden.

Der erste Aufruf von AppendChunk für ein Field -Objekt schreibt Daten in das Feld, wobei vorhandene Daten überschrieben werden. Bei nachfolgenden Aufrufen von AppendChunk wird an die vorhandenen Daten angefügt. Wenn Sie Daten an ein Feld anfügen und dann den Wert eines anderen Felds im aktuellen Datensatz festlegen oder lesen, geht ADO davon aus, dass Sie keine Daten mehr an das erste Feld anfügen möchten. Wenn Sie die AppendChunk -Methode erneut für das erste Feld aufrufen, interpretiert ADO den Aufruf als neuen AppendChunk -Vorgang und überschreibt die vorhandenen Daten. Durch den Zugriff auf Felder in anderen Recordset -Objekten, die keine Klone des ersten Recordset -Objekts sind, werden AppendChunk -Vorgänge nicht unterbrochen.

Use the GetChunk method on a Field object to retrieve part or all of its long binary or character data. In situations where system memory is limited, you can use the GetChunk method to manipulate long values in portions, rather than in their entirety.

Die beim Aufrufen von GetChunk zurückgegebenen Daten werden Variable zugewiesen. Ist Size größer als die restlichen Daten, gibt die GetChunk-Methode nur die restlichen Daten zurück, ohne Variable mit Leerzeichen aufzufüllen. Falls das Feld leer ist, gibt die GetChunk -Methode einen NULL-Wert zurück.

Mit jedem nachfolgenden Aufruf von GetChunk werden Daten ab dem Punkt abgerufen, an dem der vorherige Aufruf von GetChunk beendet wurde. Wenn Sie jedoch Daten aus einem Feld abrufen und dann den Wert eines anderen Felds im aktuellen Datensatz festlegen oder lesen, geht ADO davon aus, dass Sie keine Daten mehr aus dem ersten Feld abrufen möchten. Wenn Sie die GetChunk -Methode erneut für das erste Feld aufrufen, interpretiert ADO den Aufruf als neuen GetChunk -Vorgang und liest ausgehend vom Anfang der Daten. Durch den Zugriff auf Felder in anderen Recordset -Objekten, die keine Klone des ersten Recordset -Objekts sind, werden GetChunk -Vorgänge nicht unterbrochen.

Wenn das adFldLong -Bit in der Attributes -Eigenschaft eines Field -Objekts auf True festgelegt ist, können Sie die GetChunk -Methode für dieses Feld verwenden.

Der Fehler 3021 (kein aktueller Datensatz) wird generiert, falls kein aktueller Datensatz vorhanden ist, wenn Sie die Methode GetChunk oder AppendChunk für ein Field -Objekt verwenden.

Ein Beispiel für die Verwendung dieser Methoden zum Bearbeiten von Binärdaten finden Sie in den Beispielen AppendChunk-Methode und GetChunk-Methode in der ADO-Programmierreferenz.