Field references enable efficiency gains when accessing message fields. More...
Properties | |
| string | FieldName [get] |
| Get the field name from a field reference object. More... | |
Detailed Description
Field references enable efficiency gains when accessing message fields.
The Message API provides two versions of each message field accessor method – one accepts a field name, while the other accepts a field reference object. Access by field reference is more efficient than access by name alone.
Field reference objects contain a field name, along with internal information that enables efficient access.
Programs can repeatedly use a field reference object to efficiently access a field – even across messages of different formats.
For example, if formats A and B both have a field named foo, then a field reference object with field name foo accesses the correct field in messages of either format.
Field reference objects are thread-safe. (However, getting the System.Collections.IEnumerator.Current property of MessageEnumerator returns a field reference that is an exception to this rule; it is not thread-safe.)
To create a field reference object, call IRealm.CreateMessageFieldRef
You must dispose each field reference object. The IDisposable.Dispose method frees all resources associated with the field reference.
Customers do not implement this interface.
Property Documentation
|
get |
Get the field name from a field reference object.