SqlUserDefinedTypeAttribute.MaxByteSize Proprietà

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v4.1.0

Dimensioni massime, in byte, dell'istanza.

public:
 property int MaxByteSize { int get(); void set(int value); };

public int MaxByteSize { get; set; }

member this.MaxByteSize : int with get, set

Public Property MaxByteSize As Integer

Valore della proprietà

Int32

Un valore Int32 che rappresenta la dimensione massima dell'istanza.

Commenti

È necessario specificare la MaxByteSize proprietà con la UserDefined serializzazione Format.

Quando ci si connette a SQL Server 2005 o versioni precedenti, MaxByteSize deve essere compreso tra 1 e 8000.

Quando ci si connette a SQL Server 2008 o versione successiva, impostare MaxByteSize tra 1 e 8000, per un tipo le cui istanze sono sempre 8.000 byte o meno. Per i tipi che possono avere istanze superiori a 8000, specificare -1.

Per un tipo definito dall'utente per cui è specificata una serializzazione definita dall'utente, MaxByteSize si riferisce alle dimensioni totali del tipo definito dall'utente nel formato serializzato definito dall'utente. Si consideri un tipo definito dall'utente con una proprietà di una stringa di 10 caratteri (Char). Quando il tipo definito dall'utente viene serializzato utilizzando un BinaryWriter, la dimensione totale della stringa serializzata è di 22 byte: 2 byte per carattere Unicode UTF-16, moltiplicato per il numero massimo di caratteri, più 2 byte di controllo di overhead derivanti dalla serializzazione di un flusso binario. Pertanto, quando si determina il valore di MaxByteSize, è necessario considerare le dimensioni totali del tipo definito dall'utente serializzato: le dimensioni dei dati serializzati in formato binario e il sovraccarico generato dalla serializzazione.

Questa proprietà non deve essere utilizzata con Native la serializzazione Format.