Доступ к данным XML

Существует два способа получения данных XML из источника: с использованием CStreamRowset или CXMLAccessor.

Функциональная возможность	CStreamRowset	CXMLAccessor
Количество переданных данных	Одновременное получение данных из всех столбцов и строк.	Получение данных из всех столбцов, но только одной строки за один раз.Необходимо переходить между строками, используя такие методы, как MoveNext.
Форматирование строки	SQL Server форматирует строку XML и отправляет ее объекту-получателю.	Получение данных набора строк в собственном формате (для этого требуется, чтобы поставщик отправил их в виде строк в кодировке Юникода) и построение строки, содержащей данные в формате XML.
Управление форматированием	Существует несколько уровней управления форматированием строки XML, настраиваемых с помощью настройки свойств SQL Server 2000.	Управление форматированием создаваемой строки XML недоступно.

В то время как CStreamRowset предоставляет более эффективный способ получения данных в формате XML, он поддерживается только SQL Server 2000.

Получение данных XML с помощью CStreamRowset

В объявлении CCommand или CTable в качестве типа набора строк пользователь указывает CStreamRowset.Его можно использовать с методом доступа или без него, например:

CCommand<CAccessor<CMyAccessor>, CStreamRowset> myCmd;

-или-

CCommand<CNoAccessor, CStreamRowset> myCmd;

Обычно при вызове CCommand::Open (например, CRowset, определяющее, как класс TRowset ), он получает указатель IRowset.ICommand::Execute возвращает указатель IRowset, который хранится в элементе m_spRowset объекта CRowset.Методы, например MoveFirst, MoveNext и GetData, используют этот указатель для получения данных.

С другой стороны, при вызове CCommand::Open (но с указанием CStreamRowset в качестве класса TRowset), ICommand::Execute возвращает указатель ISequentialStream, который хранится в элементе данных m_spStream объекта CStreamRowset.После этого используется метод Read, чтобы получить данные (строки в кодировке Юникода) в формате XML.Примеры.

myCmd.m_spStream->Read()

SQL Server 2000 выполняет форматирование XML и возвращает все столбцы и строки набора как одну строку XML.

Пример использования метода Read см. в подразделе "Добавление поддержки XML в объект-получатель" раздела Реализация простого объекта-получателя.

Примечание
Поддержка XML с использованием CStreamRowset доступна только для SQL Server 2000 и требует поставщика OLE DB для SQL Server 2000 (установленного с компонентами MDAC).

Получение данных XML с помощью CXMLAccessor

CXMLAccessor позволяет получить доступ к данным из источника данных в виде строковых данных в случае, если отсутствует информация о схеме хранилища данных.CXMLAccessor действует как CDynamicStringAccessorW с той только разницей, что первый преобразует все данные из хранилища в формат XML (с тегами).Имена тегов XML совпадают с названиями столбцов хранилища данных насколько это возможно.

Воспользуйтесь CXMLAccessor как любым другим классом доступа, передав его как параметр шаблона в CCommand или CTable:

CTable<CXMLAccessor, CRowset> rs;

Используйте GetXMLRowData, чтобы получить данные из одной строки таблицы за один раз, и переходите между строками с помощью методов, таких как MoveNext, например:

// Open data source, session, and rowset
hr = rs.MoveFirst();
while( SUCCEEDED(hr) && hr != DB_S_ENDOFROWSET )
{
    CStringW strRowData;
    myCmd.GetXMLRowData(strRowData);

    printf_s( "%S\n", strRowData );

    hr = rs.MoveNext();
}

Чтобы получить информацию столбца (типа данных) как строковые данные в формате XML, воспользуйтесь GetXMLColumnData.

См. также

Основные понятия

Использование методов доступа