SqlMethodAttribute Kelas

Definisi

Ruang nama:

Microsoft.SqlServer.Server

Rakitan:

Microsoft.SqlServer.Server.dll

Paket:

Microsoft.SqlServer.Server v1.0.0

Menunjukkan determinisme dan properti akses data dari metode atau properti pada jenis yang ditentukan pengguna (UDT). Properti pada atribut mencerminkan karakteristik fisik yang digunakan saat jenis terdaftar dengan 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

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
[<System.Serializable>]
type SqlMethodAttribute = class
    inherit SqlFunctionAttribute

Public NotInheritable Class SqlMethodAttribute
Inherits SqlFunctionAttribute

Warisan

Attribute

SqlFunctionAttribute

SqlMethodAttribute

Atribut

AttributeUsageAttribute SerializableAttribute

Contoh

Contoh berikut menunjukkan metode UDT yang dikaitkan untuk menunjukkan bahwa metode tidak akan dipanggil pada instans null dari jenis , bahwa metode tidak akan mengubah status jenis, dan bahwa metode tidak akan dipanggil ketika null parameter diberikan ke pemanggilan metode.

using Microsoft.Data.SqlClient.Server;
using System.Data.SqlTypes;
using System.Text;

[Serializable]
[Microsoft.Data.SqlClient.Server.SqlUserDefinedType(Format.Native,
     IsByteOrdered = true,
     Name = "Point", ValidationMethodName = "ValidatePoint")]
public struct Point : INullable
{

    private bool is_Null;
    private Int32 _x;
    private Int32 _y;

    // 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));
    }

Keterangan

Untuk properti, SqlMethodAttribute harus digunakan pada setter atau getter secara langsung.

SqlMethodAttribute mewarisi dari SqlFunctionAttribute, sehingga SqlMethodAttribute mewarisi FillRowMethodName bidang dan TableDefinition dari SqlFunctionAttribute. Perhatikan bahwa tidak dimungkinkan untuk menulis metode bernilai tabel, meskipun nama-nama bidang ini mungkin menunjukkan bahwa itu mungkin.

Konstruktor

SqlMethodAttribute()

Atribut pada jenis yang ditentukan pengguna (UDT), digunakan untuk menunjukkan determinisme dan properti akses data metode atau properti pada UDT.

Properti

DataAccess	Menunjukkan apakah fungsi melibatkan akses ke data pengguna yang disimpan dalam instans lokal SQL Server. (Diperoleh dari SqlFunctionAttribute)
FillRowMethodName	Nama metode di kelas yang sama yang digunakan untuk mengisi baris data dalam tabel yang dikembalikan oleh fungsi bernilai tabel. (Diperoleh dari SqlFunctionAttribute)
InvokeIfReceiverIsNull	Menunjukkan apakah SQL Server harus memanggil metode pada instans null.
IsDeterministic	Menunjukkan apakah fungsi yang ditentukan pengguna bersifat deterministik. (Diperoleh dari SqlFunctionAttribute)
IsMutator	Menunjukkan apakah metode pada jenis yang ditentukan pengguna (UDT) adalah mutator.
IsPrecise	Menunjukkan apakah fungsi melibatkan komputasi yang tidak tepat, seperti operasi floating point. (Diperoleh dari SqlFunctionAttribute)
Name	Nama tempat fungsi harus didaftarkan di SQL Server. (Diperoleh dari SqlFunctionAttribute)
OnNullCall	Menunjukkan apakah metode pada jenis yang ditentukan pengguna (UDT) dipanggil ketika null argumen input ditentukan dalam pemanggilan metode.
SystemDataAccess	Menunjukkan apakah fungsi memerlukan akses ke data yang disimpan dalam katalog sistem atau tabel sistem virtual SQL Server. (Diperoleh dari SqlFunctionAttribute)
TableDefinition	String yang mewakili definisi tabel hasil, jika metode digunakan sebagai fungsi bernilai tabel (TVF). (Diperoleh dari SqlFunctionAttribute)