Nonstop Database, HiRDB Version 9 UAP Development Guide

[Contents][Index][Back][Next]

16.6.2 Notes about individual methods and properties

The following table provides notes about individual methods and properties of HiRDB.NET Data Provider.

Table 16-2 Notes about individual methods and properties

Object Method or property Details
HiRDBCommand CommandTimeout property The setting is ignored because the timeout value during execution depends on the settings in the client environment definition (PDCWAITTIME, PDSWAITTIME, PDSWATCHTIME).
Cancel method System.NotSupportedException is returned because there is no cancellation function.
ExecuteReader method When the CommandBehavior.KeyInfo, CommandBehavior.SchemaOnly, or CommandBehavior.SequentialAccess argument is specified, it is treated as CommandBehavior.Default because a function for acquiring only column or primary key information is not available.
UpdatedRowSource property When UpdatedRowSource.Both or UpdatedRowSource.FirstReturnedRecord is specified, HiRDBException is returned because there is no batch query function that returns rows.
HiRDBCommandBuilder CatalogLocation property No function is affected by this property value because a cataloging function is not available.
CatalogSeparator property No function is affected by this property value because a cataloging function is not available.
SetAllValues property This property value is always true and the UPDATE statement includes all column information.
HiRDBConnection ConnectionTimeout property The following value is always returned:
  • When the supported ADO.NET version is 1.1: 15
  • When the supported ADO.NET version is 2.0: 0
Database property The null character always results because there is no function for acquiring database names.
State property ConnectionState.Connecting, ConnectionState.Executing, ConnectionState.Fetching, or ConnectionState.Broken will never result because this property is a reserved value for future product versions.
BeginTransaction method IsolationLevel is ignored, if specified, because this method is set for each SQL statement or acquired from HiRDB environment variables.
No more than one transaction can be executed using a single connection.
ChangeDatabase method System.NotSupportedException is returned because a function for changing the connected database is not available.
EnlistTransaction method System.NotSupportedException is returned because a distributed transaction function is not available.
GetSchema method Schema information is not returned. An empty DataTable object is always returned.
HiRDBDataReader Depth property Always 0 because there is no hierarchy concept.
VisibleFieldCount property The value is the same as for FieldCount because a column specified in the retrieval SQL statement is always acquired.
GetBoolean method NotSupportedException is returned because there is no corresponding type.
GetByte method NotSupportedException is returned because there is no corresponding type.
GetChar method NotSupportedException is returned because there is no corresponding type.
GetData method NotSupportedException is returned because there is no corresponding type.
GetGuid method NotSupportedException is returned because there is no corresponding type.
GetProviderSpecificFieldType An object with the data type provided in .NET Framework's common language runtime is returned because no unique data types are supported.
GetProviderSpecificValue An object with the data type provided in .NET Framework's common language runtime is returned because no unique data types are supported.
GetProviderSpecificValues An object with the data type provided in .NET Framework's common language runtime is returned because no unique data types are supported.
NextResult method false is returned because there is no multiple record set function.
HiRDBParameter DbType property If DbType.Boolean, DbType.Currency, DbType.Guid, or DbType.VarNumeric is specified, HiRDBException is returned because there is no corresponding type.
Direction property If HiRDBCommand class's ExecuteNonQuery, ExecuteReader, ExecuteScalar, or Prepare method is executed while Direction.ReturnValue is specified, HiRDBException is returned because there is no function for acquiring the stored procedure's return value.
IsNullable property Acquisition only; setting is not available. (The null value can always be specified.)
HiRDBProviderFactory CreateDataSourceEnumerator method NotSupportedException is returned because no HiRDB enumeration type is provided.
HiRDBTransaction IsolationLevel property The following value is always returned:
  • When the supported ADO.NET version is 1.1: IsolationLevel.ReadCommitted
  • When the supported ADO.NET version is 2.0: IsolationLevel.RepeatableRead