Class: DataRow

Source Location: /DataRow.php

Class Overview [line 22]


Die Klasse DataRow repräsentiert eine Zeile von Daten in einer DataTable

Author(s):

Version:

Copyright:

Variables

Constants

Methods


Inherited Variables

Inherited Constants

Inherited Methods



Class Details

Die Klasse DataRow repräsentiert eine Zeile von Daten in einer DataTable

Tags:

[ 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.
    Dieser Parameter ist optional, er wird nur bei Verwendung als set-Methode angegeben.

[ 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 ]


Class Methods


Documentation generated on Tue, 27 Jul 2004 21:15:33 +0200 by phpDocumentor 1.3.0RC3