SqlFacetAttribute Classe

Definizione

Spazio dei nomi:

Microsoft.Data.SqlClient.Server

Assembly:

Microsoft.Data.SqlClient.dll

Pacchetto:

Microsoft.Data.SqlClient v4.1.0

Annota il risultato di un tipo definito dall'utente (UDT) con informazioni aggiuntive che è possibile utilizzare in 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

Ereditarietà

Attribute

SqlFacetAttribute

Attributi

AttributeUsageAttribute

Commenti

SqlFacetAttribute può essere specificato solo nei valori restituiti non void.

SqlFacetAttribute viene usato solo per derivare informazioni sul tipo restituito e non è destinato a essere una specifica del vincolo su ciò che può essere archiviato nel tipo. Pertanto, se un campo ha una SqlFacetAttribute dimensione che indica la dimensione di 2 caratteri, il tipo SQL Server dell'espressione di accesso al campo è di dimensione 2, ma le assegnazioni nel campo non sono limitate da questo facet.

La tabella seguente acquisisce la matrice di valori validi per le varie proprietà per tipi di campo specifici. In questa tabella "Y" indica che la proprietà è valida e "N" indica che la proprietà non è valida.

L'oggetto specificato SqlFacetAttribute deve essere compatibile con il tipo di campo. Se la proprietà non è valida, la registrazione del tipo segnala un errore se l'utente specifica un valore non predefinito per la proprietà. I valori massimi per Precision e Scale le proprietà sono 38. Per la MaxSize proprietà, il valore deve trovarsi nell'intervallo di 1-8000 per i dati binari e non Unicode, 1-4000 per i dati Unicode o -1. Tutti gli altri valori non sono validi.

Type	IsFixedLength	MaxSize	Precisione	Scalabilità	IsNullable
SqlBoolean	N	N	N	N	S
SqlByte	N	N	N	N	S
SqlInt16	N	N	N	N	S
SqlInt32	N	N	N	N	S
SqlInt64	N	N	N	N	S
SqlSingle	N	N	N	N	S
SqlDouble	N	N	N	N	S
SqlDateTime	N	N	N	N	S
SqlMoney	N	N	N	N	S
SqlGuid	N	N	N	N	S
SqlDecimal	N	N	S	S	S
SqlString	S	S	N	N	S
SqlBinary	S	S	N	N	S
SqlXml	N	N	N	N	S
SqlBytes	S	S	N	N	S
SqlChars	S	S	N	N	S
Tipi definiti dall'utente incorporati	N	N	N	N	S
String	S	S	N	N	S
Byte[]	S	S	N	N	S
Char[]	S	S	N	N	S
DateTime	N	N	N	S1	N
Decimal	N	N	S	S	S

(1) Se si specifica la scala su un tipo DateTime, il valore verrà restituito a Transact-SQL come tipo DateTime2 con la scala specificata.

Costruttori

SqlFacetAttribute()

Attributo facoltativo su un tipo restituito di un tipo definito dall'utente (UDT), utilizzato per annotare il risultato con informazioni aggiuntive che possono essere impiegate in Transact-SQL.

Proprietà

IsFixedLength	Indica se il tipo restituito del tipo definito dall'utente ha lunghezza fissa.
IsNullable	Indica se il tipo restituito del tipo definito dall'utente può essere null.
MaxSize	Dimensione massima, in unità logiche, del tipo di campo sottostante del tipo definito dall'utente.
Precision	Precisione del tipo restituito del tipo definito dall'utente.
Scale	Scala del tipo restituito del tipo definito dall'utente.