IBinarySerialize.Read メソッド

.NET Framework クラス ライブラリ リファレンス

IBinarySerialize.Read メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザー定義型 (UDT) またはユーザー定義集計をバイナリ形式から生成します。

名前空間: Microsoft.SqlServer.Server
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Sub Read ( _
    r As BinaryReader _
)

Visual Basic (使用法)

Dim instance As IBinarySerialize
Dim r As BinaryReader

instance.Read(r)

C#

void Read (
    BinaryReader r
)

C++

void Read (
    BinaryReader^ r
)

J#

void Read (
    BinaryReader r
)

JScript

function Read (
    r : BinaryReader
)

パラメータ

r

オブジェクトの逆シリアル化元である BinaryReader ストリーム。

解説

Read メソッドは、Write メソッドによって書き込まれた情報を使用して、オブジェクトを再構築する必要があります。

使用例

以前に永続化した UDT を、BinaryReader を使用して逆シリアル化する Read メソッドの実装の例を次に示します。この例は、UDT が 2 つのデータ プロパティ StringValue と DoubleValue を持っていると仮定しています。

Visual Basic

' The binary layout is as follows:
'    Bytes 0 - 19: string text, padded to the right with null
'    characters
'    Bytes 20+: double value
Public Sub Read(ByVal r
 As System.IO.BinaryReader) _
  Implements Microsoft.SqlServer.Server.IBinarySerialize.Read
    
    Dim maxStringSize As Integer
 = 20
    Dim chars As Char()
    Dim stringEnd As Integer
    Dim stringValue As String
    Dim value As double

    ' Read the characters from the binary stream.
    chars = r.ReadChars(maxStringSize)
    
    ' Find the start of the null character padding.
    stringEnd = Array.IndexOf(chars, ControlChars.NullChar)

    If StringEnd = 0 Then
       stringValue = Nothing
       Exit Sub
    End If

    ' Build the string from the array of characters.
    stringValue = new String(chars, 0, stringEnd)

    ' Read the double value from the binary stream.
    value = r.ReadDouble()

    ' Set the object's properties equal to the values.
    Me.StringValue = stringValue
    Me.DoubleValue = value

End Sub

C#

// The binary layout is as follows:
//    Bytes 0 - 19: string text, padded to the right with null characters
//    Bytes 20+: Double value

public void Read(System.IO.BinaryReader r)
{

    int maxStringSize = 20;
    char[] chars;
    int stringEnd;
    string stringValue;
    double doubleValue;

    // Read the characters from the binary stream.
    chars = r.ReadChars(maxStringSize);

    // Find the start of the null character padding.
    stringEnd = Array.IndexOf(chars, '\0');

    if (stringEnd == 0)
    {
        stringValue = null;
        return;
    }

    // Build the string from the array of characters.
    stringValue = new String(chars, 0, stringEnd);

    // Read the double value from the binary stream.
    doubleValue = r.ReadDouble();

    // Set the object's properties equal to the values.
    this.StringValue = stringValue;
    this.DoubleValue = doubleValue;
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
IBinarySerialize インターフェイス
IBinarySerialize メンバ
Microsoft.SqlServer.Server 名前空間