Read (Mecanismo de Banco de Dados)

Artigo
06/18/2013

Read lê a representação binária de SqlHierarchyId do BinaryReader transmitido, e define o objeto SqlHierarchyId como aquele valor. Read não pode ser chamado por meio de Transact-SQL. Em seu lugar, use CAST ou CONVERT.

Sintaxe

void Read( BinaryReader r )

Argumentos

r
O objeto BinaryReader que produz um fluxo binário correspondente a uma representação binária de um nó hierarchyid.

Tipos de retorno

Tipo de retorno CLR: void

Comentários

Read não valida sua entrada. Se uma entrada binária inválida for determinada, Read pode gerar uma exceção. Ou pode ser bem-sucedida e produzir um objeto SqlHierarchyId inválido cujos métodos podem gerar resultados inesperados ou uma exceção.

Read pode ser chamado somente em um objeto SqlHierarchyId recém-criado.

Read é usado internamente pelo SQL Server quando necessário, como ao gravar dados na coluna hierarchyid. Read também é chamado internamente quando uma conversão é feita entre varbinary e hierarchyid.

Exemplos

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