Skip to content

Latest commit

 

History

History
61 lines (49 loc) · 2.37 KB

File metadata and controls

61 lines (49 loc) · 2.37 KB
title Read (Database Engine)
description Read (Database Engine) by using CSharp
author MikeRayMSFT
ms.author mikeray
ms.date 04/16/2020
ms.service sql
ms.subservice t-sql
ms.topic reference
ms.custom
ignite-2025
f1_keywords
Read_TSQL
Read
helpviewer_keywords
Read [Database Engine]
dev_langs
TSQL
monikerRange =azuresqldb-current || >=sql-server-2016 || >=sql-server-linux-2017 || =azuresqldb-mi-current || =fabric-sqldb

Read (Database Engine) by using CSharp

[!INCLUDE SQL Server Azure SQL Database Azure SQL Managed Instance FabricSQLDB]

Read reads binary representation of SqlHierarchyId from the passed-in BinaryReader and sets the SqlHierarchyId object to that value. Read cannot be called by using [!INCLUDEtsql]. Use CAST or CONVERT instead.

Syntax

void Read(BinaryReader r)

Arguments

r
The BinaryReader object that produces a binary stream corresponding to a binary representation of a hierarchyid node.

Return types

CLR return type:void

Remarks

Read does not validate its input. If an invalid binary input is given, Read might raise an exception. Or, it might succeed and produce an invalid SqlHierarchyId object whose methods can either give unpredictable results or raise an exception.

Read can only be called on a newly created SqlHierarchyId object.

Read is used internally by [!INCLUDEssNoVersion] when it is necessary, such as when writing data to hierarchyid column. Read is also called internally when a conversion is done between varbinary and hierarchyid.

Examples

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);   

See Also

Write (Database Engine)
ToString (Database Engine)
CAST and CONVERT (Transact-SQL)
hierarchyid Data Type Method Reference