IBinarySerialize.Write(BinaryWriter) Метод

Определение

Преобразует пользовательский тип или пользовательскую агрегатную функцию в двоичный формат для возможности сохранения.Converts a user-defined type (UDT) or user-defined aggregate into its binary format so that it may be persisted.

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)

Параметры

w
BinaryWriter

Поток BinaryWriter, в который выполняется сериализация пользовательского типа или пользовательской агрегатной функции.The BinaryWriter stream to which the UDT or user-defined aggregate is serialized.

Примеры

В приведенном ниже примере показана реализация Write метода определяемого пользователем типа, который BinaryWriter использует для сериализации UDT в пользовательском двоичном формате.The following example shows the implementation of the Write method of a UDT, which uses a BinaryWriter to serialize the UDT in the user-defined binary format. Заполнение символами NULL заключается в том, чтобы гарантировать, что строковое значение полностью отделяется от значения Double, чтобы один определяемый пользователем тип был по сравнению с другим в коде Transact-SQL, строковые байты сравнивались с байтами строк и Double в сравнении с Double. байт.The purpose of the null character padding is to ensure that the string value is completely separated from the double value, so that one UDT is compared to another in Transact-SQL code, string bytes are compared to string bytes and double bytes are compared to double bytes.

// The binary layout is as follows:
//    Bytes 0 - 19: string text, padded to the right with null characters
//    Bytes 20+: Double value
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);
}
' The binary layout is as follows:
'    Bytes 0 - 19: string text, padded to the right with null characters
'    Bytes 20+: Double value
Public Sub Write(ByVal w As System.IO.BinaryWriter) _
  Implements Microsoft.SqlServer.Server.IBinarySerialize.Write

    Dim maxStringSize As Integer = 20
    Dim stringValue As String = "The value of PI: "
    Dim paddedString As String
    Dim value As Double = 3.14159

    ' Pad the string from the right with null characters.
    paddedString = stringValue.PadRight(maxStringSize, ControlChars.NullChar)
    
    
    ' Write the string value one byte at a time.
    Dim i As Integer
    For i = 0 To paddedString.Length - 1
        w.Write(paddedString(i))
    Next

    ' Write the double value.
    w.Write(value)
    
End Sub

Комментарии

Напишите достаточно информации в двоичный поток, чтобы Read метод воссоздать определяемый пользователем тип или статистическую функцию.Write sufficient information to the binary stream to allow the Read method to reconstitute your UDT or user-defined aggregate.

Применяется к