SqlMethodAttribute Classe

Definizione

Indica il determinismo e le proprietà di accesso ai dati di un metodo o una proprietà su un tipo definito dall'utente (UDT).Indicates the determinism and data access properties of a method or property on a user-defined type (UDT). Le proprietà dell'attributo riflettono le caratteristiche fisiche utilizzate quando il tipo viene registrato con SQL Server.The properties on the attribute reflect the physical characteristics that are used when the type is registered with SQL Server.

public ref class SqlMethodAttribute sealed : Microsoft::SqlServer::Server::SqlFunctionAttribute
[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
[System.Serializable]
public sealed class SqlMethodAttribute : Microsoft.SqlServer.Server.SqlFunctionAttribute
type SqlMethodAttribute = class
    inherit SqlFunctionAttribute
Public NotInheritable Class SqlMethodAttribute
Inherits SqlFunctionAttribute
Ereditarietà
Attributi

Esempi

Nell'esempio seguente viene illustrato un metodo con tipo definito dall'utente con attributi per indicare che il metodo non verrà richiamato sulle istanze null del tipo, che il metodo non modificherà lo stato del tipo e che il metodo non verrà chiamato quando null i parametri sono fornito alla chiamata del metodo.The following example shows a UDT method that is attributed to indicate that the method will not be invoked on null instances of the type, that the method will not change the state of the type, and that the method will not be called when null parameters are supplied to the method invocation.

// Distance from Point to the specified x and y values method.
[SqlMethod(OnNullCall = false, IsMutator=false, InvokeIfReceiverIsNull=false)]
public Double DistanceFromXY(Int32 iX, Int32 iY)
{
   return Math.Sqrt(Math.Pow(iX - _x, 2.0) + Math.Pow(iY - _y, 2.0));
}
' Distance from Point to the specified x and y values method.
<SqlMethod(OnNullCall:=False, IsMutator:=False, InvokeIfReceiverIsNull:=False)> _
Public Function DistanceFromXY(ByVal ix As Int32, ByVal iy As Int32) _
    As Double

    Return Math.Sqrt(Math.Pow(ix - _x, 2.0) + Math.Pow(iy - _y, 2.0))

End Function

Commenti

Per una proprietà, l' SqlMethodAttribute oggetto deve essere usato direttamente sul setter o sul Getter.For a property, the SqlMethodAttribute should be used on the setter or the getter directly.

SqlMethodAttributeeredita da un SqlFunctionAttribute, pertanto SqlMethodAttribute eredita i FillRowMethodName campi TableDefinition e da SqlFunctionAttribute.SqlMethodAttribute inherits from a SqlFunctionAttribute, so SqlMethodAttribute inherits the FillRowMethodName and TableDefinition fields from SqlFunctionAttribute. Si noti che non è possibile scrivere un metodo con valori di tabella, sebbene i nomi di questi campi possano suggerire che è possibile.Note that it is not possible to write a table-valued method, although the names of these fields might suggest that it is possible.

Costruttori

SqlMethodAttribute()

Attributo di un tipo definito dall'utente (UDT), utilizzato per indicare il determinismo e le proprietà di accesso ai dati di un metodo o di una proprietà su un UDT.An attribute on a user-defined type (UDT), used to indicate the determinism and data access properties of a method or a property on a UDT.

Proprietà

DataAccess

Indica se la funzione comporta l'accesso ai dati dell'utente memorizzati nell'istanza locale di SQL Server.Indicates whether the function involves access to user data stored in the local instance of SQL Server.

(Ereditato da SqlFunctionAttribute)
FillRowMethodName

Nome di un metodo della stessa classe usato per inserire una riga di dati nella tabella restituita dalla funzione con valori di tabella.The name of a method in the same class which is used to fill a row of data in the table returned by the table-valued function.

(Ereditato da SqlFunctionAttribute)
InvokeIfReceiverIsNull

Indica se SQL Server deve richiamare il metodo su istanze Null.Indicates whether SQL Server should invoke the method on null instances.

IsDeterministic

Indica se la funzione definita dall'utente è deterministica.Indicates whether the user-defined function is deterministic.

(Ereditato da SqlFunctionAttribute)
IsMutator

Indica se un metodo utilizzato su un tipo definito dall'utente (UDT) è un mutator.Indicates whether a method on a user-defined type (UDT) is a mutator.

IsPrecise

Indica se la funzione comporta calcoli imprecisi, come le operazioni in virgola mobile.Indicates whether the function involves imprecise computations, such as floating point operations.

(Ereditato da SqlFunctionAttribute)
Name

Nome di registrazione della funzione in SQL Server.The name under which the function should be registered in SQL Server.

(Ereditato da SqlFunctionAttribute)
OnNullCall

Indica se il metodo su un tipo definito dall'utente (UDT) viene chiamato quando gli argomenti di input null sono specificati nella chiamata al metodo.Indicates whether the method on a user-defined type (UDT) is called when null input arguments are specified in the method invocation.

SystemDataAccess

Indica se la funzione richiede l'accesso ai dati memorizzati nei cataloghi di sistema o nelle tabelle di sistema virtuali di SQL Server.Indicates whether the function requires access to data stored in the system catalogs or virtual system tables of SQL Server.

(Ereditato da SqlFunctionAttribute)
TableDefinition

Stringa che rappresenta la definizione di tabella dei risultati, se il metodo viene utilizzato come funzione con valori di tabella (TVF).A string that represents the table definition of the results, if the method is used as a table-valued function (TVF).

(Ereditato da SqlFunctionAttribute)
TypeId

Quando è implementata in una classe derivata, ottiene un identificatore univoco della classe Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Ereditato da Attribute)

Metodi

Equals(Object)

Restituisce un valore che indica se questa istanza è uguale a un oggetto specificato.Returns a value that indicates whether this instance is equal to a specified object.

(Ereditato da Attribute)
GetHashCode()

Restituisce il codice hash per l'istanza.Returns the hash code for this instance.

(Ereditato da Attribute)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
IsDefaultAttribute()

In caso di override in una classe derivata, indica se il valore di questa istanza è il valore predefinito per la classe derivata.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Ereditato da Attribute)
Match(Object)

Quando è sottoposto a override in una classe derivata, restituisce un valore che indica se questa istanza equivale a un oggetto specificato.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Ereditato da Attribute)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Implementazioni dell'interfaccia esplicita

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Esegue il mapping di un set di nomi a un set corrispondente di ID dispatch.Maps a set of names to a corresponding set of dispatch identifiers.

(Ereditato da Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera le informazioni sul tipo relative a un oggetto, che possono essere usate per ottenere informazioni sul tipo relative a un'interfaccia.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Ereditato da Attribute)
_Attribute.GetTypeInfoCount(UInt32)

Recupera il numero delle interfacce di informazioni sul tipo fornite da un oggetto (0 o 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Ereditato da Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornisce l'accesso a proprietà e metodi esposti da un oggetto.Provides access to properties and methods exposed by an object.

(Ereditato da Attribute)

Si applica a