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.Framework.DataSiteableObject<IVsDataConnection>
    Microsoft.VisualStudio.Data.Framework.DataCommand

Espacio de nombres:  Microsoft.VisualStudio.Data.Framework
Ensamblado:  Microsoft.VisualStudio.Data.Framework (en Microsoft.VisualStudio.Data.Framework.dll)

Sintaxis

'Declaración
Public MustInherit Class DataCommand _
    Inherits DataSiteableObject(Of IVsDataConnection) _
    Implements IVsDataCommand

public abstract class DataCommand : DataSiteableObject<IVsDataConnection>, 
    IVsDataCommand

public ref class DataCommand abstract : public DataSiteableObject<IVsDataConnection^>, 
    IVsDataCommand

[<AbstractClass>]
type DataCommand =  
    class
        inherit DataSiteableObject<IVsDataConnection>
        interface IVsDataCommand
    end

public abstract class DataCommand extends DataSiteableObject<IVsDataConnection> implements IVsDataCommand

El tipo DataCommand expone los siguientes miembros.

Constructores

	Nombre	Descripción
	DataCommand()	Inicializa una nueva instancia de la clase DataCommand.
	DataCommand(IVsDataConnection)	Inicializa una nueva instancia de la clase de DataCommand junto con un objeto de conexión de datos.

Arriba

Propiedades

	Nombre	Descripción
	Site	Obtiene o establece el sitio del objeto. (Se hereda de DataSiteableObject<T>).

Arriba

Métodos

	Nombre	Descripción
	CreateParameter	Crea un objeto de parámetro que se puede pasar en el DeriveSchema, el DeriveSchema, el Execute, o métodos de ExecuteWithoutResults en una instancia de DataCommand .
	DeriveParameters(String)	Deriva los parámetros que se pueden especificar para un comando especificado.
	DeriveParameters(String, DataCommandType)	Deriva los parámetros que se pueden especificar para un comando especificado.
	DeriveParameters(String, DataCommandType, Int32)	Deriva los parámetros que se pueden especificar para un comando especificado.
	DeriveSchema(String)	Deriva el esquema devuelto por un comando especificado.El esquema indica el diseño de los elementos y de bloques en un lector de datos.
	DeriveSchema(String, DataCommandType)	Deriva el esquema devuelto por un comando especificado.El esquema indica el diseño de los elementos y de bloques en un lector de datos.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[])	Deriva el esquema devuelto por un comando especificado.El esquema indica el diseño de los elementos y de bloques en un lector de datos.
	DeriveSchema(String, DataCommandType, array<IVsDataParameter[], Int32)	Deriva el esquema devuelto por un comando especificado.El esquema indica 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(String)	Ejecuta un comando especificado y devuelve resultados de solo lectura.
	Execute(String, DataCommandType)	Ejecuta un comando especificado y devuelve resultados de solo lectura.
	Execute(String, DataCommandType, array<IVsDataParameter[])	Ejecuta un comando especificado, opcionalmente con parámetros, y readonly de retornos de resultados.
	Execute(String, DataCommandType, array<IVsDataParameter[], Int32)	Ejecuta un comando especificado, opcionalmente con parámetros, y readonly de retornos de resultados.
	ExecuteWithoutResults(String)	Ejecuta un comando y no solicita resultados, sino devuelve un entero que indica el resultado de la llamada.
	ExecuteWithoutResults(String, DataCommandType)	Ejecuta un comando y no solicita resultados, sino devuelve un entero que indica el resultado de la llamada.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[])	Ejecuta un comando, opcionalmente con parámetros, pero no solicita resultados, sino devuelve un entero que indica el resultado de la llamada.
	ExecuteWithoutResults(String, DataCommandType, array<IVsDataParameter[], Int32)	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).
	OnSiteChanged	Genera el evento SiteChanged. (Se hereda de DataSiteableObject<T>).
	Prepare(String)	Prepara el comando especificado en el origen de datos de ejecutarse; el comando puede ser ejecutado varias veces, con parámetros diferentes.
	Prepare(String, DataCommandType)	Prepara el comando especificado en el origen de datos de ejecutarse; el comando puede ser ejecutado varias veces, con parámetros diferentes.
	Prepare(String, DataCommandType, array<IVsDataParameter[])	Prepara el comando especificado en el origen de datos de ejecutarse; el comando puede ser ejecutado varias veces, con parámetros diferentes.
	Prepare(String, DataCommandType, array<IVsDataParameter[], Int32)	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

Eventos

	Nombre	Descripción
	SiteChanged	Se produce cuando cambia la propiedad Site. (Se hereda de DataSiteableObject<T>).

Arriba

Comentarios

Los proveedores de Diseñador Extensibility (DDEX) de datos pueden ejecutar diferentes tipos de comandos en un 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 muestra los tipos de comando.Un tipo de comando indica una interpretación mediante programación de una cadena de comando especificada.Por ejemplo, un texto de tipo de comando podría notificar al proveedor de DDEX que la cadena de comando es una instrucción SQL que se debe ejecutar directamente.Alternativamente, un tipo de comando de TabularFunction podría notificar 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.

Tecnologías subyacentes como ODBC, OLE DB, y intento de 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 habilitar los proveedores de DDEX para agregar tipos de comando personalizado, junto con una descripción de cómo y cuando los comandos se pueden utilizar.

[!NOTA]

Para proporcionar capacidad de la ejecución de comandos asincrónica, utilice la clase de DataAsyncCommand .Esta clase tiene un conjunto de métodos que son equivalentes a los de la clase de DataCommand , pero estos métodos funcionan de forma asincrónica.

Notas para los herederos

Cuando hereda de la clase de DataCommand , debe invalidar los métodos de esta clase que debe ser compatible con su implementación de proveedor de DDEX.La implementación base de cada método de esta clase produce NotSupportedException.

Observe que el método de ExecuteWithoutResults tiene una implementación base que delega en el Execute el método.

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.Framework (Espacio de nombres)

DataCommandType