Read (компонент Database Engine)

Статья
03/07/2014

Компонент Read считывает двоичное представление SqlHierarchyId из переданного BinaryReader и присваивает это значение объекту SqlHierarchyId. Компонент Read невозможно вызвать с помощью Transact-SQL. Пользуйтесь вместо этого инструкцией CAST или CONVERT.

Применимо для следующих объектов: SQL Server (SQL Server 2008 по текущую версию), База данных SQL Windows Azure (С первоначального выпуска по текущий выпуск).

Синтаксис

void Read( BinaryReader r )

Аргументы

r
Объект BinaryReader, который формирует двоичный поток, соответствующий двоичному представлению узла hierarchyid.

Возвращаемые типы

Возвращаемый тип CLR: void

Замечания

Read не проверяет ввод. Если дан недопустимый двоичный ввод, то Read может вызвать исключение. Завершение может быть успешным с выдачей недопустимого объекта SqlHierarchyId, методы которого выдают непредсказуемые результаты или вызывают исключение.

Read может быть вызван только для заново созданного объекта SqlHierarchyId.

Компонент Read используется для внутренних целей SQL Server, например, при записи данных в столбец hierarchyid. Компонент Read также вызывается внутренними средствами, если выполняется преобразование между varbinary и hierarchyid.

Примеры

Byte[] encoding = new byte[] { 0x58 };
MemoryStream stream = new MemoryStream(encoding, false /*not writable*/);
BinaryReader br = new BinaryReader(stream);
SqlHierarchyId hid = new SqlHierarchyId();
hid.Read(br);