QSqlField Class Reference · PyQt4 中文文檔

# QSqlField Class Reference ## [[QtSql](index.htm) module] 該QSqlField類操縱在SQL數據庫中的表和視圖中的字段。[More...](#details) ### Types * `enum RequiredStatus { Unknown, Optional, Required }` ### Methods * `__init__ (self, QString?fieldName?=?QString(), Type?type?=?QVariant.Invalid)` * `__init__ (self, QSqlField?other)` * `clear (self)` * `QVariant defaultValue (self)` * `bool isAutoValue (self)` * `bool isGenerated (self)` * `bool isNull (self)` * `bool isReadOnly (self)` * `bool isValid (self)` * `int length (self)` * `QString name (self)` * `int precision (self)` * `RequiredStatus requiredStatus (self)` * `setAutoValue (self, bool?autoVal)` * `setDefaultValue (self, QVariant?value)` * `setGenerated (self, bool?gen)` * `setLength (self, int?fieldLength)` * `setName (self, QString?name)` * `setPrecision (self, int?precision)` * `setReadOnly (self, bool?readOnly)` * `setRequired (self, bool?required)` * `setRequiredStatus (self, RequiredStatus?status)` * `setSqlType (self, int?type)` * `setType (self, Type?type)` * `setValue (self, QVariant?value)` * `Type type (self)` * `int typeID (self)` * `QVariant value (self)` ### Special Methods * `bool __eq__ (self, QSqlField?other)` * `bool __ne__ (self, QSqlField?other)` * * * ## Detailed Description 該QSqlField類操縱在SQL數據庫中的表和視圖中的字段。 QSqlField表示單個列在數據庫中的表或視圖的特性，諸如數據類型和列名。字段也包含了數據庫列，可以查看或更改的值。字段數據值被存儲為[QVariants](index.htm#qvariants)。使用不兼容的類型是不允許的。例如： ``` QSqlField field("age", [QVariant](qvariant.html).Int); field.setValue([QPixmap](qpixmap.html)()); // WRONG ``` 然而，該領域將嘗試施放某些數據類型的字段的數據類型的地方可能： ``` QSqlField field("age", [QVariant](qvariant.html).Int); field.setValue([QString](qstring.html)("123")); // casts QString to int ``` QSqlField對象很少在應用程序代碼中顯式創建。它們通常是通過間接訪問[QSqlRecord](qsqlrecord.html)s表示已經包含字段的列表。例如： ``` [QSqlQuery](qsqlquery.html) query; ... [QSqlRecord](qsqlrecord.html) record = query.record(); QSqlField field = record.field("country"); ``` 一個QSqlField對象可以提供一些元數據有關的領域，例如，其[name](qsqlfield.html#name)（），變異[type](qsqlfield.html#type)（）[length](qsqlfield.html#length)（）[precision](qsqlfield.html#precision)（）[defaultValue](qsqlfield.html#defaultValue)（）， typeid的（），并且它的[requiredStatus](qsqlfield.html#requiredStatus)（）[isGenerated](qsqlfield.html#isGenerated)（）和[isReadOnly](qsqlfield.html#isReadOnly)（）。該字段的數據可以被檢查，看它是否[isNull](qsqlfield.html#isNull)（），和其[value](qsqlfield.html#value)（）檢索。當編輯數據可以與設置[setValue](qsqlfield.html#setValue)（）或設置為NULL與[clear](qsqlfield.html#clear)（）。 * * * ## Type Documentation ``` QSqlField.RequiredStatus ``` 指定字段是必需的還是可選的。 | Constant | Value | Description | | --- | --- | --- | | `QSqlField.Required` | `1` | 插入記錄時，該字段必須被指定。 | | `QSqlField.Optional` | `0` | 該字段沒有插入記錄時指定。 | | `QSqlField.Unknown` | `-1` | 數據庫驅動程序無法確定該字段是否是必需的或可選的。 | **See also** [requiredStatus](qsqlfield.html#requiredStatus)（）。 * * * ## Method Documentation ``` QSqlField.__init__ (self, QString?fieldName?=?QString(), Type?type?=?QVariant.Invalid) ``` 構造一個空字段稱為_fieldName_變異型_type_。 **See also** [setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setLength](qsqlfield.html#setLength)（）[setPrecision](qsqlfield.html#setPrecision)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.__init__ (self, QSqlField?other) ``` 構造的副本_other_。 ``` QSqlField.clear (self) ``` 清除字段的值，并將其設置為NULL 。如果該字段是只讀的，什么也沒有發生。 **See also** [setValue](qsqlfield.html#setValue)（）[isReadOnly](qsqlfield.html#isReadOnly)（）和[requiredStatus](qsqlfield.html#requiredStatus)（）。 ``` QVariant QSqlField.defaultValue (self) ``` 返回字段的默認值（可能為空）。 **See also** [setDefaultValue](qsqlfield.html#setDefaultValue)（）[type](qsqlfield.html#type)（）[requiredStatus](qsqlfield.html#requiredStatus)（）[length](qsqlfield.html#length)（）[precision](qsqlfield.html#precision)（）和[isGenerated](qsqlfield.html#isGenerated)（）。 ``` bool QSqlField.isAutoValue (self) ``` 返回True如果該值是由數據庫自動生成，例如自動遞增的主鍵值。 **See also** [setAutoValue](qsqlfield.html#setAutoValue)（）。 ``` bool QSqlField.isGenerated (self) ``` 返回True如果生成的字段，否則返回False 。 **See also** [setGenerated](qsqlfield.html#setGenerated)（）[type](qsqlfield.html#type)（）[requiredStatus](qsqlfield.html#requiredStatus)（）[length](qsqlfield.html#length)（）[precision](qsqlfield.html#precision)（）和[defaultValue](qsqlfield.html#defaultValue)（）。 ``` bool QSqlField.isNull (self) ``` 返回True如果該字段的值為NULL ，否則返回False 。 **See also** [value](qsqlfield.html#value)（）。 ``` bool QSqlField.isReadOnly (self) ``` 返回True，如果該字段的值是只讀的，否則返回False 。 **See also** [setReadOnly](qsqlfield.html#setReadOnly)（）[type](qsqlfield.html#type)（）[requiredStatus](qsqlfield.html#requiredStatus)（）[length](qsqlfield.html#length)（）[precision](qsqlfield.html#precision)（）[defaultValue](qsqlfield.html#defaultValue)（）和[isGenerated](qsqlfield.html#isGenerated)（）。 ``` bool QSqlField.isValid (self) ``` 返回True如果該字段的變量類型是有效的，否則返回False 。 ``` int QSqlField.length (self) ``` 返回字段的長度。如果返回的值是負的，這意味著該信息不可用，從數據庫中。 **See also** [setLength](qsqlfield.html#setLength)（）[type](qsqlfield.html#type)（）[requiredStatus](qsqlfield.html#requiredStatus)（）[precision](qsqlfield.html#precision)（）[defaultValue](qsqlfield.html#defaultValue)（）和[isGenerated](qsqlfield.html#isGenerated)（）。 ``` QString QSqlField.name (self) ``` 返回字段的名稱。 **See also** [setName](qsqlfield.html#setName)（）。 ``` int QSqlField.precision (self) ``` 返回字段的精度，這是唯一有意義的數值類型。如果返回的值是負的，這意味著該信息不可用，從數據庫中。 **See also** [setPrecision](qsqlfield.html#setPrecision)（）[type](qsqlfield.html#type)（）[requiredStatus](qsqlfield.html#requiredStatus)（）[length](qsqlfield.html#length)（）[defaultValue](qsqlfield.html#defaultValue)（）和[isGenerated](qsqlfield.html#isGenerated)（）。 ``` RequiredStatus QSqlField.requiredStatus (self) ``` [ 返回True如果這是一個必需的字段，否則返回False 。一個`INSERT`如果一個必填字段沒有值將會失敗。 ](qsqlfield.html#RequiredStatus-enum) [**See also**](qsqlfield.html#RequiredStatus-enum) [setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[type](qsqlfield.html#type)（）[length](qsqlfield.html#length)（）[precision](qsqlfield.html#precision)（）[defaultValue](qsqlfield.html#defaultValue)（）和[isGenerated](qsqlfield.html#isGenerated)（）。 ``` QSqlField.setAutoValue (self, bool?autoVal) ``` 標志著字段自動生成的值，如果_autoVal_是真實的。 **See also** [isAutoValue](qsqlfield.html#isAutoValue)（）。 ``` QSqlField.setDefaultValue (self, QVariant?value) ``` 設置用于此字段的默認值_value_。 **See also** [defaultValue](qsqlfield.html#defaultValue)（）[value](qsqlfield.html#value)（）[setType](qsqlfield.html#setType)（）[setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setLength](qsqlfield.html#setLength)（）[setPrecision](qsqlfield.html#setPrecision)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setGenerated (self, bool?gen) ``` 設置生成的狀態。如果_gen_是假的，沒有SQL將這個字段來產生，否則， Qt類如[QSqlQueryModel](qsqlquerymodel.html)和[QSqlTableModel](qsqltablemodel.html)將生成的SQL這一領域。 **See also** [isGenerated](qsqlfield.html#isGenerated)（）[setType](qsqlfield.html#setType)（）[setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setLength](qsqlfield.html#setLength)（）[setPrecision](qsqlfield.html#setPrecision)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setLength (self, int?fieldLength) ``` 設置字段的長度_fieldLength_。對于字符串是字符的字符串可以容納的最大人數;對于其它類型的含義各不相同。 **See also** [length](qsqlfield.html#length)（）[setType](qsqlfield.html#setType)（）[setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setPrecision](qsqlfield.html#setPrecision)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setName (self, QString?name) ``` 設置字段的名稱_name_。 **See also** [name](qsqlfield.html#name)（）。 ``` QSqlField.setPrecision (self, int?precision) ``` 設置字段的_precision_。這只會影響數字字段。 **See also** [precision](qsqlfield.html#precision)（）[setType](qsqlfield.html#setType)（）[setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setLength](qsqlfield.html#setLength)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setReadOnly (self, bool?readOnly) ``` 設置只讀標志字段的值來_readOnly_。只讀字段不能有其值設置與[setValue](qsqlfield.html#setValue)（），并不能清除為NULL與[clear](qsqlfield.html#clear)（）。 **See also** [isReadOnly](qsqlfield.html#isReadOnly)（）。 ``` QSqlField.setRequired (self, bool?required) ``` 設置這個字段所需要的狀態[Required](qsqlfield.html#RequiredStatus-enum)如果_required_為True，否則設置為[Optional](qsqlfield.html#RequiredStatus-enum)。 **See also** [setRequiredStatus](qsqlfield.html#setRequiredStatus)（）和[requiredStatus](qsqlfield.html#requiredStatus)（）。 ``` QSqlField.setRequiredStatus (self, RequiredStatus?status) ``` 設置這個字段所需要的狀態_required_。 **See also** [requiredStatus](qsqlfield.html#requiredStatus)（）[setType](qsqlfield.html#setType)（）[setLength](qsqlfield.html#setLength)（）[setPrecision](qsqlfield.html#setPrecision)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setSqlType (self, int?type) ``` ``` QSqlField.setType (self, Type?type) ``` 集的字段的變量類型_type_。 **See also** [type](qsqlfield.html#type)（）[setRequiredStatus](qsqlfield.html#setRequiredStatus)（）[setLength](qsqlfield.html#setLength)（）[setPrecision](qsqlfield.html#setPrecision)（）[setDefaultValue](qsqlfield.html#setDefaultValue)（）[setGenerated](qsqlfield.html#setGenerated)（）和[setReadOnly](qsqlfield.html#setReadOnly)（）。 ``` QSqlField.setValue (self, QVariant?value) ``` 設置該字段的值，以_value_。如果該字段是只讀的（[isReadOnly](qsqlfield.html#isReadOnly)（）返回True ），沒有任何反應。如果數據類型_value_不同于字段的當前數據類型，試圖將其轉換為適當的類型。這將保留字段的數據類型的賦值，如案件一[QString](qstring.html)為整數數據類型。將值設置為NULL ，使用[clear](qsqlfield.html#clear)（）。 **See also** [value](qsqlfield.html#value)（）[isReadOnly](qsqlfield.html#isReadOnly)（）和[defaultValue](qsqlfield.html#defaultValue)（）。 ``` Type QSqlField.type (self) ``` [ 返回字段的類型與存儲在數據庫中。請注意，實際值可能有不同的類型，即是太大，無法存儲在一個長整型或雙通常被存儲為字符串，以防止丟失精度的數值。 ](index.htm#Type-enum) [**See also**](index.htm#Type-enum) [setType](qsqlfield.html#setType)（）。 ``` int QSqlField.typeID (self) ``` ``` QVariant QSqlField.value (self) ``` 返回該字段的值作為[QVariant](qvariant.html)。使用[isNull](qsqlfield.html#isNull)（）來檢查該字段的值是NULL 。 **See also** [setValue](qsqlfield.html#setValue)（）。 ``` bool QSqlField.__eq__ (self, QSqlField?other) ``` ``` bool QSqlField.__ne__ (self, QSqlField?other) ```