SqlMethodAttribute SqlMethodAttribute SqlMethodAttribute SqlMethodAttribute Class

Definición

Indica el determinismo y las propiedades de acceso a datos de un método o una propiedad en un tipo definido por el usuario (UDT).Indicates the determinism and data access properties of a method or property on a user-defined type (UDT). Las propiedades en el atributo reflejan las características físicas que se utilizan al registrarse el tipo 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
Herencia
Atributos

Ejemplos

En el ejemplo siguiente se muestra un método UDT atribuido para indicar que el método no se invocará en instancias nulas del tipo, que el método no cambiará el estado del tipo y que no se llamará al método cuando null los parámetros sean proporcionado a la invocación del método.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

Comentarios

En el caso de una SqlMethodAttribute propiedad, el debe usarse en el establecedor o el captador directamente.For a property, the SqlMethodAttribute should be used on the setter or the getter directly.

SqlMethodAttributeSqlFunctionAttributehereda de, de modo que SqlMethodAttribute hereda los FillRowMethodName campos y TableDefinition de. SqlFunctionAttributeSqlMethodAttribute inherits from a SqlFunctionAttribute, so SqlMethodAttribute inherits the FillRowMethodName and TableDefinition fields from SqlFunctionAttribute. Tenga en cuenta que no es posible escribir un método con valores de tabla, aunque los nombres de estos campos podrían sugerir que es posible.Note that it is not possible to write a table-valued method, although the names of these fields might suggest that it is possible.

Constructores

SqlMethodAttribute() SqlMethodAttribute() SqlMethodAttribute() SqlMethodAttribute()

Atributo en un tipo definido por el usuario (UDT), que se utiliza para indicar el determinismo y las propiedades de acceso a datos de un método o una propiedad en 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.

Propiedades

DataAccess DataAccess DataAccess DataAccess

Indica si la función implica acceso a los datos de usuario almacenados en la instancia local de SQL Server.Indicates whether the function involves access to user data stored in the local instance of SQL Server.

(Inherited from SqlFunctionAttribute)
FillRowMethodName FillRowMethodName FillRowMethodName FillRowMethodName

El nombre de un método de la misma clase que se usa para rellenar una fila de datos en la tabla devuelta por la función con valores de tabla.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.

(Inherited from SqlFunctionAttribute)
InvokeIfReceiverIsNull InvokeIfReceiverIsNull InvokeIfReceiverIsNull InvokeIfReceiverIsNull

Indica si SQL Server debe invocar el método en las instancias null.Indicates whether SQL Server should invoke the method on null instances.

IsDeterministic IsDeterministic IsDeterministic IsDeterministic

Indica si la función definida por el usuario es determinista.Indicates whether the user-defined function is deterministic.

(Inherited from SqlFunctionAttribute)
IsMutator IsMutator IsMutator IsMutator

Indica si un método en un tipo definido por el usuario (UDT) es un mutador.Indicates whether a method on a user-defined type (UDT) is a mutator.

IsPrecise IsPrecise IsPrecise IsPrecise

Indica si la función implica cálculos imprecisos, como las operaciones de punto flotante.Indicates whether the function involves imprecise computations, such as floating point operations.

(Inherited from SqlFunctionAttribute)
Name Name Name Name

Nombre con el que debe registrarse la función en SQL Server.The name under which the function should be registered in SQL Server.

(Inherited from SqlFunctionAttribute)
OnNullCall OnNullCall OnNullCall OnNullCall

Indica si se llama al método en un tipo definido por el usuario (UDT) cuando se especifican los argumentos de entrada null en la invocación del método.Indicates whether the method on a user-defined type (UDT) is called when null input arguments are specified in the method invocation.

SystemDataAccess SystemDataAccess SystemDataAccess SystemDataAccess

Indica si la función requiere acceso a los datos almacenados en los catálogos del sistema o las tablas de sistema virtuales de SQL Server.Indicates whether the function requires access to data stored in the system catalogs or virtual system tables of SQL Server.

(Inherited from SqlFunctionAttribute)
TableDefinition TableDefinition TableDefinition TableDefinition

Cadena que representa la definición de tabla de los resultados si el método se utiliza como una función con valores de tabla (TVF).A string that represents the table definition of the results, if the method is used as a table-valued function (TVF).

(Inherited from SqlFunctionAttribute)
TypeId TypeId TypeId TypeId

Cuando se implementa en una clase derivada, obtiene un identificador único para este Attribute.When implemented in a derived class, gets a unique identifier for this Attribute.

(Inherited from Attribute)

Métodos

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Devuelve un valor que indica si esta instancia es igual que un objeto especificado.Returns a value that indicates whether this instance is equal to a specified object.

(Inherited from Attribute)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Devuelve el código hash de esta instancia.Returns the hash code for this instance.

(Inherited from Attribute)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute() IsDefaultAttribute()

Si se reemplaza en una clase derivada, indica si el valor de esta instancia es el valor predeterminado de la clase derivada.When overridden in a derived class, indicates whether the value of this instance is the default value for the derived class.

(Inherited from Attribute)
Match(Object) Match(Object) Match(Object) Match(Object)

Cuando se invalida en una clase derivada, devuelve un valor que indica si esta instancia es igual a un objeto especificado.When overridden in a derived class, returns a value that indicates whether this instance equals a specified object.

(Inherited from Attribute)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del objeto Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Implementaciones de interfaz explícitas

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

Asigna un conjunto de nombres a un conjunto correspondiente de identificadores de envío.Maps a set of names to a corresponding set of dispatch identifiers.

(Inherited from Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr) _Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

Obtiene la información de tipos de un objeto, que puede utilizarse para obtener la información de tipos de una interfaz.Retrieves the type information for an object, which can be used to get the type information for an interface.

(Inherited from Attribute)
_Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32) _Attribute.GetTypeInfoCount(UInt32)

Recupera el número de interfaces de información de tipo que proporciona un objeto (0 ó 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

(Inherited from Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Proporciona acceso a las propiedades y los métodos expuestos por un objeto.Provides access to properties and methods exposed by an object.

(Inherited from Attribute)

Se aplica a