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.

Vea también

Referencia

Microsoft.VisualStudio.Data (Espacio de nombres)

DataCommandType