SqlFacetAttribute Klasa

Definicja

Przestrzeń nazw:: Microsoft.Data.SqlClient.Server

Zestaw:: Microsoft.Data.SqlClient.dll

Pakiet:: Microsoft.Data.SqlClient v2.1.4

Pakiet:: Microsoft.Data.SqlClient v3.0.1

Pakiet:: Microsoft.Data.SqlClient v3.1.0

Pakiet:: Microsoft.Data.SqlClient v4.0.1

Pakiet:: Microsoft.Data.SqlClient v4.1.0

Pakiet:: Microsoft.Data.SqlClient v1.0.19269.1

Pakiet:: Microsoft.Data.SqlClient v1.1.4

Pakiet:: Microsoft.Data.SqlClient v2.0.1

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Umożliwia dodawanie adnotacji do zwróconego wyniku typu zdefiniowanego przez użytkownika (UDT) z dodatkowymi informacjami, których można użyć w języku 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

Dziedziczenie: Attribute
SqlFacetAttribute

Atrybuty: AttributeUsageAttribute

Uwagi

SqlFacetAttribute może być określona tylko dla wartości zwracanych nieważnych.

SqlFacetAttribute służy tylko do uzyskiwania informacji o typie zwracanym i nie jest przeznaczony do określenia ograniczenia, które mogą być przechowywane w typie. W związku z tym, jeśli pole ma wartość wskazującą SqlFacetAttribute jego rozmiar na 2 znaki, SQL Server typ wyrażenia dostępu do pola ma rozmiar 2, ale przypisania do pola nie są ograniczone przez ten aspekt.

W poniższej tabeli przedstawiono macierz prawidłowych wartości dla różnych właściwości określonych typów pól. W tej tabeli wartość "Y" wskazuje, że właściwość jest prawidłowa, a wartość "N" wskazuje, że właściwość jest nieprawidłowa.

Określony SqlFacetAttribute musi być zgodny z typem pola. Jeśli właściwość jest nieprawidłowa, typ rejestracji zgłosi błąd, jeśli użytkownik określi wartość inną niż domyślna dla właściwości. Maksymalna wartość właściwości Precision i Scale to 38. MaxSize Dla właściwości wartość powinna mieścić się w zakresie od 1 do 8000 dla danych binarnych i innych niż Unicode, 1–4000 dla danych Unicode lub -1. Wszystkie inne wartości są nieprawidłowe.

Typ	IsFixedLength	Maxsize	Dokładność	Skalowanie	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
Osadzone trasy zdefiniowane przez użytkownika	N	N	N	N	Y
String	Y	Y	N	N	Y
Bajt[]	Y	Y	N	N	Y
Char[]	Y	Y	N	N	Y
DateTime	N	N	N	Y¹	N
Decimal	N	N	Y	Y	Y

(1) Określenie skali typu DateTime spowoduje zwrócenie wartości do języka Transact-SQL jako typu DateTime2 z określoną skalą.

Konstruktory

Nazwa	Opis
SqlFacetAttribute()	Opcjonalny atrybut zwracanego typu zdefiniowanego przez użytkownika (UDT) używany do dodawania adnotacji do zwróconego wyniku z dodatkowymi informacjami, których można użyć w języku Transact-SQL.

Właściwości

Nazwa	Opis
IsFixedLength	Wskazuje, czy zwracany typ typu zdefiniowanego przez użytkownika ma stałą długość.
IsNullable	Wskazuje, czy zwracany typ typu zdefiniowanego przez użytkownika może mieć wartość `null`.
MaxSize	Maksymalny rozmiar w jednostkach logicznych bazowego typu pola zdefiniowanego przez użytkownika.
Precision	Precyzja zwracanego typu typu zdefiniowanego przez użytkownika.
Scale	Skala zwracanego typu typu zdefiniowanego przez użytkownika.

Dotyczy