QSqlRecord Class Reference · PyQt4 中文文檔

# QSqlRecord Class Reference ## [[QtSql](index.htm) module] 該QSqlRecord類封裝了數據庫記錄。[More...](#details) 通過繼承[QSqlIndex](qsqlindex.html)。 ### Methods * `__init__ (self)` * `__init__ (self, QSqlRecord?other)` * `append (self, QSqlField?field)` * `clear (self)` * `clearValues (self)` * `bool contains (self, QString?name)` * `int count (self)` * `QSqlField field (self, int?i)` * `QSqlField field (self, QString?name)` * `QString fieldName (self, int?i)` * `int indexOf (self, QString?name)` * `insert (self, int?pos, QSqlField?field)` * `bool isEmpty (self)` * `bool isGenerated (self, int?i)` * `bool isGenerated (self, QString?name)` * `bool isNull (self, int?i)` * `bool isNull (self, QString?name)` * `remove (self, int?pos)` * `replace (self, int?pos, QSqlField?field)` * `setGenerated (self, QString?name, bool?generated)` * `setGenerated (self, int?i, bool?generated)` * `setNull (self, int?i)` * `setNull (self, QString?name)` * `setValue (self, int?i, QVariant?val)` * `setValue (self, QString?name, QVariant?val)` * `QVariant value (self, int?i)` * `QVariant value (self, QString?name)` ### Special Methods * `bool __eq__ (self, QSqlRecord?other)` * `__len__ (self)` * `bool __ne__ (self, QSqlRecord?other)` * * * ## Detailed Description 該QSqlRecord類封裝了數據庫記錄。該QSqlRecord類封裝了數據庫記錄（通常是排在數據庫中的表或視圖）的功能和特點。 QSqlRecord支持添加和刪除字段，以及設置和檢索的字段值。的記錄的字段“的值可以按名稱或位置與設置[setValue](qsqlrecord.html#setValue)（），如果你想設置一個字段設置為null的使用[setNull](qsqlrecord.html#setNull)（）。要通過名稱找到使用的字段的位置[indexOf](qsqlrecord.html#indexOf)（），并找到一個字段的名稱在一個特定的位置，用[fieldName](qsqlrecord.html#fieldName)（）。使用[field](qsqlrecord.html#field)（）來檢索一個[QSqlField](qsqlfield.html)反對給定字段。使用[contains](qsqlrecord.html#contains)（），以查看是否記錄中包含一個特定的字段名稱。當生成的查詢數據庫只有那些字段上執行的量[isGenerated](qsqlrecord.html#isGenerated)（）為真都包含在生成的SQL 。 A記錄可以添加與領域[append](qsqlrecord.html#append)（）或[insert](qsqlrecord.html#insert)（），替換為[replace](qsqlrecord.html#replace)（）中，用去除[remove](qsqlrecord.html#remove)（）。所有字段都可以與被刪除[clear](qsqlrecord.html#clear)（）。字段的數目由下式給出[count](qsqlrecord.html#count)（） ;他們所有的值可以使用被清零（空）[clearValues](qsqlrecord.html#clearValues)（）。 * * * ## Method Documentation ``` QSqlRecord.__init__ (self) ``` 構造一個空的記錄。 **See also** [isEmpty](qsqlrecord.html#isEmpty)（）[append](qsqlrecord.html#append)（）和[insert](qsqlrecord.html#insert)（）。 ``` QSqlRecord.__init__ (self, QSqlRecord?other) ``` 構造的副本_other_。 [QSqlRecord](qsqlrecord.html) is [implicitly shared](index.htm#implicitly-shared)。這意味著你可以做一個記錄的副本，[constant time](index.htm#constant-time)。 ``` QSqlRecord.append (self, QSqlField?field) ``` 附加字段的拷貝_field_到記錄的末尾。 **See also** [insert](qsqlrecord.html#insert)（）[replace](qsqlrecord.html#replace)（）和[remove](qsqlrecord.html#remove)（）。 ``` QSqlRecord.clear (self) ``` 刪除所有記錄的字段。 **See also** [clearValues](qsqlrecord.html#clearValues)（）和[isEmpty](qsqlrecord.html#isEmpty)（）。 ``` QSqlRecord.clearValues (self) ``` 清除記錄中的所有字段的值，并設置每個字段設置為null 。 **See also** [setValue](qsqlrecord.html#setValue)（）。 ``` bool QSqlRecord.contains (self, QString?name) ``` 返回True如果在稱為記錄的字段_name_否則返回False 。 ``` int QSqlRecord.count (self) ``` 返回值的記錄中的字段的數目。 **See also** [isEmpty](qsqlrecord.html#isEmpty)（）。 ``` QSqlField QSqlRecord.field (self, int?i) ``` [](qsqlfield.html) [返回字段的位置_index_。如果_index_超出范圍，函數返回一個](qsqlfield.html)[default-constructed value](index.htm#default-constructed-values)。 ``` QSqlField QSqlRecord.field (self, QString?name) ``` [ 這是一個重載函數。返回稱為領域_name_。 ``` QString QSqlRecord.fieldName (self, int?i) ``` 返回字段的名稱位置_index_。如果該字段不存在，則返回一個空字符串。 ](qsqlfield.html) [**See also**](qsqlfield.html) [indexOf](qsqlrecord.html#indexOf)（）。 ``` int QSqlRecord.indexOf (self, QString?name) ``` 返回字段的調用位置_name_在記錄中，或-1，如果它不能被發現。字段名不區分大小寫。如果多于一個字段相匹配，則返回第一個。 **See also** [fieldName](qsqlrecord.html#fieldName)（）。 ``` QSqlRecord.insert (self, int?pos, QSqlField?field) ``` 插入場_field_在位置_pos_在記錄中。 **See also** [append](qsqlrecord.html#append)（）[replace](qsqlrecord.html#replace)（）和[remove](qsqlrecord.html#remove)（）。 ``` bool QSqlRecord.isEmpty (self) ``` 返回True如果有記錄中的任何字段，否則返回False 。 **See also** [append](qsqlrecord.html#append)（）[insert](qsqlrecord.html#insert)（）和[clear](qsqlrecord.html#clear)（）。 ``` bool QSqlRecord.isGenerated (self, int?i) ``` 如果記錄有一個名為場，則返回True_name_而這一領域是要生成（默認），否則返回False 。 **See also** [setGenerated](qsqlrecord.html#setGenerated)（）。 ``` bool QSqlRecord.isGenerated (self, QString?name) ``` 這是一個重載函數。如果記錄有一個字段位置，則返回True_index_而這一領域是要生成（默認），否則返回False 。 **See also** [setGenerated](qsqlrecord.html#setGenerated)（）。 ``` bool QSqlRecord.isNull (self, int?i) ``` 返回True如果調用該領域_name_為空或如果沒有所謂的場_name_否則返回False 。 **See also** [setNull](qsqlrecord.html#setNull)（）。 ``` bool QSqlRecord.isNull (self, QString?name) ``` 這是一個重載函數。返回True如果字段_index_為null ，或者如果沒有字段位置_index_否則返回False 。 ``` QSqlRecord.remove (self, int?pos) ``` 刪除該領域的地位_pos_。如果_pos_超出范圍，沒有任何反應。 **See also** [append](qsqlrecord.html#append)（）[insert](qsqlrecord.html#insert)（）和[replace](qsqlrecord.html#replace)（）。 ``` QSqlRecord.replace (self, int?pos, QSqlField?field) ``` 取代了場位置_pos_用給定的_field_。如果_pos_超出范圍，沒有任何反應。 **See also** [append](qsqlrecord.html#append)（）[insert](qsqlrecord.html#insert)（）和[remove](qsqlrecord.html#remove)（）。 ``` QSqlRecord.setGenerated (self, QString?name, bool?generated) ``` 設置生成的標志字段稱為_name_至_generated_。如果該字段不存在，則什么也不會發生。只有具有領域_generated_設置為真包含在由生成的SQL[QSqlQueryModel](qsqlquerymodel.html)例如。 **See also** [isGenerated](qsqlrecord.html#isGenerated)（）。 ``` QSqlRecord.setGenerated (self, int?i, bool?generated) ``` 這是一個重載函數。設置所生成的標志字段_index_至_generated_。 **See also** [isGenerated](qsqlrecord.html#isGenerated)（）。 ``` QSqlRecord.setNull (self, int?i) ``` 設置字段的值_index_為null。如果該字段不存在，則什么也不會發生。 **See also** [isNull](qsqlrecord.html#isNull)（）和[setValue](qsqlrecord.html#setValue)（）。 ``` QSqlRecord.setNull (self, QString?name) ``` 這是一個重載函數。設置字段中稱為值_name_為null。如果該字段不存在，則什么也不會發生。 ``` QSqlRecord.setValue (self, int?i, QVariant?val) ``` 設置在位置字段的值_index_至_val_。如果該字段不存在，則什么也不會發生。 **See also** [value](qsqlrecord.html#value)（）和[setNull](qsqlrecord.html#setNull)（）。 ``` QSqlRecord.setValue (self, QString?name, QVariant?val) ``` 這是一個重載函數。設置字段中稱為值_name_至_val_。如果該字段不存在，則什么也不會發生。 ``` QVariant QSqlRecord.value (self, int?i) ``` 返回位于位置字段的值_index_在記錄中。如果_index_是出界，無效[QVariant](qvariant.html)返回。 **See also** [setValue](qsqlrecord.html#setValue)（）[fieldName](qsqlrecord.html#fieldName)（）和[isNull](qsqlrecord.html#isNull)（）。 ``` QVariant QSqlRecord.value (self, QString?name) ``` 這是一個重載函數。返回字段的所謂的值_name_在記錄中。如果場_name_不存在一個無效的變體將被返回。 **See also** [indexOf](qsqlrecord.html#indexOf)（）。 ``` bool QSqlRecord.__eq__ (self, QSqlRecord?other) ``` ``` QSqlRecord.__len__ (self) ``` ``` bool QSqlRecord.__ne__ (self, QSqlRecord?other) ```