Class RecordValue
Implements
Inherited Members
Namespace: Oracle.NoSQL.SDK
Assembly: Oracle.NoSQL.SDK.dll
Syntax
public class RecordValue : MapValue
Remarks
This class is used to represent values of NoSQL data type Record. It also represents table rows on output operations such as GetAsync(String, MapValue, GetOptions, CancellationToken) and QueryAsync. In both of these cases, the field (key) ordering is required to be preserved.
In addition to the functionality of MapValue this class
preserves the ordering of keys in the same order as they were added to
the dictionary. The entries are not sorted by the key, instead the
order is determined solely by the order in which the new entries are
added. When enumerated with foreach
loop, the order of entries
is guaranteed to be the same.
Each entry in the dictionary represented by this class has an index. The index ranges from 0 to Count and is is determined when the new entry is added to the dictionary, except for Insert(Int32, String, FieldValue) method that provides the index. This class also allows retrieving keys and values by index.
Even though RecordValue may be used wherever MapValue is used, note that RecordValue is more memory and computation expensive then MapValue and thus it is preferred to use MapValue when the field ordering is not required.
Constructors
Name | Description |
---|---|
RecordValue() | Initializes a new instance of RecordValue that is empty and has the default initial capacity. |
RecordValue(Int32) | Initializes a new instance of RecordValue that is empty and has the specified initial capacity. |
Properties
Name | Description |
---|---|
Item[Int32] | Gets the value at the specified index. |
Methods
Name | Description |
---|---|
Equals(FieldValue) | Returns a value indicating whether the value of this instance is equal to the value of the specified FieldValue instance. |
GetKeyAtIndex(Int32) | Gets the key at the specified index. |
GetValueAtIndex(Int32) | Gets the value at the specified index. |
Insert(Int32, String, FieldValue) | Inserts an entry with the specified key and the specified value at the specified index. |
RemoveAt(Int32) | Removes the entry at the specified index. |