IBinarySerialize.Write(BinaryWriter) Metode

Definisi

Ruang nama:

Microsoft.Data.SqlClient.Server

Rakitan:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v4.1.0

Mengonversi jenis yang ditentukan pengguna (UDT) atau agregat yang ditentukan pengguna ke dalam format binernya sehingga dapat dipertahankan.

public:
 void Write(System::IO::BinaryWriter ^ w);

public void Write(System.IO.BinaryWriter w);

abstract member Write : System.IO.BinaryWriter -> unit

Public Sub Write (w As BinaryWriter)

Parameter

w

BinaryWriter

Aliran BinaryWriter tempat UDT atau agregat yang ditentukan pengguna diserialisasikan.

Contoh

Contoh berikut menunjukkan implementasi Write metode UDT, yang menggunakan untuk menserialisasikan BinaryWriter UDT dalam format biner yang ditentukan pengguna. Tujuan dari padding karakter null adalah untuk memastikan bahwa nilai string benar-benar dipisahkan dari nilai ganda, sehingga satu UDT dibandingkan dengan yang lain dalam kode Transact-SQL, byte string dibandingkan dengan byte string dan byte ganda dibandingkan dengan byte ganda.

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

// using Microsoft.SqlServer.Server;
public void Write(System.IO.BinaryWriter w)
{
    int maxStringSize = 20;
    string stringValue = "The value of PI: ";
    string paddedString;
    double value = 3.14159;

    // Pad the string from the right with null characters.
    paddedString = stringValue.PadRight(maxStringSize, '\0');

    // Write the string value one byte at a time.
    for (int i = 0; i < paddedString.Length; i++)
    {
        w.Write(paddedString[i]);
    }

    // Write the double value.
    w.Write(value);
}

Keterangan

Tulis informasi yang memadai ke aliran biner untuk memungkinkan Read metode menyusun ulang UDT atau agregat yang ditentukan pengguna Anda.