IBinarySerialize.Write(BinaryWriter) Metodo

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v4.1.0

Converte un UDT oppure un aggregato definito dall'utente nel relativo formato binario in modo da garantirne la persistenza.

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)

Parametri

w

BinaryWriter

Flusso BinaryWriter in cui il tipo definito dall'utente o l'aggregato definito dall'utente viene serializzato.

Esempio

Nell'esempio seguente viene illustrata l'implementazione del Write metodo di un'UDT, che usa un BinaryWriter oggetto per serializzare l'UDT nel formato binario definito dall'utente. Lo scopo del riempimento dei caratteri Null consiste nel garantire che il valore della stringa sia completamente separato dal valore doppio, in modo che un valore UDT venga confrontato con un altro nel codice Transact-SQL, i byte stringa vengono confrontati con byte stringa e i byte double vengono confrontati con i byte double.

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

Commenti

Scrivere informazioni sufficienti nel flusso binario per consentire al metodo di ricostituire l'aggregazione Read definita dall'utente o UDT.