IBinarySerialize Schnittstelle
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine benutzerdefinierte Implementierung für die Serialisierung und Deserialisierung benutzerdefinierter Typen (User-Defined Type, UDT) und benutzerdefinierter Aggregate bereit.
public interface class IBinarySerialize
public interface IBinarySerialize
type IBinarySerialize = interface
Public Interface IBinarySerialize
Hinweise
Benutzerdefinierte Typen (User-Defined Types, UDTs) und benutzerdefinierte Aggregate sind erforderlich, um ein Speicherformat zu definieren, das entweder Formatsein kann.Native
oder Format.UserDefined
.
Format.Native
ermöglicht SQL Server, Serialisierung und Deserialisierung automatisch zu verarbeiten, aber das Format hat Einschränkungen hinsichtlich der Art der Typen, die es verarbeiten kann. Format.UserDefined
ermöglicht benutzerdefinierten Typen und Aggregaten, ihre eigene Serialisierung zu verarbeiten. Benutzerdefinierte Typen und Aggregate müssen mit Formatgekennzeichnet werden.UserDefined
SqlUserDefinedType
im - oder SqlUserDefinedAggregate
-Attribut und muss die IBinarySerialize -Schnittstelle implementieren.
Beachten Sie, dass auch bei benutzerdefinierter Serialisierung die Gesamtgröße jeder Instanz unter dem maximal zulässigen Grenzwert liegen muss, derzeit 8000 Bytes.
Methoden
Read(BinaryReader) |
Generiert einen benutzerdefinierten Typ (UDT) oder ein benutzerdefiniertes Aggregat aus seiner Binärform. |
Write(BinaryWriter) |
Konvertiert einen benutzerdefinierten Typ (UDT) oder ein benutzerdefiniertes Aggregat in seine Binärform, sodass er/es behalten werden kann. |