SqlDependency Klass

Definition

Namnområde:
System.Data.SqlClient
Sammansättning:
System.Data.dll
Källa:
System.Data.SqlClient.notsupported.cs

objektet SqlDependency representerar ett frågemeddelandeberoende mellan ett program och en instans av SQL Server. Ett program kan skapa ett SqlDependency objekt och registrera sig för att ta emot meddelanden via OnChangeEventHandler händelsehanteraren.

public ref class SqlDependency sealed
public sealed class SqlDependency
type SqlDependency = class
Public NotInheritable Class SqlDependency
Arv
Object
SqlDependency

Kommentarer

SqlDependency är perfekt för cachelagringsscenarier, där ditt ASP.NET program eller mellannivåtjänst måste ha viss information cachelagrad i minnet. SqlDependency gör att du kan ta emot meddelanden när de ursprungliga data i databasen ändras så att cacheminnet kan uppdateras.

Om du vill konfigurera ett beroende måste du associera ett SqlDependency objekt med ett eller flera SqlCommand objekt. Om du vill ta emot meddelanden måste du prenumerera på OnChange händelsen. Mer information om kraven för att skapa frågor för meddelanden finns i Arbeta med frågemeddelanden.

Note

SqlDependency har utformats för att användas i ASP.NET eller mellannivåtjänster där det finns ett relativt litet antal servrar som har beroenden aktiva mot databasen. Den har inte utformats för användning i klientprogram, där hundratals eller tusentals klientdatorer skulle ha SqlDependency objekt konfigurerade för en enda databasserver. Om du utvecklar ett program där du behöver tillförlitliga meddelanden under sekunden när data ändras läser du avsnitten Planera en strategi för effektiva frågemeddelanden och alternativ till frågemeddelanden i artikeln Planera för meddelanden .

Mer information finns i Query Notifications in SQL Server and Building Notification Solutions.

Note

Händelsen OnChange kan genereras på en annan tråd än den tråd som initierade kommandokörningen.

Frågemeddelanden stöds endast för SELECT-instruktioner som uppfyller en lista med specifika krav.

Konstruktorer

Name Description
SqlDependency()

Skapar en ny instans av SqlDependency klassen med standardinställningarna.
SqlDependency(SqlCommand, String, Int32)

Skapar en ny instans av SqlDependency klassen, associerar den med parametern SqlCommand och anger meddelandealternativ och ett timeout-värde.
SqlDependency(SqlCommand)

Skapar en ny instans av SqlDependency klassen och associerar den med parametern SqlCommand .

Egenskaper

Name Description
HasChanges

Hämtar ett värde som anger om en av de resultatuppsättningar som är associerade med beroendet har ändrats.
Id

Hämtar ett värde som unikt identifierar den här instansen SqlDependency av klassen.

Metoder

Name Description
AddCommandDependency(SqlCommand)

Associerar ett SqlCommand objekt med den här SqlDependency instansen.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
Start(String, String)

Startar lyssnaren för att ta emot meddelanden om beroendeändring från instansen av SQL Server som anges av reťazec pripojenia med den angivna SQL Server Service Broker-kön.
Start(String)

Startar lyssnaren för att ta emot meddelanden om beroendeändringar från instansen av SQL Server som anges av reťazec pripojenia.
Stop(String, String)

Stoppar en lyssnare för en anslutning som angavs i ett tidigare Start anrop.
Stop(String)

Stoppar en lyssnare för en anslutning som angavs i ett tidigare Start anrop.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Händelser

Name Description
OnChange

Inträffar när ett meddelande tas emot för något av de kommandon som är associerade med det här SqlDependency objektet.

Gäller för

Se även