Inherited Variables
Inherited Constants
Inherited Methods
Class Details
Die Klasse DataRow repräsentiert eine Zeile von Daten in einer DataTable
Tags:
- since - 20.05.2004
- author - Andreas Kräling <akraeling@t-online.de>;
[ Top ]
Class Variables
$bRowState = false
[line 97]
Zum Überprüfen, ob diese DataRow Bestandteil einer DataTable ist
Der Wert false zeigt an, dass die DataRow unabhängig von einer ist, d.i. nicht zur DataRowCollection irgendeiner DataTable gehört. Das entspricht DataRowState::Detached im Microsoft .NET Framework. Der Wert true zeigt an, dass die DataRow zur DataRowCollection einer DataTable gehört. get/set-Methode dieses Attributs: rowState.
Tags:
- access - private
Type: boolean
Overrides:
[ Top ]
$ItemArray = array()
[line 129]
Zum Speichern von Werten der Row in einem Array
get/set-Methoden zu diesem Attribut: itemArray und item. Für jede Spalte des Schemas dieser DataRow wird ein Wert gespeichert. Die Struktur dieses Arrays richtet sich deshalb nach der des Schemas: ein numerisch indiziertes Array (vgl. Dokumentation zu DataTable::columns()).
Das Schema einer DataRow ist das Schema der DataTable, auf die eine DataRow verweist und ist auch nur so (d.h. über table) zu erreichen.
Tags:
- access - private
Type: mixed
Overrides:
[ Top ]
$signalQ = array()
[line 60]
Type: mixed
Overrides:
[ Top ]
$Table =
[line 71]
Zum Verweisen auf die Tabelle zu der die Row gehört
get/set-Methode dieses Attributs: table.
Tags:
- access - private
Type: mixed
Overrides:
[ Top ]
Class Methods
DataRow
Eine DataRow(
DataTable
&$table, [mixed[]
$values = null])
[line 46]
initialisiert eine Instanz eines DataRow-Objektes
Der Konstruktor muss die Aufgabe des Konstruktors DataRow(DataRowBuilder builder) aus dem MS .NET-Framework nachbilden, jedoch ohne die hier nicht implementierte Klasse DataRowBuilder. Daher die abweichende Parameterverwendung gegenüber dem MS .NET-Vorbild.
Jede DataRow hat einen Verweis auf genau eine DataTable, deren Schema sie besitzt. Dieses Schema (in Form einer Kollektion von DataColumns) kann auch nur über diesen Verweis auf die Tabelle erreicht werden. Der Verweis auf eine DataTable bedeutet nun nicht, dass jede DataRow in einer DataTable enthalten sein muss - das kann über das Attribut RowState beeinflusst werden.
Tags:
- return - neue Instanz von DataRow oder, wenn während der Konstruktorausführung Exceptions auftraten, der null-Wert.
- access - private
Parameters:
- DataTable $table - Eine Referenz auf die DataTable, deren Schema die DataRow hat.
- mixed[] $values - Ein Feld von Werten in Reihenfolge der Spalten, das die Werte für diese DataRow bereitstellt. Es können dieselben Exceptions wie bei itemArray auftreten. Optional. Fehlt dieser Parameter, wird eine DataRow nur mit einem Schema, aber ohne Werte erzeugt.
[ Top ]
Equals
boolean Equals(
object
$candidate)
[line 246]
Bestimmt, ob diese Instanz von DataRow gleich einem übergebenen Objekt ist.
Zwei Objekte sind gleich, wenn sie Instanzen derselben Klasse sind und denselben Zustand (d.i. die Belegung ihrer Attribute) haben.
Tags:
- return - true, wenn diese Instanz von DataRow gleich dem übergebenen Objekt ist, andernfalls false.
- access - public
Parameters:
- object $candidate - Objekt, für das bestimmt werden soll ob es gleich dieser Instanz von DataRow ist.
[ Top ]
item
Der item(
mixed
$concernedColumnId, [mixed
$value = null], mixed
$concernedColumnName)
[line 148]
Ruft den Inhalt einer angegebenen Spalte ab oder legt diesen fest.
get/set-Methode des Attributs ItemArray.
Tags:
- return - aktuelle Wert der durch den Parameter $column ausgewählten Spalte. Wurde die Methode als set-Methode verwendet, so ist dies der neue Wert, den diese Spalte angenommen hat.
- access - public
Parameters:
- mixed $concernedColumnName - Die Spalte, deren Inhalt ausgelesen oder gesetzt werden soll. Dieser Parameter kann ein String sein (um die DataColumn nach ihrem Namen auszuwählen), ein Integer sein (um die DataColumn nach ihrer Position auszuwählen; die erste Spalte ist an Position 0) oder ein DataColumn-Objekt sein (um die Spalte durch Angabe eines gleichen Objektes auszuwählen).
- mixed $value - Der Wert, auf den die Spalte gesetzt werden soll. Optional, nur bei Verwendung als set-Methode nötig.
[ Top ]
itemArray
void itemArray(
[mixed[]
$newItemArray = null], object[]
$signalQueue)
[line 211]
Ruft alle Werte für diese Zeile über ein Array ab oder legt diese fest.
get/set-Methode des Attributs ItemArray. Während item nur den Wert einer Spalte dieses Attributs ermittelt oder setzt, führt diese Methode das stets für das gesamte Attribut durch. Das bedeutet, der Parameter $newItemArray wird stets als vollständiges Array aufgefasst: fehlende Schlüssel/Wert-Paare werden ergänzt, indem fortlaufende numerische Indizes als Schlüssel und null als Wert verwendet wird.
Um in eine DataColumn ihren DataColumn::DefaultValue einzutragen, übergebe man null. Wenn das Attribut DataColumn::AutoIncrement true ist, übergebe man ebenfalls null und erhält so autoinkementierte Werte in dieser Spalte.
Tags:
- todo - Deklaration und Implementierung der hier zum Argument $signalQueue beschriebenen Exception-Klassen.
- access - public
Parameters:
- mixed[] $newItemArray - Das numerisch indizierte Array von Werten, das das Attribut ItemArray als Wert annehmen soll. Dieser Parameter ist optional, er wird nur bei Verwendung als set-Methode angegeben.
-
object[]
$signalQueue
-
Warteschlange, in die itemArray ggf. eine oder mehrere der folgenden Exceptions einfügt:
- ArgumentException, wenn das übergebene Array $values größer ist als die Anzahl der Spalten in der DataTable, zu der diese DataRow gehört.
- InvalidCastException, wenn ein Wert des übergebenen Arrays $values inkompatibel mit dem Typ der entsprechenden Spalte dieser DataRow ist.
- ReadOnlyException, wenn versucht wurde, einen Wert in eine Spalte zu schreiben, deren Attribut DataColumn::ReadOnly true ist.
- NoNullAllowedException, wenn versucht wurde, SQL-NULL in eine Spalte zu schreiben, deren Attribut DataColumn::AllowDBNull false ist.
[ Top ]
rowState
void rowState(
[mixed
$bRowState = null])
[line 106]
Überprüft, ob diese DataRow Bestandteil einer DataTable ist
get/set-Methode des Attributs bRowState.
Tags:
- access - public
Parameters:
[ Top ]
table
void table(
)
[line 81]
Die DataTable, zu der diese Zeile gehört
get-Methode des Attributs Table.
Tags:
- access - public
Parameters:
[ Top ]