SqlDependency.Start Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia.
Sobrecargas
| Nombre | Description |
|---|---|
| Start(String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión. |
| Start(String, String) |
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión mediante la cola de Service Broker SQL Server especificada. |
Comentarios
El agente de escucha SqlDependency se reiniciará cuando se produzca un error en la conexión SQL Server.
Se pueden realizar varias llamadas al Start método, sujetas a las restricciones siguientes:
Varias llamadas con parámetros idénticos (las mismas credenciales de cadena de conexión y Windows en el subproceso de llamada) son válidas.
Varias llamadas con diferentes cadenas de conexión son válidas siempre que:
Cada cadena de conexión especifica una base de datos diferente o
Cada cadena de conexión especifica un usuario diferente o
Las llamadas proceden de dominios de aplicación diferentes.
Puede hacer que el SqlDependency trabajo funcione correctamente para las aplicaciones que usan varios subprocesos para representar credenciales de usuario diferentes sin conceder el rol dbo al grupo, ya que diferentes usuarios pueden suscribirse y escuchar (mediante SqlCacheDependency o SqlCommand) a una cola de notificaciones creada por un administrador. Cuando se inicie el dominio de aplicación correspondiente, llame a Start with the (Windows) credentials of a user that has permission to initialize a service/queue (los permisos CREATE QUEUE y CREATE SERVICE para la base de datos). Asegúrese de que solo se llama a Start una vez por AppDomain; de lo contrario, se genera una excepción de ambigüedad. El subproceso de usuario debe tener permiso para suscribirse a la notificación (el permiso SUBSCRIBE QUERY NOTIFICATIONS para la base de datos). SqlDependency asociará la solicitud de suscripción de un usuario que no sea administrador al servicio o cola creado por el administrador.
Start(String)
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión.
public:
static bool Start(System::String ^ connectionString);public static bool Start(string connectionString);static member Start : string -> boolPublic Shared Function Start (connectionString As String) As BooleanParámetros
- connectionString
- String
El cadena de conexión de la instancia de SQL Server desde la que obtener notificaciones de cambios.
Devoluciones
true si el agente de escucha se inicializó correctamente; false si ya existe un agente de escucha compatible.
Excepciones
El connectionString parámetro es NULL.
El connectionString parámetro es el mismo que una llamada anterior a este método, pero los parámetros son diferentes.
Se llamó al método desde clR.
El autor de la llamada no tiene el permiso de seguridad de acceso al código (CAS) necesario SqlClientPermission .
Se ha realizado una llamada posterior al método con un parámetro equivalente connectionString con un usuario diferente o un usuario que no tiene como valor predeterminado el mismo esquema.
Además, todas las excepciones SqlClient subyacentes.
Comentarios
Este método inicia el agente de escucha de la AppDomain para recibir notificaciones de dependencia de la instancia de SQL Server especificada por el parámetro connectionString. Se puede llamar a este método más de una vez con cadenas de conexión diferentes para varios servidores.
Para obtener comentarios adicionales, vea Start.
Consulte también
Se aplica a
Start(String, String)
Inicia el agente de escucha para recibir notificaciones de cambio de dependencia desde la instancia de SQL Server especificada por el cadena de conexión mediante la cola de Service Broker SQL Server especificada.
public:
static bool Start(System::String ^ connectionString, System::String ^ queue);public static bool Start(string connectionString, string queue);static member Start : string * string -> boolPublic Shared Function Start (connectionString As String, queue As String) As BooleanParámetros
- connectionString
- String
El cadena de conexión de la instancia de SQL Server desde la que obtener notificaciones de cambios.
- queue
- String
Una cola de SQL Server Service Broker existente que se va a usar. Si nulles , se usa la cola predeterminada.
Devoluciones
true si el agente de escucha se inicializó correctamente; false si ya existe un agente de escucha compatible.
Excepciones
El connectionString parámetro es NULL.
El connectionString parámetro es el mismo que una llamada anterior a este método, pero los parámetros son diferentes.
Se llamó al método desde clR.
El autor de la llamada no tiene el permiso de seguridad de acceso al código (CAS) necesario SqlClientPermission .
Se ha realizado una llamada posterior al método con un parámetro equivalente, pero un usuario diferente connectionString , o un usuario que no tiene como valor predeterminado el mismo esquema.
Además, todas las excepciones SqlClient subyacentes.
Comentarios
Este método inicia el agente de escucha de la AppDomain para recibir notificaciones de dependencia de la instancia de SQL Server especificada por el parámetro connectionString. Se puede llamar a este método más de una vez con cadenas de conexión diferentes para varios servidores.
Si no se especifica ningún nombre de cola, SqlDependency crea una cola temporal y un servicio en el servidor que se usa para todo el proceso, incluso si el proceso implica más de un AppDomain. La cola y el servicio se quitan automáticamente tras el apagado de la aplicación.
Para obtener comentarios adicionales, vea Start.