Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

Format (Enumeración)

Lo utilizan SqlUserDefinedTypeAttribute y SqlUserDefinedAggregateAttribute para indicar el formato de serialización de un tipo definido por el usuario (UDT) o agregado.

Espacio de nombres:  Microsoft.SqlServer.Server
Ensamblado:  System.Data (en System.Data.dll)

public enum Format

Nombre de miembroDescripción
NativeEl formato de serialización Native utiliza un algoritmo muy simple que permite SQL Server almacenar en disco una representación eficaz del UDT. Los tipos marcados para la serialización Native solo pueden tener como miembros tipos de valor ("structs" en Microsoft Visual C# y estructuras en Microsoft Visual Basic .NET). Los miembros de los tipos de referencia (como clases en Visual C# y Visual Basic), ya sean definidos por el usuario o existentes en Framework (como String), no se admiten.

Los requisitos para este formato son:

  • El atributo StructLayout.LayoutKindSequential se debe aplicar al agregado o UDT si se define en una clase y no en una estructura. De este modo, se controla el diseño físico de los campos de datos y se impone a los miembros un diseño secuencial según el orden en que aparecen. SQL Server utiliza este atributo para determinar el orden de campos de los UDT con varios campos.

  • El tipo debe contener al menos un miembro (los valores serializados no pueden tener un tamaño de cero bytes).

  • Todos los campos del agregado deben poder transferirse en bloque de bits, es decir, deben tener una representación común tanto en la memoria administrada como en la no administrada y no requerir ningún control especial del calculador de referencias de interoperabilidad.

  • Todos los campos del UDT deben ser uno de los siguientes tipos que se pueden serializar: bool, byte,sbyte,short,ushort, int, uint, long, ulong, float, double, SqlByte, SqlInt16, SqlInt32, SqlInt64, SqlDateTime, SqlSingle, SqlDouble, SqlMoney u otros tipos de valor definidos por el usuario que contienen campos de uno de estos tipos.

  • El agregado no debe especificar un valor para MaxByteSize.

  • El agregado no debe tener ningún campo [NonSerialized].

  • Los campos no se deben marcar como un diseño explícito (StructLayoutAttribute).

UnknownSe desconoce el formato de serialización.
UserDefinedEl formato de serialización UserDefined otorga al desarrollador pleno control sobre el formato binario a través del método IBinarySerialize.Write y del método IBinarySerialize.Read.

El agregado debe especificar un valor para MaxByteSize.

Especifique la propiedad de atributo IsByteOrdered. El valor predeterminado es false.

Si omite algún campo en los métodos Read o Write, no se serializa el estado de ese campo.

Lo utilizan SqlUserDefinedTypeAttribute y SqlUserDefinedAggregateAttribute para indicar el formato de serialización de un tipo definido por el usuario (UDT) o agregado.

El ejemplo siguiente muestra el atributo UserDefinedType del UDT Punto. El UDT está ordenado por bytes, se denomina "Punto", tiene un método de validación denominado "ValidatePoint" y utiliza el formato de serialización nativo.


[Serializable]
[Microsoft.SqlServer.Server.SqlUserDefinedType(Format.Native,
     IsByteOrdered=true,  
     Name="Point",ValidationMethodName = "ValidatePoint")]
public struct Point : INullable
{


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft