SqlDependency Sınıf

Tanım

SqlDependencyNesnesi, bir uygulama ve bir SQL Server örneği arasındaki sorgu bildirim bağımlılığını temsil eder.The SqlDependency object represents a query notification dependency between an application and an instance of SQL Server. Bir uygulama bir nesne oluşturabilir SqlDependency ve olay işleyicisi aracılığıyla bildirim almak için kaydolabilirsiniz OnChangeEventHandler .An application can create a SqlDependency object and register to receive notifications via the OnChangeEventHandler event handler.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Devralma
SqlDependency

Açıklamalar

SqlDependency, ASP.NET uygulamanızın veya orta katman hizmetinizin bellekte önbelleğe alınmış belirli bilgileri tutması gereken önbelleğe alma senaryolarında idealdir.SqlDependency is ideal for caching scenarios, where your ASP.NET application or middle-tier service needs to keep certain information cached in memory. SqlDependencyÖnbelleğin yenilenebilmesi için veritabanındaki özgün veriler değiştiğinde bildirim almanızı sağlar.SqlDependency allows you to receive notifications when the original data in the database changes so that the cache can be refreshed.

Bir bağımlılık ayarlamak için bir SqlDependency nesneyi bir veya daha fazla nesneyle ilişkilendirmeniz gerekir SqlCommand .To set up a dependency, you need to associate a SqlDependency object to one or more SqlCommand objects. Bildirimleri almak için, olaya abone olmanız gerekir OnChange .To receive notifications, you need to subscribe to the OnChange event. Bildirimler için sorgu oluşturma gereksinimleri hakkında daha fazla bilgi için bkz. Query Notifications Ile çalışma.For more information about the requirements for creating queries for notifications, see Working with Query Notifications.

Not

SqlDependency, veritabanı için etkin bağımlılıklara sahip görece az sayıda sunucu olduğu ASP.NET veya orta katmanlı hizmetlerde kullanılmak üzere tasarlanmıştır.SqlDependency was designed to be used in ASP.NET or middle-tier services where there is a relatively small number of servers having dependencies active against the database. Yüzlerce veya binlerce istemci bilgisayarda SqlDependency tek bir veritabanı sunucusu için nesnelerin ayarlandığı istemci uygulamalarında kullanılmak üzere tasarlanmamıştır.It was not designed for use in client applications, where hundreds or thousands of client computers would have SqlDependency objects set up for a single database server. Veriler değiştiğinde güvenilir alt-ikinci bildirimlere ihtiyacınız olan bir uygulama geliştiriyorsanız, etkili bir sorgu bildirimleri stratejisi planlama ve bildirim planlaması makalesinde sorgu bildirimlerinin alternatiflerini planlama başlıklı bölümleri gözden geçirin.If you are developing an application where you need reliable sub-second notifications when data changes, review the sections Planning an Efficient Query Notifications Strategy and Alternatives to Query Notifications in the Planning for Notifications article.

Daha fazla bilgi için bkz. SQL Server sorgulama bildirimleri ve bildirim çözümleri oluşturma.For more information, see Query Notifications in SQL Server and Building Notification Solutions.

Not

OnChangeOlay, komut yürütmesini başlatan iş parçacığından farklı bir iş parçacığında oluşturulabilir.The OnChange event may be generated on a different thread from the thread that initiated command execution.

Sorgu bildirimleri yalnızca belirli bir gereksinimler listesini karşılayan SELECT deyimleri için desteklenir.Query notifications are supported only for SELECT statements that meet a list of specific requirements.

Oluşturucular

SqlDependency()

Varsayılan ayarlarla sınıfının yeni bir örneğini oluşturur SqlDependency .Creates a new instance of the SqlDependency class with the default settings.

SqlDependency(SqlCommand)

Sınıfının yeni bir örneğini oluşturur SqlDependency ve SqlCommand parametresiyle ilişkilendirir.Creates a new instance of the SqlDependency class and associates it with the SqlCommand parameter.

SqlDependency(SqlCommand, String, Int32)

Sınıfının yeni bir örneğini oluşturur SqlDependency , SqlCommand parametresiyle ilişkilendirir ve bildirim seçeneklerini ve bir zaman aşımı değerini belirtir.Creates a new instance of the SqlDependency class, associates it with the SqlCommand parameter, and specifies notification options and a time-out value.

Özellikler

HasChanges

Bağımlılık ile ilişkili sonuç kümelerinden birinin değişip değişmediğini gösteren bir değer alır.Gets a value that indicates whether one of the result sets associated with the dependency has changed.

Id

Sınıfının bu örneğini benzersiz bir şekilde tanımlayan bir değer alır SqlDependency .Gets a value that uniquely identifies this instance of the SqlDependency class.

Yöntemler

AddCommandDependency(SqlCommand)

Bir SqlCommand nesneyi bu örnekle ilişkilendirir SqlDependency .Associates a SqlCommand object with this SqlDependency instance.

Equals(Object)

Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler.Determines whether the specified object is equal to the current object.

(Devralındığı yer: Object)
GetHashCode()

Varsayılan karma işlevi olarak işlev görür.Serves as the default hash function.

(Devralındığı yer: Object)
GetType()

TypeGeçerli örneği alır.Gets the Type of the current instance.

(Devralındığı yer: Object)
MemberwiseClone()

Geçerli bir basit kopyasını oluşturur Object .Creates a shallow copy of the current Object.

(Devralındığı yer: Object)
Start(String)

Bağlantı dizesi tarafından belirtilen SQL Server örneğinden bağımlılık değişikliği bildirimleri almak için dinleyiciyi başlatır.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string.

Start(String, String)

Belirtilen SQL Server Hizmet Aracısı kuyruğu kullanılarak bağlantı dizesi tarafından belirtilen SQL Server örneğinden bağımlılık değişikliği bildirimleri almak için dinleyiciyi başlatır.Starts the listener for receiving dependency change notifications from the instance of SQL Server specified by the connection string using the specified SQL Server Service Broker queue.

Stop(String)

Önceki çağrıda belirtilen bir bağlantı için dinleyiciyi sonlandırır Start .Stops a listener for a connection specified in a previous Start call.

Stop(String, String)

Önceki çağrıda belirtilen bir bağlantı için dinleyiciyi sonlandırır Start .Stops a listener for a connection specified in a previous Start call.

ToString()

Geçerli nesneyi temsil eden dizeyi döndürür.Returns a string that represents the current object.

(Devralındığı yer: Object)

Ekinlikler

OnChange

Bu nesneyle ilişkili komutlardan herhangi biri için bir bildirim alındığında gerçekleşir SqlDependency .Occurs when a notification is received for any of the commands associated with this SqlDependency object.

Şunlara uygulanır

Ayrıca bkz.