Compartilhar via


SqlUserDefinedTypeAttribute.MaxByteSize Propriedade

Definição

O tamanho máximo da instância, em bytes.

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

Valor da propriedade

Um Int32 valor que representa o tamanho máximo da instância.

Comentários

Você deve especificar a MaxByteSize propriedade com a UserDefined serialização Format.

Ao se conectar ao SQL Server 2005 ou anterior, MaxByteSize deve estar entre 1 e 8000.

Ao se conectar ao SQL Server 2008 ou posterior, defina MaxByteSize entre 1 e 8000, para um tipo cujas instâncias são sempre 8.000 bytes ou menos. Para tipos que podem ter instâncias maiores que 8000, especifique -1.

Para um UDT com serialização definida pelo usuário especificada, MaxByteSize se refere ao tamanho total do UDT em sua forma serializada conforme definido pelo usuário. Considere um UDT com a propriedade de uma cadeia de 10 caracteres (Char). Quando o UDT é serializado usando um BinaryWriter, o tamanho total da cadeia de caracteres serializada é de 22 bytes: 2 bytes por caractere Unicode UTF-16, multiplicado pelo número máximo de caracteres, além de 2 bytes de controle de sobrecarga incorridos da serialização de um fluxo binário. Portanto, ao determinar o valor de MaxByteSize, o tamanho total do UDT serializado deve ser considerado: o tamanho dos dados serializados em formato binário mais a sobrecarga incorrida pela serialização.

Essa propriedade não deve ser usada com Native serialização Format.

Aplica-se a