SqlFacetAttribute Třída

Definice

Obor názvů:

Microsoft.Data.SqlClient.Server

Sestavení:

Microsoft.Data.SqlClient.dll

Balíček:

Microsoft.Data.SqlClient v4.1.0

Anotuje vrácený výsledek uživatelem definovaného typu (UDT) s dalšími informacemi, které lze použít v jazyce Transact-SQL.

public ref class SqlFacetAttribute : Attribute

[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)]
public class SqlFacetAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue, AllowMultiple=false, Inherited=false)>]
type SqlFacetAttribute = class
    inherit Attribute

Public Class SqlFacetAttribute
Inherits Attribute

Dědičnost

Attribute

SqlFacetAttribute

Atributy

AttributeUsageAttribute

Poznámky

SqlFacetAttribute je možné zadat pouze u neprázdných návratových hodnot.

SqlFacetAttribute se používá pouze k odvození informací o návratovém typu a není určen jako specifikace omezení toho, co lze uložit v typu. Pokud má SqlFacetAttribute tedy pole 2 znaky, znamená to, že SQL Server typ přístupového výrazu pole má velikost 2, ale přiřazení k poli nejsou touto omezující vlastností omezena.

Následující tabulka obsahuje matici platných hodnot pro různé vlastnosti pro konkrétní typy polí. V této tabulce "Y" označuje, že vlastnost je platná, a "N" označuje, že vlastnost není platná.

Zadaný SqlFacetAttribute typ musí být kompatibilní s typem pole. Pokud vlastnost není platná, bude registrace typu hlásit chybu, pokud uživatel zadá pro vlastnost non-výchozí hodnotu. Maximální hodnoty vlastností Precision a Scale jsou 38. MaxSize Pro vlastnost by hodnota měla být v rozsahu 1-8000 pro binární a non-Unicode data, 1-4000 pro data Unicode nebo -1. Všechny ostatní hodnoty nejsou platné.

Typ	IsFixedLength	Maxsize	Přesnost	Měřítko	Isnullable
SqlBoolean	N	N	N	N	Y
SqlByte	N	N	N	N	Y
SqlInt16	N	N	N	N	Y
SqlInt32	N	N	N	N	Y
SqlInt64	N	N	N	N	Y
SqlSingle	N	N	N	N	Y
SqlDouble	N	N	N	N	Y
SqlDateTime	N	N	N	N	Y
SqlMoney	N	N	N	N	Y
SqlGuid	N	N	N	N	Y
SqlDecimal	N	N	Y	Y	Y
SqlString	Y	Y	N	N	Y
SqlBinary	Y	Y	N	N	Y
SqlXml	N	N	N	N	Y
SqlBytes	Y	Y	N	N	Y
SqlChars	Y	Y	N	N	Y
Vložené UDT	N	N	N	N	Y
String	Y	Y	N	N	Y
Bajt[]	Y	Y	N	N	Y
Znak[]	Y	Y	N	N	Y
DateTime	N	N	N	Y1	N
Decimal	N	N	Y	Y	Y

(1) Určení měřítka typu DateTime způsobí, že se hodnota vrátí do Transact-SQL jako typ DateTime2 se zadaným měřítkem.

Konstruktory

SqlFacetAttribute()

Volitelný atribut u návratového typu definovaného uživatelem (UDT), který slouží k přidání poznámek k vráceným výsledkům s dalšími informacemi, které lze použít v jazyce Transact-SQL.

Vlastnosti

IsFixedLength	Určuje, zda návratový typ uživatelem definovaného typu má pevnou délku.
IsNullable	Určuje, jestli návratový typ uživatelem definovaného typu může být null.
MaxSize	Maximální velikost základního typu pole definovaného uživatelem v logických jednotkách.
Precision	Přesnost návratového typu uživatelem definovaného typu.
Scale	Měřítko návratového typu uživatelem definovaného typu.