ReadFromFile Method (Field Object)

ReadFromFile Method (Field Object)

The ReadFromFile method loads the value of a string or binary field from a file.

Syntax

objField.ReadFromFile(fileName)

objField

Required. The Field object.

fileName

Required. String. The full path and file name to read, for example C:\DOCUMENT\BUDGET.XLS.

Remarks

The ReadFromFile method reads the string or binary value from the specified file and stores it as the value of the Field object. It replaces any previously existing value for the field.

ReadFromFile is not supported for simple types, such as vbInteger, vbLong, and vbBoolean. Microsoft® Visual Basic® provides common functions to read and write these base types to and from files. The ReadFromFile method fails unless the Type property of the Field object is vbString or vbBlob.

MAPI properties of type PT_BINARY are read from persistent storage in counted binary format but converted to a hexadecimal string format when they are stored as Field values. Comparison operations on the Value property and the actual contents of the file can return "not equal" even when the values are equivalent.

In addition, support for types can vary among providers. Not all providers support both the vbString and vbBlob property types.

ReadFromFile returns CdoE_INTERFACE_NOT_SUPPORTED on Field objects obtained from a Folder object's Fields collection. It also returns CdoE_INTERFACE_NOT_SUPPORTED on fields from an AppointmentItem object's Fields collection if the AppointmentItem represents an instantiated individual recurrence of a recurring appointment.

See Also

Concepts

WriteToFile Method (Field Object)
Field Object