Crear la biblioteca de clases

Este tutorial requiere que se configuren algunos parámetros como requisito previo.

Requisitos previos de configuración de la base de datos

1. Configuración de SQL Server:
   • Si tiene instalado SQL Server (o la versión OEM, MSDE), debe configurarse de modo que requiera la Autenticación de SQL Server.
   • Si no tiene instalado SQL Server (ni la versión OEM, MSDE), debe instalar MSDE con la autenticación de SQL Server establecida en "True".
2. Se debe instalar la base de datos Northwind incluida con SQL Server y verificar que requiere la autenticación de SQL Server.
3. Se debe crear una cuenta de acceso limitado para utilizarla en el sitio Web.

Para crear una biblioteca de clases que contenga un método estático que devuelva IDataReader

Para instalar MSDE con la autenticación de SQL Server, o la base de datos Northwind, vaya a las siguientes secciones de Configuración del sistema de esta documentación:

• Instalación de MSDE con autenticación de Windows o SQL Server
• Instalación de la base de datos Northwind
• Seguridad: crear una cuenta de base de datos de acceso limitado

Una vez configurado SQL Server y la base de datos Northwind, podrá crear una biblioteca de clases que devuelva valores de la base de datos Northwind como IDataReader.

Nota
Este tutorial usa la base de datos Northwind con SQL Server, pero se puede utilizar cualquier base de datos compatible con OleDb.

1. En el menú Archivo, seleccione Nuevo y haga clic en Proyecto.

2. En el cuadro de diálogo Nuevo proyecto, seleccione una carpeta de lenguaje para C# o Visual Basic en la lista Tipos de proyecto.

3. En la lista Plantillas, haga clic en Biblioteca de clases.

4. En el campo Nombre, reemplace el nombre de proyecto predeterminado por "VB_Lib_DataLayer" [Visual Basic] o "CS_Lib_DataLayer" [C#] y haga clic en Aceptar.

5. En el Explorador de soluciones, haga clic con el botón secundario en la clase predeterminada (Class1) y haga clic en Eliminar.

6. En el Explorador de soluciones, haga clic con el botón secundario en el nombre de proyecto en negrita, elija Agregar y, a continuación, haga clic en Clase.

7. En el cuadro de diálogo Agregar nuevo elemento, en la vista Plantillas, seleccione la plantilla denominada "Clase".

8. En el campo Nombre, escriba DataCenter y, a continuación, haga clic en Agregar.

9. Si usa Visual Basic, escriba Option Strict On al principio de la clase.

10. Encima de la firma de clase, agregue una declaración "Imports" [Visual Basic] o "using" [C#] en la parte superior de la clase para los espacios de nombres System.Data y System.Data.OleDb (si aún no se han declarado estos espacios de nombres).

``` vb
Imports System.Data
Imports System.Data.OleDb
```

``` csharp
using System.Data;
using System.Data.OleDb;
```

11. En el nivel de clase, cree una constante de cadena privada para la cadena de conexión OleDb.

<table>
<colgroup>
<col style="width: 100%" />
</colgroup>
<thead>
<tr class="header">
<th><img src="images\z15yzzew.alert_note(es-es,VS.90).gif" class="note" />Atención</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Por razones de seguridad, es importante utilizar una cuenta de base de datos con permisos de acceso limitado. Para obtener más información, vea <a href="ms227498(v=vs.90).md">Seguridad: crear una cuenta de base de datos de acceso limitado</a>.</p></td>
</tr>
</tbody>
</table>

En el código escrito, reemplace el nombre del servidor de ejemplo DBServer01 y la contraseña de ejemplo 1234 (que se muestra a continuación) por el nombre del servidor y la contraseña de su base de datos.

``` vb
Private Const OLEDB_CONNECTION_STRING As String =
"provider=sqloledb;Data Source=DBSERVER01;Initial
Catalog=Northwind;User Id=limitedPermissionAccount;Password=1234"
```

``` csharp
private const string OLEDB_CONNECTION_STRING =
"provider=sqloledb;Data Source=DBSERVER01;Initial
Catalog=Northwind;User Id=limitedPermissionAccount;Password=1234";
```

12. Cree una segunda constante de cadena privada para la consulta de base de datos.

    Private Const CUSTOMER_TABLE_QUERY As String = "SELECT CustomerID,
    CompanyName, ContactName, Address, City FROM Customers"
    

    private const string CUSTOMER_TABLE_QUERY = "SELECT CustomerID,
    CompanyName, ContactName, Address, City FROM Customers";
    

13. Cree un método público "Shared" [Visual Basic] o "static" [C#] denominado GetCustomersUsingOleDb() que devuelva IDataReader.

``` vb
Public Shared Function GetCustomersUsingOleDb() As IDataReader
End Function
```

``` csharp
public static IDataReader GetCustomersUsingOleDb()
{
}
```

14. Dentro de este método, declare y cree una instancia de OleDbConnection y pase la constante OLEDB_CONNECTION_STRING.

    Dim myOleDbConnection As OleDbConnection = New
    OleDbConnection(OLEDB_CONNECTION_STRING)
    

    OleDbConnection oleDbConnection = new
    OleDbConnection(OLEDB_CONNECTION_STRING);
    

15. Llame al método Open() desde la instancia de OleDbConnection para abrir la conexión de base de datos.

``` vb
myOleDbConnection.Open()
```

``` csharp
oleDbConnection.Open();
```

16. Declare y cree una instancia de OleDbCommand y pase la constante CUSTOMER_TABLE_QUERY y la instancia de OleDbConnection.

    Dim myOleDbCommand As OleDbCommand = New
    OleDbCommand(CUSTOMER_TABLE_QUERY, myOleDbConnection)
    

    OleDbCommand oleDbCommand = new OleDbCommand(CUSTOMER_TABLE_QUERY,
    oleDbConnection);
    

17. Llame al método ExecuteReader() de la instancia de OleDbCommand y pásele una instancia de IDataReader.

``` vb
Dim myIDataReader As IDataReader = myOleDbCommand.ExecuteReader()
```

``` csharp
IDataReader iDataReader = oleDbCommand.ExecuteReader();
```

18. Devuelva la instancia IDataReader desde el método.

    Return myIDataReader
    

    return iDataReader;
    

19. En el menú Generar, haga clic en Generar solución.

20. En el menú Archivo, haga clic en Cerrar solución.