CONTENIDO 1 SqlBulkCopy (Clase) ______________________________________________________________________________________________3 1.1 Sintaxis ___________________________________________________________________________________________________3 1.2 Comentarios _______________________________________________________________________________________________3 1.

3 Ejemplo ___________________________________________________________________________________________________3 2 SqlClientFactory (Clase) ___________________________________________________________________________________________6 2.1 Sintaxis ____________________________________________________________________________________________________6 3 SqlCommand (Clase) ______________________________________________________________________________________________7 3.1 Sintaxis ____________________________________________________________________________________________________7 3.2 Comentarios _______________________________________________________________________________________________7 3.3 Ejemplo:___________________________________________________________________________________________________8 3.4 Miembros __________________________________________________________________________________________________9 4 SqlConnection (Clase) ___________________________________________________________________________________________ 15 4.1 Sintaxis __________________________________________________________________________________________________ 15 4.2 Comentarios _____________________________________________________________________________________________ 15 4.3 Ejemplo:_________________________________________________________________________________________________ 17 4.4 Miembros ________________________________________________________________________________________________ 17 5 SqlDataAdapter (Clase) _________________________________________________________________________________________ 23 5.1 Sintaxis __________________________________________________________________________________________________ 23 5.2 Comentarios _____________________________________________________________________________________________ 23 5.3 Ejemplo:_________________________________________________________________________________________________ 24 5.4 Miembros ________________________________________________________________________________________________ 25 6 SqlDataReader (Clase) __________________________________________________________________________________________ 32 6.1 Sintaxis __________________________________________________________________________________________________ 32 6.2 Comentarios _____________________________________________________________________________________________ 32 6.3 Ejemplo: _________________________________________________________________________________________________ 33 6.4 Miembros ________________________________________________________________________________________________ 34 7 SqlException (Clase) ____________________________________________________________________________________________ 40 7.1 Sintaxis __________________________________________________________________________________________________ 40 7.2 Comentarios _____________________________________________________________________________________________ 40 7.3 Ejemplo _________________________________________________________________________________________________ 41 8 SqlParameter (Clase) ___________________________________________________________________________________________ 43 8.1 Sintaxis __________________________________________________________________________________________________ 43 8.2 Comentarios _____________________________________________________________________________________________ 43 8.3Ejemplo: _________________________________________________________________________________________________ 43 8.4 Miembros ________________________________________________________________________________________________ 44 INDICE _________________________________________________________________________________________________________ 48 BIBLIOGRAFIA __________________________________________________________________________________________________ 48

1 SqlBulkCopy (Clase)
Permite realizar eficazmente una carga masiva de una tabla de SQL Server con datos procedentes de otro origen. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

1.1 Sintaxis
C# public sealed class SqlBulkCopy : IDisposable J# public final class SqlBulkCopy implements IDisposable JScript public final class SqlBulkCopy implements IDisposable

1.2 Comentarios
Microsoft SQL Server incluye una conocida utilidad de lnea de comandos denominada bcp para mover datos de una tabla a otra, ya sea en un solo servidor o entre servidores. La clase SqlBulkCopy permite escribir soluciones de cdigo administrado que proporcionan una funcionalidad similar. Hay otras maneras de cargar datos en una tabla de SQL Server (por ejemplo, instrucciones INSERT), pero el rendimiento de SqlBulkCopy es mucho mayor. La clase SqlBulkCopy se puede utilizar para escribir datos slo en tablas de SQL Server. Sin embargo, el origen de datos no se limita a SQL Server; se puede utilizar cualquier origen de datos, siempre que los datos se puedan cargar en una instancia de DataTable o se puedan leer con una instancia de IDataReader.

1.3 Ejemplo
La siguiente aplicacin de consola muestra cmo cargar datos mediante la clase SqlBulkCopy. En este ejemplo, se utiliza SqlDataReader para copiar datos de la tabla Production.Product ubicada en la base de datos AdventureWorks de SQL Server 2005 a una tabla similar en la misma base de datos. Importante: Este ejemplo no se ejecutar a menos que haya creado las tablas de trabajo como se describe

en Creacin de tablas para los ejemplos de copia masiva. Este cdigo se proporciona para mostrar cul debe ser la sintaxis cuando slo se utiliza SqlBulkCopy. Si las tablas de origen y de destino estn en la misma instancia de SQL Server, lo ms rpido y sencillo es usar una instruccin INSERT SELECT de Transact-SQL para copiar los datos. C# using System.Data.SqlClient; class Program { static void Main() { string connectionString = GetConnectionString(); // Open a sourceConnection to the AdventureWorks database. using (SqlConnection sourceConnection = new SqlConnection(connectionString)) { sourceConnection.Open(); // Perform an initial count on the destination table. SqlCommand commandRowCount = new SqlCommand( "SELECT COUNT(*) FROM " + "dbo.BulkCopyDemoMatchingColumns;", sourceConnection); long countStart = System.Convert.ToInt32( commandRowCount.ExecuteScalar()); Console.WriteLine("Starting row count = {0}", countStart); // Get data from the source table as a SqlDataReader. SqlCommand commandSourceData = new SqlCommand( "SELECT ProductID, Name, " + "ProductNumber " + "FROM Production.Product;", sourceConnection); SqlDataReader reader = commandSourceData.ExecuteReader(); // Open the destination connection. In the real world you would // not use SqlBulkCopy to move data from one table to the other // in the same database. This is for demonstration purposes only. using (SqlConnection destinationConnection = new SqlConnection(connectionString)) { destinationConnection.Open(); // Set up the bulk copy object. // Note that the column positions in the source // data reader match the column positions in // the destination table so there is no need to // map columns. using (SqlBulkCopy bulkCopy = new SqlBulkCopy(destinationConnection))

{ bulkCopy.DestinationTableName = "dbo.BulkCopyDemoMatchingColumns"; try { // Write from the source to the destination. bulkCopy.WriteToServer(reader); } catch (Exception ex) { Console.WriteLine(ex.Message); } finally { // Close the SqlDataReader. The SqlBulkCopy // object is automatically closed at the end // of the using block. reader.Close(); } } // Perform a final count on the destination // table to see how many rows were added. long countEnd = System.Convert.ToInt32( commandRowCount.ExecuteScalar()); Console.WriteLine("Ending row count = {0}", countEnd); Console.WriteLine("{0} rows were added.", countEnd - countStart); Console.WriteLine("Press Enter to finish."); Console.ReadLine(); } } } private static string GetConnectionString() // To avoid storing the sourceConnection string in your code, // you can retrieve it from a configuration file. { return "Data Source=(local); " + " Integrated Security=true;" + "Initial Catalog=AdventureWorks;"; } } Jerarqua de herencia System.Object System.Data.SqlClient.SqlBulkCopy

2 SqlClientFactory (Clase)
Representa un conjunto de mtodos para crear instancias de la implementacin de las clases de origen de datos del proveedor de System.Data.SqlClient. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

2.1 Sintaxis
C# public sealed class SqlClientFactory : DbProviderFactory J# public final class SqlClientFactory extends DbProviderFactory JScript public final class SqlClientFactory extends DbProviderFactory

Jerarqua de herencia System.Object System.Data.Common.DbProviderFactory System.Data.SqlClient.SqlClientFactory

3 SqlCommand (Clase)
Representa un procedimiento almacenado o una instruccin de Transact-SQL que se ejecuta en una base de datos de SQL Server. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

3.1 Sintaxis
C# public sealed class SqlCommand : DbCommand, ICloneable J# public final class SqlCommand extends DbCommand implements ICloneable JScript public final class SqlCommand extends DbCommand implements ICloneable

3.2 Comentarios
Cuando se crea una instancia de SqlCommand, las propiedades de lectura y escritura se establecen en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor SqlCommand. SqlCommand proporciona los siguientes mtodos de ejecucin de comandos en una base de datos de SQL Server: Descripcin Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o del procedimiento almacenado que describe SqlCommand, generalmente ejecutando comandos como las instrucciones BeginExecuteNonQuery INSERT, DELETE, UPDATE y SET. Cada llamada a BeginExecuteNonQuery debe ir acompaada de una llamada a EndExecuteNonQuery, que finaliza la operacin, normalmente en un subproceso independiente. Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o BeginExecuteReader del procedimiento almacenado que describe SqlCommand y Elemento

recupera uno o varios conjuntos de resultados del servidor. Cada llamada a BeginExecuteReader debe ir acompaada de una llamada a EndExecuteReader, que finaliza la operacin, normalmente en un subproceso independiente. Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o del procedimiento almacenado que describe SqlCommand. Cada llamada a BeginExecuteXmlReader debe ir acompaada de BeginExecuteXmlReader una llamada a EndExecuteXmlReader, que finaliza la operacin, normalmente en un subproceso independiente, y devuelve un objeto XmlReader.

ExecuteReader

ExecuteNonQuery ExecuteScalar ExecuteXmlReader

Ejecuta comandos que devuelven filas. Para obtener un mayor rendimiento, ExecuteReader invoca a los comandos mediante el procedimiento almacenado en el sistema sp_executesql de Transact-SQL. Por consiguiente, ExecuteReader puede no tener el efecto deseado si se utiliza para ejecutar comandos como las instrucciones SET de Transact-SQL. Ejecuta comandos como instrucciones INSERT, DELETE, UPDATE y SET de Transact-SQL. Recupera un nico valor (por ejemplo, un valor agregado) de una base de datos. Enva CommandText a Connection y crea un objeto XmlReader.

Se puede restablecer el valor de la propiedad CommandText y volver a utilizar el objeto SqlCommand. Sin embargo, es necesario cerrar SqlDataReader para poder ejecutar un comando nuevo o previo. Si el mtodo que ejecuta un objeto SqlCommand genera una excepcin SqlException, SqlConnection permanece abierta cuando el nivel de gravedad es igual o menor que 19. Si el nivel de gravedad es igual o mayor que 20, normalmente, el servidor cierra la conexin SqlConnection. Sin embargo, el usuario puede volver a abrir la conexin y continuar.

3.3 Ejemplo:
En el siguiente ejemplo, se crean una conexin SqlConnection, un objeto SqlCommand y un SqlDataReader. Posteriormente, se leen los datos y se escriben en la consola. Por ltimo, en el ejemplo se cierra SqlDataReader y, a continuacin, SqlConnection. C# private static void ReadOrderData(string connectionString) { string queryString = "SELECT OrderID, CustomerID FROM dbo.Orders;";

using (SqlConnection connection = new SqlConnection( connectionString)) { SqlCommand command = new SqlCommand( queryString, connection); connection.Open(); SqlDataReader reader = command.ExecuteReader(); try { while (reader.Read()) { Console.WriteLine(String.Format("{0}, {1}", reader[0], reader[1])); } } finally { // Always call Close when done reading. reader.Close(); } } } Jerarqua de herencia System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DbCommand System.Data.SqlClient.SqlCommand

3.4 Miembros
Representa un procedimiento almacenado o una instruccin de Transact-SQL que se ejecuta en una base de datos de SQL Server. Esta clase no se puede heredar. Las siguientes tablas recogen los miembros expuestos por el tipo SqlCommand .
Constructores pblicos

Nombre SqlCommand

Descripcin Sobrecargado. Inicializa una nueva instancia de la clase SqlCommand.

Propiedades pblicas

Nombre CommandText

Descripcin Reemplazado. Obtiene o establece el procedimiento almacenado o la instruccin de Transact-SQL que se ejecuta en el origen de datos. Reemplazado. Obtiene o establece el tiempo de espera antes de terminar el intento de ejecutar un comando y generar un error. Reemplazado. Obtiene o establece un valor que indica cmo se interpreta la propiedad CommandText. Obtiene o establece la conexin SqlConnection que utiliza esta instancia de SqlCommand. Obtiene IContainer que contiene Component.(Se hereda de Component). Reemplazado. Obtiene o establece un valor que indica si el objeto de comando debe estar visible en un control del Diseador de Windows Forms. Obtiene o establece un valor que especifica el objeto SqlNotificationRequest enlazado a este comando.

CommandTimeout

CommandType

Connection

Container DesignTimeVisible

Notification

NotificationAutoEnlist Obtiene o establece un valor que indica si la aplicacin debe recibir automticamente notificaciones de consulta de un objeto SqlDependency comn. Parameters Site Transaction Obtiene la coleccin SqlParameterCollection. Obtiene o establece ISite de Component.(Se hereda de Component). Obtiene o establece la transaccin SqlTransaction en la que se ejecuta SqlCommand. Reemplazado. Obtiene o establece la manera en que se aplican los resultados del comando a DataRow cuando lo utiliza el mtodo Update de DbDataAdapter.

UpdatedRowSource

Propiedades protegidas

Nombre

Descripcin

CanRaiseEvents Obtiene un valor que indica si el componente puede provocar un evento.(Se hereda de Component). DesignMode Obtiene un valor que indica si Component est actualmente en modo de diseo.(Se hereda de Component). Obtiene la lista de controladores de eventos asociados a Component.(Se hereda de Component).

Events

Mtodos pblicos

Nombre

Descripcin

BeginExecuteNonQuery Sobrecargado. Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o del procedimiento almacenado que describe SqlCommand. BeginExecuteReader Sobrecargado. Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o del procedimiento almacenado que describe SqlCommand y recupera uno o varios conjuntos de resultados del servidor.

BeginExecuteXmlReader Sobrecargado. Inicia la ejecucin asincrnica de la instruccin de Transact-SQL o del procedimiento almacenado que describe SqlCommand y devuelve los resultados como un objeto XmlReader. Cancel Clone Reemplazado. Intenta cancelar la ejecucin de un SqlCommand. Crea un nuevo objeto SqlCommand que es una copia de la instancia actual. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject). Crea una nueva instancia de un objeto SqlParameter.

CreateObjRef

CreateParameter

Dispose

Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component). Finaliza la ejecucin asincrnica de una instruccin de Transact-SQL. Finaliza la ejecucin asincrnica de una instruccin de Transact-SQL y devuelve el objeto SqlDataReader solicitado. Finaliza la ejecucin asincrnica de una instruccin de Transact-SQL y devuelve los datos solicitados como XML. Sobrecargado. Determina si dos instancias de Object son iguales. (Se hereda de Object). Reemplazado. Ejecuta una instruccin de Transact-SQL en la conexin y devuelve el nmero de filas afectadas. Sobrecargado. Enva la propiedad CommandText a Connection y crea un objeto SqlDataReader. Reemplazado. Ejecuta la consulta y devuelve la primera columna de la primera fila del conjunto de resultados devuelto por la consulta. Las dems columnas o filas no se tienen en cuenta. Enva CommandText a Connection y crea un objeto XmlReader. Sirve como funcin hash para un tipo concreto. GetHashCode es apropiado para su utilizacin en algoritmos de hash y en estructuras de datos como las tablas hash. (Se hereda de Object). Recupera el objeto de servicio de duracin actual que controla la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Obtiene el objeto Type de la instancia actual. (Se hereda de Object).

EndExecuteNonQuery EndExecuteReader

EndExecuteXmlReader

Equals

ExecuteNonQuery

ExecuteReader

ExecuteScalar

ExecuteXmlReader GetHashCode

GetLifetimeService

GetType

InitializeLifetimeService Obtiene un objeto de servicio de duracin para controlar la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Prepare Reemplazado. Crea una versin preparada del comando en una instancia de SQL Server. Determina si las instancias de Object especificadas son la misma instancia. (Se hereda de Object).

ReferenceEquals

ResetCommandTimeout Restablece el valor predeterminado de la propiedad CommandTimeout.

ToString

Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este mtodo no debe reemplazarse. (Se hereda de Component).

Mtodos protegidos

Nombre Dispose

Descripcin Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component). Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recoleccin de elementos no utilizados. (Se hereda de Component). Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).

Finalize

GetService

MemberwiseClone Sobrecargado. (Se hereda de MarshalByRefObject). Arriba Eventos pblicos

Nombre Disposed

Descripcin Agrega un controlador de eventos para escuchar el evento Disposed en el componente.(Se hereda de Component).

StatementCompleted Se produce cuando finaliza la ejecucin de una instruccin Transact-SQL.

Implementaciones explcitas de interfaces

Nombre System.Data.IDbCommand.CreateParameter System.Data.IDbCommand.ExecuteReader System.ICloneable.Clone System.IDisposable.Dispose System.Data.IDbCommand.Connection System.Data.IDbCommand.Parameters System.Data.IDbCommand.Transaction

Descripcin

Sobrecargado.

4 SqlConnection (Clase)
Representa una conexin abierta con una base de datos de SQL Server. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

4.1 Sintaxis
C# public sealed class SqlConnection : DbConnection, ICloneable J# public final class SqlConnection extends DbConnection implements ICloneable JScript public final class SqlConnection extends DbConnection implements ICloneable

4.2 Comentarios
Un objeto SqlConnection representa una nica sesin con un origen de datos de SQL Server. Con un sistema de bases de datos de cliente y servidor, equivale a una conexin de red al servidor. SqlConnection se utiliza junto con SqlDataAdapter y SqlCommand para aumentar el rendimiento de la conexin a una base de datos de Microsoft SQL Server. Con productos SQL Server de otros proveedores y otros orgenes de datos compatibles con OLE DB, se debe utilizar OleDbConnection. Cuando se crea una instancia de SqlConnection, se establecen todas las propiedades en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor SqlConnection. Si la conexin SqlConnection est fuera de mbito, permanecer abierta. Por tanto, debe cerrar la conexin explcitamente mediante una llamada al mtodo Close o Dispose. Close y Dispose tienen una funcionalidad equivalente. Si el valor de agrupacin de conexiones Pooling se establece en true o yes, la conexin subyacente se devuelve al grupo de conexiones. Por otro lado, si Pooling se establece en false o no, la conexin subyacente al servidor se cerrar.

Para garantizar que las conexiones se cierren siempre, abra la conexin dentro de un bloque using, como se muestra en el fragmento de cdigo siguiente. Haciendo esto se garantiza que la conexin se cierra automticamente cuando el cdigo sale del bloque. VB Using connection As New SqlConnection(connectionString) connection.Open() ' Do work here; connection closed on following line. End Using using (SqlConnection connection = new SqlConnection(connectionString)) { connection.Open(); // Do work here; connection closed on following line. } Nota Para implementar aplicaciones de alto rendimiento, es necesario utilizar la agrupacin de conexiones. Cuando se utiliza el proveedor de datos de .NET Framework para SQL Server, no es necesario habilitar una agrupacin de conexiones, ya que el proveedor la administra automticamente, aunque se pueden modificar algunos valores. Para obtener ms informacin, vea Uso de agrupacin de conexiones. Si el mtodo que ejecuta un objeto SqlCommand genera una excepcin SqlException, SqlConnection permanece abierta cuando el nivel de gravedad es igual o menor que 19. Si el nivel de gravedad es igual o mayor que 20, normalmente, el servidor cierra la conexin SqlConnection. Sin embargo, el usuario puede volver a abrir la conexin y continuar. Una aplicacin que crea una instancia del objeto SqlConnection puede requerir que todos los llamadores directos e indirectos tengan permisos suficientes en el cdigo estableciendo solicitudes de seguridad declarativas o imperativas. SqlConnection realiza solicitudes de seguridad utilizando el objeto SqlClientPermission. Los usuarios pueden comprobar que el cdigo tiene los permisos adecuados mediante el objeto SqlClientPermissionAttribute. Los usuarios y administradores tambin pueden utilizar la herramienta Herramienta de la directiva de seguridad de acceso a cdigo (Caspol.exe) para modificar la directiva de seguridad en los niveles de equipo, usuario y empresa. Para obtener ms informacin, vea Seguridad en .NET Framework. Para obtener un ejemplo que muestra cmo utilizar las peticiones de seguridad, vea Seguridad de acceso a cdigo y ADO.NET. Nota Si utiliza Microsoft .NET Framework versin 1.0, es necesario establecer el permiso con nombre FullTrust para conectarse a SQL Server mediante el mtodo Open. Este requisito no es necesario si utiliza la versin 1.1 de .NET Framework o una posterior. Para obtener ms informacin, vea Solicitar permisos y Conjuntos de permisos con nombre. Para obtener ms informacin sobre el tratamiento de mensajes informativos y de advertencia del servidor, vea Trabajar con eventos de conexin.

4.3 Ejemplo:
En el siguiente ejemplo se crean un objeto SqlCommand y un objeto SqlConnection. Se abre la conexin SqlConnection y se establece como la propiedad Connection de SqlCommand. A continuacin, en el ejemplo se llama a ExecuteNonQuery y se cierra la conexin. Para ello, se pasa a ExecuteNonQuery una cadena de conexin y una cadena de consulta que es una instruccin Transact-SQL INSERT. C# private static void OpenSqlConnection() { string connectionString = GetConnectionString(); using (SqlConnection connection = new SqlConnection(connectionString)) { connection.Open(); Console.WriteLine("ServerVersion: {0}", connection.ServerVersion); Console.WriteLine("State: {0}", connection.State); } } static private string GetConnectionString() { // To avoid storing the connection string in your code, // you can retrieve it from a configuration file, using the // System.Configuration.ConfigurationSettings.AppSettings property return "Data Source=(local);Initial Catalog=AdventureWorks;" + "Integrated Security=SSPI;"; } Jerarqua de herencia System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DbConnection System.Data.SqlClient.SqlConnection

4.4 Miembros
Representa una conexin abierta con una base de datos de SQL Server. Esta clase no se puede heredar. Las siguientes tablas recogen los miembros expuestos por el tipo SqlConnection .

Constructores pblicos

Nombre SqlConnection

Descripcin Sobrecargado. Inicializa una nueva instancia de la clase SqlConnection.

Propiedades pblicas

Nombre ConnectionString

Descripcin Reemplazado. Obtiene o establece la cadena utilizada para abrir una base de datos de SQL Server. Reemplazado. Obtiene el tiempo de espera para intentar establecer una conexin antes de detenerse y generar un error. Obtiene IContainer que contiene Component.(Se hereda de Component). Reemplazado. Obtiene el nombre de la base de datos actual o de la que se va a utilizar una vez que se abre la conexin. Reemplazado. Obtiene el nombre de la instancia de SQL Server con la que se va a establecer la conexin.

ConnectionTimeout

Container

Database

DataSource

FireInfoMessageEventOnUserErrors Obtiene o establece la propiedad FireInfoMessageEventOnUserErrors. PacketSize Obtiene el tamao expresado en bytes de los paquetes de red utilizados para establecer comunicacin con una instancia de SQL Server. Reemplazado. Obtiene una cadena que contiene la versin de la instancia de SQL Server a la que se conecta el cliente. Obtiene o establece ISite de Component.(Se hereda de Component).

ServerVersion

Site

State StatisticsEnabled

Reemplazado. Indica el estado de SqlConnection. Cuando se establece en true, permite la recopilacin de estadsticas para la conexin actual. Obtiene una cadena que identifica el cliente de bases de datos.

WorkstationId

Propiedades protegidas

Nombre

Descripcin

CanRaiseEvents Obtiene un valor que indica si el componente puede provocar un evento.(Se hereda de Component). DesignMode Obtiene un valor que indica si Component est actualmente en modo de diseo.(Se hereda de Component). Obtiene la lista de controladores de eventos asociados a Component.(Se hereda de Component).

Events

Mtodos pblicos

Nombre BeginTransaction ChangeDatabase

Descripcin Sobrecargado. Inicia una transaccin de base de datos. Reemplazado. Cambia la base de datos actual de una conexin SqlConnection abierta. Cambia la contrasea de SQL Server para el usuario indicado en la cadena de conexin a la nueva contrasea proporcionada. Vaca la agrupacin de conexiones. Vaca la agrupacin de conexiones asociada a la conexin especificada.

ChangePassword

ClearAllPools ClearPool

Close

Reemplazado. Cierra la conexin con la base de datos. ste es el mtodo recomendado para cerrar conexiones abiertas. Crea y devuelve un objeto SqlCommand asociado a la conexin SqlConnection. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject). Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component).

CreateCommand

CreateObjRef

Dispose

EnlistDistributedTransaction Se da de alta en la transaccin especificada como transaccin distribuida. EnlistTransaction Reemplazado. Se da de alta en la transaccin especificada como transaccin distribuida. Sobrecargado. Determina si dos instancias de Object son iguales. (Se hereda de Object). Sirve como funcin hash para un tipo concreto. GetHashCode es apropiado para su utilizacin en algoritmos de hash y en estructuras de datos como las tablas hash. (Se hereda de Object). Recupera el objeto de servicio de duracin actual que controla la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Sobrecargado. Reemplazado. Devuelve informacin de esquema para el origen de datos de SqlConnection. Obtiene el objeto Type de la instancia actual. (Se hereda de Object). Obtiene un objeto de servicio de duracin para controlar la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Reemplazado. Abre una conexin de base de datos con los valores de propiedad que especifica ConnectionString. Determina si las instancias de Object especificadas son la misma instancia. (Se hereda de Object). Si se habilita la recoleccin de estadsticas, todos los valores se

Equals

GetHashCode

GetLifetimeService

GetSchema

GetType InitializeLifetimeService

Open

ReferenceEquals

ResetStatistics

restablecen en cero. RetrieveStatistics Devuelve una coleccin de pares de nombre y valor de las estadsticas cuando se llama el mtodo. Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este mtodo no debe reemplazarse. (Se hereda de Component).

ToString

Mtodos protegidos

Nombre Dispose

Descripcin Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component). Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recoleccin de elementos no utilizados. (Se hereda de Component). Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).

Finalize

GetService

MemberwiseClone Sobrecargado. (Se hereda de MarshalByRefObject).

Eventos pblicos

Nombre Disposed

Descripcin Agrega un controlador de eventos para escuchar el evento Disposed en el componente.(Se hereda de Component).

InfoMessage Se produce cuando SQL Server devuelve un mensaje informativo o de advertencia. StateChange Se produce cuando cambia el estado del evento.(Se hereda de DbConnection).

Implementaciones explcitas de interfaces

Nombre

Descripcin

System.Data.IDbConnection.BeginTransaction Sobrecargado. System.Data.IDbConnection.CreateCommand System.ICloneable.Clone System.IDisposable.Dispose Crea un nuevo objeto copiado de la instancia actual.

5 SqlDataAdapter (Clase)
Representa un conjunto de comandos de datos y una conexin de base de datos que se utilizan para rellenar un DataSet y actualizar una base de datos de SQL Server. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

5.1 Sintaxis
C# public sealed class SqlDataAdapter : DbDataAdapter, IDbDataAdapter, IDataAdapter, ICloneable J# public final class SqlDataAdapter extends DbDataAdapter implements IDbDataAdapter, IDataAdapter, ICloneable JScript public final class SqlDataAdapter extends DbDataAdapter implements IDbDataAdapter, IDataAdapter, ICloneable

5.2 Comentarios
SqlDataAdapter, se utiliza como un puente entre DataSet y SQL Server para recuperar y guardar datos. SqlDataAdapter proporciona este puente mediante la asignacin de Fill, que cambia los datos en DataSet para que coincidan con los datos del origen de datos; y Update, que cambia los datos en el origen de datos para que coincidan con los datos en DataSet utilizando las instrucciones de Transact-SQL en el origen de datos adecuado. Cuando SqlDataAdapter rellene un objeto DataSet, crear las tablas y columnas necesarias para los datos devueltos si todava no existen. Sin embargo, la informacin de clave principal no se incluir en el esquema creado implcitamente a menos que la propiedad MissingSchemaAction se establezca en AddWithKey. Tambin se puede hacer que SqlDataAdapter cree el esquema de DataSet, incluida la informacin de clave principal, antes de rellenarlo de datos mediante el mtodo FillSchema. Para obtener ms informacin, vea Agregar restricciones existentes a DataSet. SqlDataAdapter se utiliza junto con SqlConnection y SqlCommand para aumentar el rendimiento en la conexin con una base de datos de SQL Server.

SqlDataAdapter contiene tambin las propiedades SelectCommand, InsertCommand, DeleteCommand, UpdateCommand y TableMappings para facilitar la carga y la actualizacin de los datos. Cuando se crea una instancia de SqlDataAdapter, las propiedades de lectura y escritura se establecen en sus valores iniciales. Para obtener una lista de esos valores, vea el constructor SqlDataAdapter.

5.3 Ejemplo:
En el ejemplo siguiente se utilizan SqlCommand, SqlDataAdapter y SqlConnection para seleccionar registros de una base de datos, y se rellena DataSet con las filas seleccionadas. A continuacin, se devuelve el DataSet rellenado. Para ello, al mtodo se le pasan un DataSet inicializado, una cadena de conexin y una cadena de consulta que es una instruccin SELECT de Transact-SQL. C# VB Copiar private static DataSet SelectRows(DataSet dataset, string connectionString,string queryString) { using (SqlConnection connection = new SqlConnection(connectionString)) { SqlDataAdapter adapter = new SqlDataAdapter(); adapter.SelectCommand = new SqlCommand( queryString, connection); adapter.Fill(dataset); return dataset; } }

Jerarqua de herencia System.Object System.MarshalByRefObject System.ComponentModel.Component System.Data.Common.DataAdapter System.Data.Common.DbDataAdapter System.Data.SqlClient.SqlDataAdapter

5.4 Miembros
Representa un conjunto de comandos de datos y una conexin de base de datos que se utilizan para rellenar un DataSet y actualizar una base de datos de SQL Server. Esta clase no se puede heredar. Las siguientes tablas recogen los miembros expuestos por el tipo SqlDataAdapter .
Constructores pblicos

Nombre SqlDataAdapter

Descripcin Sobrecargado. Inicializa una nueva instancia de la clase SqlDataAdapter.

Propiedades pblicas ) Nombre AcceptChangesDuringFill Descripcin Obtiene o establece un valor que indica si se llama al mtodo AcceptChanges en un objeto DataRow despus de agregarlo a DataTable durante cualquiera de las operaciones Fill.(Se hereda de DataAdapter).

AcceptChangesDuringUpdate Obtiene o establece si se llama a AcceptChanges durante una operacin Update.(Se hereda de DataAdapter). Container Obtiene IContainer que contiene Component.(Se hereda de Component). Obtiene o establece un valor que especifica si debe generarse una excepcin cuando se produce un error durante una actualizacin de fila.(Se hereda de DataAdapter). Obtiene o establece un procedimiento almacenado o una instruccin de Transact-SQL para eliminar registros de un conjunto de datos. Obtiene o establece el valor de LoadOption que determina cmo rellena el adaptador el objeto DataTable a partir de DbDataReader.(Se hereda de DataAdapter).

ContinueUpdateOnError

DeleteCommand

FillLoadOption

InsertCommand

Obtiene o establece un procedimiento almacenado o una instruccin de Transact-SQL para insertar nuevos registros en el origen de datos. Determina la accin que hay que llevar a cabo si los datos entrantes no tienen una tabla o una columna coincidente.(Se hereda de DataAdapter). Determina la accin que hay que llevar a cabo cuando el esquema DataSet existente no coincide con los datos entrantes.(Se hereda de DataAdapter).

MissingMappingAction

MissingSchemaAction

ReturnProviderSpecificTypes Obtiene o establece si el mtodo Fill debe devolver valores especficos del proveedor o valores comunes compatibles con CLS.(Se hereda de DataAdapter). SelectCommand Obtiene o establece un procedimiento almacenado o una instruccin de Transact-SQL para seleccionar registros en el origen de datos. Obtiene o establece ISite de Component.(Se hereda de Component). Obtiene una coleccin que proporciona la asignacin principal entre una tabla de origen y DataTable.(Se hereda de DataAdapter). Obtiene o establece el nmero de filas procesadas en cada accin de ida y vuelta al servidor. Obtiene o establece un procedimiento almacenado o una instruccin de Transact-SQL para actualizar los registros del origen de datos.

Site TableMappings

UpdateBatchSize

UpdateCommand

Propiedades protegidas

Nombre CanRaiseEvents

Descripcin Obtiene un valor que indica si el componente puede provocar un evento.(Se hereda de Component). Obtiene un valor que indica si Component est actualmente en modo de diseo.(Se hereda de Component).

DesignMode

Events

Obtiene la lista de controladores de eventos asociados a Component.(Se hereda de Component).

FillCommandBehavior Obtiene o establece el comportamiento del comando utilizado para rellenar el adaptador de datos.(Se hereda de DbDataAdapter).

Mtodos pblicos

Nombre CreateObjRef

Descripcin Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject). Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component). Sobrecargado. Determina si dos instancias de Object son iguales. (Se hereda de Object). Sobrecargado. Rellena un objeto DataSet o un objeto DataTable. (Se hereda de DbDataAdapter). Sobrecargado. Agrega DataTable a DataSet y configura el esquema para hacerlo coincidir con el del origen de datos. (Se hereda de DbDataAdapter). Obtiene los parmetros establecidos por el usuario al ejecutar una instruccin SELECT de SQL. (Se hereda de DbDataAdapter). Sirve como funcin hash para un tipo concreto. GetHashCode es apropiado para su utilizacin en algoritmos de hash y en estructuras de datos como las tablas hash. (Se hereda de Object). Recupera el objeto de servicio de duracin actual que controla la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject).

Dispose

Equals

Fill

FillSchema

GetFillParameters

GetHashCode

GetLifetimeService

GetType

Obtiene el objeto Type de la instancia actual. (Se hereda de Object). Obtiene un objeto de servicio de duracin para controlar la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Determina si las instancias de Object especificadas son la misma instancia. (Se hereda de Object). Restablece FillLoadOption a su estado predeterminado y hace que Fill tenga en cuenta AcceptChangesDuringFill. (Se hereda de DataAdapter).

InitializeLifetimeService

ReferenceEquals

ResetFillLoadOption

ShouldSerializeAcceptChangesDuringFill Determina si se debe conservar la propiedad AcceptChangesDuringFill. (Se hereda de DataAdapter). ShouldSerializeFillLoadOption Determina si se debe conservar la propiedad FillLoadOption. (Se hereda de DataAdapter). Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista. Este mtodo no debe reemplazarse. (Se hereda de Component). Sobrecargado. Llama a las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en DataSet. (Se hereda de DbDataAdapter).

ToString

Update

Mtodos protegidos

Nombre AddToBatch

Descripcin Agrega una interfaz IDbCommand al lote actual. (Se hereda de DbDataAdapter). Quita todos los objetos IDbCommand del lote. (Se hereda de DbDataAdapter). Crea una copia de esta instancia de DataAdapter. (Se hereda de DataAdapter). Inicializa una nueva instancia de la clase RowUpdatedEventArgs.

ClearBatch

CloneInternals

CreateRowUpdatedEvent

(Se hereda de DbDataAdapter). CreateRowUpdatingEvent Inicializa una nueva instancia de la clase RowUpdatingEventArgs. (Se hereda de DbDataAdapter). Crea una nueva coleccin DataTableMappingCollection. (Se hereda de DataAdapter). Sobrecargado. Libera los recursos utilizados por el objeto Component. (Se hereda de Component). Ejecuta el lote actual. (Se hereda de DbDataAdapter). Sobrecargado. Rellena un objeto DataSet o un objeto DataTable. (Se hereda de DbDataAdapter). Sobrecargado. Agrega DataTable a DataSet y configura el esquema para hacerlo coincidir con el del origen de datos. (Se hereda de DbDataAdapter). Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recoleccin de elementos no utilizados. (Se hereda de Component). Devuelve una interfaz IDataParameter de uno de los comandos del lote actual. (Se hereda de DbDataAdapter). Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component). Indica si se ha creado una coleccin DataTableMappingCollection. (Se hereda de DataAdapter). Inicializa el procesamiento por lotes de DbDataAdapter. (Se hereda de DbDataAdapter). Sobrecargado. (Se hereda de MarshalByRefObject). Se invoca cuando aparece un error durante una operacin Fill. (Se hereda de DataAdapter). Provoca el evento RowUpdated de un proveedor de datos de .NET Framework. (Se hereda de DbDataAdapter). Provoca el evento RowUpdating de un proveedor de datos de .NET

CreateTableMappings

Dispose

ExecuteBatch Fill

FillSchema

Finalize

GetBatchedParameter

GetService

HasTableMappings

InitializeBatching

MemberwiseClone OnFillError

OnRowUpdated

OnRowUpdating

Framework. (Se hereda de DbDataAdapter). ShouldSerializeTableMappings Determina si uno o ms objetos DataTableMapping existen y si deben almacenarse. (Se hereda de DataAdapter). TerminateBatching Finaliza el procesamiento por lotes para DbDataAdapter. (Se hereda de DbDataAdapter). Sobrecargado. Llama a las instrucciones INSERT, UPDATE o DELETE respectivas para cada fila insertada, actualizada o eliminada en DataSet. (Se hereda de DbDataAdapter).

Update

Eventos pblicos

Nombre Disposed

Descripcin Agrega un controlador de eventos para escuchar el evento Disposed en el componente.(Se hereda de Component). Se devuelve cuando se produce un error durante una operacin de relleno.(Se hereda de DataAdapter).

FillError

RowUpdated Se produce durante Update despus de que se ejecute un comando en el origen de datos. Se ha realizado un intento de actualizacin, de manera que se inicia el evento. RowUpdating Se produce durante el mtodo Update antes de que se ejecute un comando en el origen de datos. Se ha realizado un intento de actualizacin, de manera que se inicia el evento.

Implementaciones explcitas de interfaces

Nombre System.ICloneable.Clone

Descripcin Para obtener una descripcin de este miembro, vea Clone.

System.Data.IDbDataAdapter.DeleteCommand Para obtener una descripcin de este miembro, vea DeleteCommand. System.Data.IDbDataAdapter.InsertCommand Para obtener una descripcin de este miembro, vea InsertCommand.

System.Data.IDbDataAdapter.SelectCommand Para obtener una descripcin de este miembro, vea SelectCommand. System.Data.IDbDataAdapter.UpdateCommand Para obtener una descripcin de este miembro, vea UpdateCommand.

6 SqlDataReader (Clase)

Proporciona una forma de leer una secuencia de filas slo hacia delante en una base de datos de SQL Server. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

6.1 Sintaxis
C# public class SqlDataReader : DbDataReader, IDataReader, IDisposable, IDataRecord J# public class SqlDataReader extends DbDataReader implements IDataReader, IDisposable, IDataRecord JScript public class SqlDataReader extends DbDataReader implements IDataReader, IDisposable, IDataRecord

6.2 Comentarios
Para crear un SqlDataReader, se debe llamar al mtodo ExecuteReader del objeto SqlCommand, en lugar de utilizar directamente un constructor. Mientras se est utilizando SqlDataReader, el objeto SqlConnection asociado est ocupado dando servicio a SqlDataReader, y en SqlConnection no se puede realizar ninguna otra operacin, excepto la de cerrar. Esto es as hasta que se llama al mtodo Close de SqlDataReader. Por ejemplo, no se pueden recuperar parmetros de salida hasta despus de llamar a Close. Los cambios que realiza otro proceso o subproceso en un conjunto de resultados mientras se leen los datos, pueden ser visibles para el usuario de SqlDataReader. Sin embargo, el comportamiento exacto depende de los intervalos de tiempo. IsClosed y RecordsAffected son las nicas propiedades a las que se puede llamar despus de cerrarse SqlDataReader. Si bien se puede obtener acceso a la propiedad RecordsAffected

mientras exista SqlDataReader, se debe llamar siempre al mtodo Close antes de devolver el valor de RecordsAffected para garantizar que el valor devuelto sea exacto. Nota Para obtener un rendimiento ptimo, SqlDataReader evita crear objetos innecesarios o hacer copias de objetos innecesarias. Por tanto, varias llamadas a los mtodos como GetValue devuelven una referencia al mismo objeto. Conviene tener mucho cuidado si se modifica el valor subyacente de los objetos devueltos por mtodos como GetValue.

6.3 Ejemplo:
En el siguiente ejemplo, se crean una conexin SqlConnection, un objeto SqlCommand y un SqlDataReader. En el ejemplo se leen los datos y se escriben en la ventana de la consola. Seguidamente, el cdigo cierra SqlDataReader. SqlConnection se cierra automticamente al final del bloque de cdigo using. C# private static void ReadOrderData(string connectionString) { string queryString = "SELECT OrderID, CustomerID FROM dbo.Orders;"; using (SqlConnection connection = new SqlConnection(connectionString)) { SqlCommand command = new SqlCommand(queryString, connection); connection.Open(); SqlDataReader reader = command.ExecuteReader(); // Call Read before accessing data. while (reader.Read()) { Console.WriteLine(String.Format("{0}, {1}", reader[0], reader[1])); } // Call Close when done reading. reader.Close(); } }

Jerarqua de herencia System.Object System.MarshalByRefObject System.Data.Common.DbDataReader System.Data.SqlClient.SqlDataReader

6.4 Miembros
Proporciona una forma de leer una secuencia de filas slo hacia delante en una base de datos de SQL Server. Esta clase no se puede heredar. Las siguientes tablas recogen los miembros expuestos por el tipo SqlDataReader .
Propiedades pblicas

Nombre Depth

Descripcin Reemplazado. Obtiene un valor que indica la profundidad del anidamiento de la fila actual. Reemplazado. Obtiene el nmero de columnas de la fila actual. Reemplazado. Obtiene un valor que indica si el objeto SqlDataReader contiene una o varias filas. Reemplazado. Recupera un valor de tipo Boolean que indica si se ha cerrado la instancia de SqlDataReader especificada. Sobrecargado. Reemplazado. Obtiene el valor de una columna en su formato nativo.

FieldCount HasRows

IsClosed

Item

RecordsAffected Reemplazado. Obtiene el nmero de filas cambiadas, insertadas o eliminadas por la ejecucin de una instruccin de Transact-SQL. VisibleFieldCount Reemplazado. Obtiene el nmero de campos de SqlDataReader que no estn ocultos.

Propiedades protegidas

Nombre Connection

Descripcin Obtiene el objeto SqlConnection asociado a SqlDataReader.

Mtodos pblicos

Nombre Close CreateObjRef

Descripcin Reemplazado. Cierra el objeto SqlDataReader. Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject). Sobrecargado. Libera los recursos que utiliza el objeto DbDataReader. (Se hereda de DbDataReader). Sobrecargado. Determina si dos instancias de Object son iguales. (Se hereda de Object). Reemplazado. Obtiene el valor de la columna especificada como tipo Boolean. Reemplazado. Obtiene el valor de la columna especificada como byte. Reemplazado. Lee una secuencia de bytes a partir del desplazamiento de la columna especificada en el bfer como una matriz que se inicia en el desplazamiento del bfer dado. Reemplazado. Obtiene el valor de la columna especificada como un nico carcter. Reemplazado. Lee una secuencia de caracteres del desplazamiento de columna que se haya especificado en el bfer como matriz, comenzando en el desplazamiento de bfer dado.

Dispose

Equals

GetBoolean

GetByte

GetBytes

GetChar

GetChars

GetData

Devuelve un objeto DbDataReader para el ordinal de columna solicitado. (Se hereda de DbDataReader). Reemplazado. Obtiene el nombre del tipo de datos de origen. Reemplazado. Obtiene el valor de la columna especificada como un objeto DateTime. Reemplazado. Obtiene el valor de la columna especificada como un objeto Decimal. Reemplazado. Obtiene el valor de la columna especificada como un nmero de punto flotante de precisin doble. Reemplazado. Devuelve un IEnumerator que recorre en iteracin SqlDataReader. Reemplazado. Obtiene el objeto Type que es el tipo de datos del objeto. Reemplazado. Obtiene el valor de la columna especificada como un nmero de punto flotante de precisin simple. Reemplazado. Obtiene el valor de la columna especificada en forma de identificador global nico (GUID). Sirve como funcin hash para un tipo concreto. GetHashCode es apropiado para su utilizacin en algoritmos de hash y en estructuras de datos como las tablas hash. (Se hereda de Object). Reemplazado. Obtiene el valor de la columna especificada como un entero de 16 bits con signo. Reemplazado. Obtiene el valor de la columna especificada como un entero de 32 bits con signo. Reemplazado. Obtiene el valor de la columna especificada como un entero de 64 bits con signo. Recupera el objeto de servicio de duracin actual que controla la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Reemplazado. Obtiene el nombre de la columna especificada.

GetDataTypeName GetDateTime

GetDecimal

GetDouble

GetEnumerator

GetFieldType

GetFloat

GetGuid

GetHashCode

GetInt16

GetInt32

GetInt64

GetLifetimeService

GetName

GetOrdinal

Reemplazado. Obtiene el ordinal de la columna a partir del nombre de la columna determinado.

GetProviderSpecificFieldType Reemplazado. Obtiene un Object que es una representacin del tipo de campo especfico del proveedor subyacente. GetProviderSpecificValue Reemplazado. Obtiene un Object que es una representacin del valor especfico del proveedor subyacente. Reemplazado. Obtiene una matriz de objetos que son una representacin de los valores especficos del proveedor subyacentes. Reemplazado. Devuelve una DataTable que describe los metadatos de columna del SqlDataReader. Obtiene el valor de la columna especificada en forma de SqlBinary. Obtiene el valor de la columna especificada en forma de SqlBoolean. Obtiene el valor de la columna especificada en forma de SqlByte. Obtiene el valor de la columna especificada en forma de SqlBytes. Obtiene el valor de la columna especificada en forma de SqlChars. Obtiene el valor de la columna especificada en forma de SqlDateTime. Obtiene el valor de la columna especificada en forma de SqlDecimal. Obtiene el valor de la columna especificada en forma de SqlDouble. Obtiene el valor de la columna especificada en forma de SqlGuid. Obtiene el valor de la columna especificada en forma de SqlInt16. Obtiene el valor de la columna especificada en forma de SqlInt32. Obtiene el valor de la columna especificada en forma de SqlInt64. Obtiene el valor de la columna especificada en forma de SqlMoney. Obtiene el valor de la columna especificada en forma de SqlSingle. Obtiene el valor de la columna especificada en forma de SqlString.

GetProviderSpecificValues

GetSchemaTable

GetSqlBinary GetSqlBoolean GetSqlByte GetSqlBytes GetSqlChars GetSqlDateTime

GetSqlDecimal GetSqlDouble GetSqlGuid GetSqlInt16 GetSqlInt32 GetSqlInt64 GetSqlMoney GetSqlSingle GetSqlString

GetSqlValue

Obtiene un Object que es una representacin de SqlDbType Variant subyacente. Obtiene todas las columnas de atributos de la fila actual. Obtiene el valor de la columna especificada como un valor XML. Reemplazado. Obtiene el valor de la columna especificada como cadena. Obtiene el objeto Type de la instancia actual. (Se hereda de Object). Reemplazado. Obtiene el valor de la columna especificada en su formato nativo. Reemplazado. Obtiene todas las columnas de atributos de la coleccin para la fila actual. Obtiene un objeto de servicio de duracin para controlar la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Reemplazado. Obtiene un valor que indica si la columna contiene valores no existentes o que faltan. Reemplazado. Desplaza el lector de datos al siguiente resultado cuando se leen los resultados de las instrucciones de Transact-SQL por lotes. Reemplazado. Desplaza SqlDataReader hasta el siguiente registro. Determina si las instancias de Object especificadas son la misma instancia. (Se hereda de Object). Devuelve una clase String que representa la clase Object actual. (Se hereda de Object).

GetSqlValues GetSqlXml GetString

GetType GetValue

GetValues

InitializeLifetimeService

IsDBNull

NextResult

Read ReferenceEquals

ToString

Mtodos protegidos

Nombre Dispose

Descripcin Sobrecargado. Libera los recursos que utiliza el objeto DbDataReader. (Se hereda de DbDataReader). Permite que un objeto Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el objeto Object sea reclamado por el recolector de elementos no utilizados. (Se hereda de Object). Devuelve un objeto DbDataReader para el ordinal de columna solicitado que se puede reemplazar con una implementacin especfica del proveedor. (Se hereda de DbDataReader).

Finalize

GetDbDataReader

IsCommandBehavior Determina si el valor de CommandBehavior especificado coincide con el de SqlDataReader. MemberwiseClone Sobrecargado. (Se hereda de MarshalByRefObject).

Implementaciones explcitas de interfaces

Nombre System.Collections.IEnumerable.GetEnumerator System.Data.IDataRecord.GetData

Descripcin

Para obtener una descripcin de este miembro, vea GetData.

System.IDisposable.Dispose

7 SqlException (Clase)
La excepcin que se produce cuando SQL Server devuelve una advertencia o un error. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

7.1 Sintaxis
C# public sealed class SqlException : DbException J# /** @attribute SerializableAttribute() */ public final class SqlException extends DbException JScript SerializableAttribute public final class SqlException extends DbException

7.2 Comentarios
Esta clase se crea siempre que el proveedor de datos de .NET Framework para SQL Server encuentra un error generado en el servidor. Los errores en el cliente se producen como excepciones estndar de Common Language Runtime. SqlException siempre contiene al menos una instancia de SqlError. Los mensajes con un nivel de gravedad igual o menor que 10 son mensajes informativos e indican los problemas ocasionados cuando un usuario no escribe la informacin correctamente. Los niveles de gravedad del 11 al 16 son errores generados por el usuario y que l mismo puede corregir. Los niveles de gravedad del 17 al 25 indican errores de software o hardware. Cuando se produce un error de niveles 17, 18 o 19, se puede continuar trabajando, aunque es posible que no se pueda ejecutar una determinada instruccin. SqlConnection permanece abierto cuando el nivel de gravedad es igual o menor que 19. Si el nivel de gravedad es igual o mayor que 20, normalmente, el servidor cierra la conexin

SqlConnection. Sin embargo, el usuario puede volver a abrir la conexin y continuar. En ambos casos, el mtodo que ejecuta el comando genera una SqlException. Para obtener informacin sobre los mensajes informativos y de advertencia enviados por SQL Server, vea la seccin Solucin de problemas de los Libros en pantalla de SQL Server. La clase SqlException se asigna a la gravedad de SQL Server.

7.3 Ejemplo
En el ejemplo siguiente se genera una excepcin SqlException y, a continuacin, se muestra. C# VB Copiar public static void ShowSqlException(string connectionString) { string queryString = "EXECUTE NonExistantStoredProcedure"; StringBuilder errorMessages = new StringBuilder(); using (SqlConnection connection = new SqlConnection(connectionString)) { SqlCommand command = new SqlCommand(queryString, connection); try { command.Connection.Open(); command.ExecuteNonQuery(); } catch (SqlException ex) { for (int i = 0; i < ex.Errors.Count; i++) { errorMessages.Append("Index #" + i + "\n" + "Message: " + ex.Errors[i].Message + "\n" + "LineNumber: " + ex.Errors[i].LineNumber + "\n" + "Source: " + ex.Errors[i].Source + "\n" + "Procedure: " + ex.Errors[i].Procedure + "\n"); } Console.WriteLine(errorMessages.ToString()); } } } Jerarqua de herencia System.Object System.Exception System.SystemException System.Runtime.InteropServices.ExternalException

System.Data.Common.DbException System.Data.SqlClient.SqlException

8 SqlParameter (Clase)
Representa un parmetro de un objeto SqlCommand y, de manera opcional, su asignacin a columnas de DataSet. Esta clase no se puede heredar. Espacio de nombres: System.Data.SqlClient Ensamblado: System.Data (en system.data.dll)

8.1 Sintaxis
C# public sealed class SqlParameter : DbParameter, IDbDataParameter, IDataParameter, ICloneable J# public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, ICloneable JScript public final class SqlParameter extends DbParameter implements IDbDataParameter, IDataParameter, ICloneable

8.2 Comentarios
Los nombres de parmetros no distinguen entre maysculas y minsculas.

8.3Ejemplo:
En el ejemplo siguiente se crean varias instancias de SqlParameter mediante la coleccin SqlParameterCollection en SqlDataAdapter. Estos parmetros se utilizan para seleccionar datos del origen de datos y colocarlos en DataSet. En este ejemplo se supone que ya se han

creado un DataSet y un SqlDataAdapter mediante el esquema, los comandos y la conexin adecuados.

C# public void AddSqlParameters() { // ... // create categoriesDataSet and categoriesAdapter // ... categoriesAdapter.SelectCommand.Parameters.Add( "@CategoryName", SqlDbType.VarChar, 80).Value = "toasters"; categoriesAdapter.SelectCommand.Parameters.Add( "@SerialNum", SqlDbType.Int).Value = 239; categoriesAdapter.Fill(categoriesDataSet); } Jerarqua de herencia System.Object System.MarshalByRefObject System.Data.Common.DbParameter System.Data.SqlClient.SqlParameter

8.4 Miembros
Representa un parmetro de un objeto SqlCommand y, de manera opcional, su asignacin a columnas de DataSet. Esta clase no se puede heredar. Las siguientes tablas recogen los miembros expuestos por el tipo SqlParameter .
Constructores pblicos

Nombre SqlParameter

Descripcin Sobrecargado. Inicializa una nueva instancia de la clase SqlParameter.

Propiedades pblicas

Nombre CompareInfo

Descripcin Obtiene o establece el objeto CompareInfo que define el modo en que se realiza la comparacin de cadenas para este parmetro. Reemplazado. Obtiene o establece el SqlDbType del parmetro. Reemplazado. Obtiene o establece un valor que indica si el parmetro es slo de entrada, slo de salida, bidireccional o un parmetro de un valor devuelto de procedimiento almacenado. Reemplazado. Obtiene o establece un valor que indica si el parmetro acepta valores nulos. Obtiene o establece el identificador de la configuracin regional que determina las convenciones y el idioma para una regin especfica. Obtiene o establece el desplazamiento hasta la propiedad Value. Reemplazado. Obtiene o establece el nombre de SqlParameter. Obtiene o establece el nmero mximo de dgitos utilizados para representar la propiedad Value. Obtiene o establece el nmero de posiciones decimales en el que se resuelve Value. Reemplazado. Obtiene o establece el tamao mximo, en bytes, de los datos de la columna. Reemplazado. Obtiene o establece el nombre de la columna de origen asignada a DataSet y utilizada para cargar o devolver el valor de Value. Reemplazado. Establece u obtiene un valor que indica si la columna de origen acepta valores NULL. De este modo se

DbType

Direction

IsNullable

LocaleId

Offset

ParameterName

Precision

Scale

Size

SourceColumn

SourceColumnNullMapping

permite que SqlCommandBuilder genere correctamente instrucciones Update para las columnas que aceptan valores NULL. SourceVersion Reemplazado. Obtiene o establece el valor de DataRowVersion que se va a utilizar al cargar Value. Obtiene o establece el SqlDbType del parmetro. Obtiene o establece el valor del parmetro como tipo SQL. Obtiene o establece una string que representa como parmetro un tipo definido por el usuario. Reemplazado. Obtiene o establece el valor del parmetro. Obtiene el nombre de la base de datos donde est ubicada la coleccin de esquemas para esta instancia de XML. Obtiene el nombre de la coleccin de esquemas para esta instancia de XML.

SqlDbType SqlValue UdtTypeName

Value XmlSchemaCollectionDatabase

XmlSchemaCollectionName

XmlSchemaCollectionOwningSchema Esquema relacional propietario donde est ubicada la coleccin de esquemas para esta instancia de XML.

Mtodos pblicos

Nombre CreateObjRef

Descripcin Crea un objeto que contiene toda la informacin relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject). Sobrecargado. Determina si dos instancias de Object son iguales. (Se hereda de Object). Sirve como funcin hash para un tipo concreto. GetHashCode es apropiado para su utilizacin en algoritmos de hash y en estructuras de datos como las tablas hash. (Se hereda de Object).

Equals

GetHashCode

GetLifetimeService

Recupera el objeto de servicio de duracin actual que controla la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). Obtiene el objeto Type de la instancia actual. (Se hereda de Object).

GetType

InitializeLifetimeService Obtiene un objeto de servicio de duracin para controlar la directiva de duracin de esta instancia. (Se hereda de MarshalByRefObject). ReferenceEquals Determina si las instancias de Object especificadas son la misma instancia. (Se hereda de Object). Reemplazado. Restablece el tipo asociado a este objeto SqlParameter. Restablece el tipo asociado a este objeto SqlParameter. Reemplazado. Obtiene una cadena que contiene la propiedad ParameterName.

ResetDbType ResetSqlDbType ToString

Mtodos protegidos

Nombre Finalize

Descripcin Permite que un objeto Object intente liberar recursos y realizar otras operaciones de limpieza antes de que el objeto Object sea reclamado por el recolector de elementos no utilizados. (Se hereda de Object).

MemberwiseClone Sobrecargado. (Se hereda de MarshalByRefObject).

Implementaciones explcitas de interfaces

Nombre System.ICloneable.Clone

Descripcin Para obtener una descripcin de este miembro, vea Clone.

INDICE
C
command.Connection.Open, 19

D
DataSet, 13

F
Framework, 18

I
ICloneable, 20 IDataReader, 15

R
RecordsAffected, 15, 16

S
SqlBulkCopy., 4 SqlConnection, 14 SqlParameter, 21 System.Data, 20

U
Update, 13

BIBLIOGRAFIA

http://msdn.microsoft.com/es-ec/library/system.data.sqlclient.sqlparameter(v=vs.80).aspx