аннулировать RFX_Text_Bulk (CFieldExchange * pFX, LPCTSTR szName, LPSTR * prgStrVals, Лонг ** prgLengths, int nMaxLength );
Параметры
pFX
Указатель на объект CFieldExchange . Этот объект содержит сведения для определения контекста для каждого вызова функции. Для получения дополнительных сведений см. статью Обмен полями записей: как RFX работ в Руководстве по Visual C++ программист.
szName
Имя столбца данных.
prgStrVals
Указатель на массив значений LPSTR . Этот массив будет хранить данные быть передан из источника данных в набор записей. Обратите внимание, что в текущей версии ODBC, эти значения не могут быть Unicode.
prgLengths
Указатель на массив из долгого целых чисел. Этот массив будет сохранять длину в байтах каждого значения в массиве, который указывает prgStrVals. Эта длина не включает нулевой символ. Обратите внимание, что значение SQL_NULL_DATA будет сохранено, если соответствующий элемент данных содержит значение Null. Для получения более подробной информации см. ODBC API-функцию SQLBindCol в Справочник программиста ODBC SDK.
nMaxLength
Максимально допустимая длина значений, хранящихся в массиве, который указывает prgStrVals, включая нулевой символ. Чтобы гарантировать, что данные не будут усечены, передайте значение, чтобы вместить крупнейший элемент данных, который вы ожидаете.
Примечания
RFX_Text_Bulk функция передачи нескольких строк символьных данных из столбца источника данных ODBC в соответствующий массив в CRecordset-производный объект. Столбец источника данных может иметь тип ODBC SQL_LONGVARCHAR, SQL_CHAR, SQL_VARCHAR, SQL_DECIMALили SQL_NUMERIC. Набор записей необходимо определить элемент данных поля типа LPSTR.
Если инициализировать prgStrVals и prgLengths в NULL, затем массивы, которые указывают они будут выделены автоматически, с размерами равно размеру набора строк.
Примечание Блочный обмен полей записей только передает данные из источника данных в объект набора записей. Для того чтобы набор записей обновляемым, необходимо использовать функцию интерфейса API ODBC SQLSetPos. В качестве примера того, как это сделать, см. пример DBFETCH.
Для получения дополнительной информации, обратитесь к статьям набор записей: выборка записей (ODBC) и Запись обмена полей записей (RFX) в Руководстве Visual C++ программист.
Пример
ClassWizard не поддерживает функций Bulk RFX, поэтому необходимо вручную написать звонков в вашем DoBulkFieldExchange переопределения. Этот пример показывает вызов RFX_Text_Bulk, а также призыв к RFX_Long_Bulk, для передачи данных. Эти вызовы перед вызовом CFieldExchange::SetFieldType. Обратите внимание, что для параметров, необходимо вызвать функции RFX вместо функций Bulk RFX.
void MultiRowSet::DoBulkFieldExchange (CFieldExchange * pFX)
{
nbsp; pFX - > SetFieldType (CFieldExchange::outputColumn);
RFX_Long_Bulk (pFX, _T ("[colRecID]"),
& m_rgID, и m_rgIDLenghts);
RFX_Text_Bulk (pFX, _T ("[colName]"),
& m_rgName, & m_rgNameLengths, 30);
pFX - > SetFieldType (CFieldExchange::inputParam);
RFX_Text (pFX, «NameParam», m_strNameParam);
}
См. также RFX_Binary_Bulk, RFX_Bool_Bulk, RFX_Byte_Bulk, RFX_Date_Bulk, RFX_Double_Bulk, RFX_Int_Bulk, RFX_Long_Bulk, RFX_Single_Bulk, CFieldExchange::SetFieldType