Read (データベース エンジン)
Read は、渡された BinaryReader から SqlHierarchyId のバイナリ表現を読み取り、SqlHierarchyId オブジェクトをその値に設定します。Transact-SQL を使用して Read を呼び出すことはできません。代わりに、CAST または CONVERT を使用してください。
構文
void Read( BinaryReader r )
引数
- r
hierarchyid ノードのバイナリ表現に対応するバイナリ ストリームを生成する BinaryReader オブジェクト。
戻り値の型
**CLR の戻り値の型 :**void
説明
Read では、その入力は検証されません。無効なバイナリが入力されると、Read で例外が発生する場合があります。あるいは、正常に実行されて無効な SqlHierarchyId オブジェクトが生成される場合があり、そのオブジェクトのメソッドが予期しない結果を返したり、例外を発生させたりする可能性があります。
Read は、新規に作成された SqlHierarchyId オブジェクトでのみ呼び出すことができます。
Read は、必要な場合に SQL Server によって内部的に使用されます (たとえば hierarchyid 列にデータを書き込む場合など)。また、varbinary と hierarchyid の間で変換が行われるときにも、Read が内部的に呼び出されます。
例
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);