DataCommand (Clase)
Proporciona la capacidad de compilar y ejecutar comandos de datos de distintos tipos de orígenes de datos, y recuperar resultados de solo lectura o un código de estado del comando.
Jerarquía de herencia
System.Object
Microsoft.VisualStudio.Data.DataCommand
Espacio de nombres: Microsoft.VisualStudio.Data
Ensamblado: Microsoft.VisualStudio.Data (en Microsoft.VisualStudio.Data.dll)
Sintaxis
'Declaración
<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")> _
Public MustInherit Class DataCommand
[GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public abstract class DataCommand
[GuidAttribute(L"E19F79F4-3219-423d-97A4-5A2B8A8F45F3")]
public ref class DataCommand abstract
[<AbstractClass>]
[<GuidAttribute("E19F79F4-3219-423d-97A4-5A2B8A8F45F3")>]
type DataCommand = class end
public abstract class DataCommand
El tipo DataCommand expone los siguientes miembros.
Constructores
Nombre | Descripción | |
---|---|---|
DataCommand | Constructor de clase.Crea una nueva instancia de la clase DataCommand. |
Arriba
Métodos
Nombre | Descripción | |
---|---|---|
CreateParameter | Crea un objeto de parámetro que se puede pasar en el DeriveSchema, el Execute o métodos de ExecuteWithoutResultsen una instancia de clase de DataCommand. | |
DeriveParameters | Deriva los parámetros que se pueden especificar para un comando especificado. | |
DeriveSchema | Deriva el esquema devuelto por un comando especificado, indicando el diseño de los elementos y de bloques en un lector de datos. | |
Equals | Determina si el objeto especificado es igual al objeto actual. (Se hereda de Object). | |
Execute | Ejecuta un comando especificado, opcionalmente con parámetros, y readonly de retornos de resultados. | |
ExecuteWithoutResults | Ejecuta un comando, opcionalmente con parámetros, pero no solicita resultados, sino devuelve un entero que indica el resultado de la llamada. | |
Finalize | Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object). | |
GetHashCode | Actúa como función hash para un tipo concreto. (Se hereda de Object). | |
GetType | Obtiene el objeto Type de la instancia actual. (Se hereda de Object). | |
MemberwiseClone | Crea una copia superficial del objeto Object actual. (Se hereda de Object). | |
Prepare | Prepara el comando especificado en el origen de datos de ejecutarse; el comando puede ser ejecutado varias veces, con parámetros diferentes. | |
ToString | Devuelve una cadena que representa el objeto actual. (Se hereda de Object). |
Arriba
Comentarios
Los proveedores de DDEX pueden ejecutar diferentes tipos de comandos en el origen de datos.Esto no se puede incluir, pero restringir a, las instrucciones SQL, procedimientos, y las llamadas de función.También pueden exponer la capacidad de preparar y de derivar parámetros y los esquemas para los comandos.
La clase de DataCommand introduce el concepto de un tipo de comando.Un tipo de comando indica una interpretación mediante programación de una cadena de comando especificada.Por ejemplo, un tipo de comando “texto” podría indicar al proveedor de DDEX que la cadena de comando es una instrucción SQL que se debe ejecutar directamente.Por otra parte, un tipo de comando “TabularFunction” podría indicar al proveedor de DDEX que la cadena de comando es el nombre de una función con valores de tabla que debe ejecutarse mediante el método apropiado.
Las tecnologías subyacentes tienen como ODBC, OLE DB, y try ADO.NET de enumerar un conjunto de tipos de comandos permitidos, normalmente como texto sin formato, en forma de tabla, o como procedimientos almacenados.La clase de DataCommand extiende este concepto relajando el requisito de que este tipo de comando se origina en una enumeración fija.Esto proporciona flexibilidad sin permitiendo que los proveedores de DDEX agreguen tipos de comando personalizado, incluidas las descripciones de cómo y cuando los comandos se pueden utilizar.
[!NOTA]
Para proporcionar capacidad de la ejecución del comando, pero de forma asincrónica, utilice la clase de DataAsyncCommand, que tiene un conjunto de métodos equivalentes a los en la clase de DataCommand , pero que funcione de forma asincrónica.
Las clases derivadas de la clase de DataCommand deben implementar los métodos que son compatibles con su implementación de proveedor de DDEX.La implementación base de cada método produce simplemente NotSupportedException.
Seguridad para subprocesos
Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.