AccessDataSource.DataFile Propiedad

Definición

Obtiene o establece la ubicación del archivo .mdb de Microsoft Access.Gets or sets the location of the Microsoft Access .mdb file.

public:
 property System::String ^ DataFile { System::String ^ get(); void set(System::String ^ value); };
public string DataFile { get; set; }
member this.DataFile : string with get, set
Public Property DataFile As String

Valor de propiedad

String

La ubicación del archivo .mdb de Access.The location of the Access .mdb file. Se admiten rutas de acceso absolutas, relativas y virtuales.Absolute, relative, and virtual paths are supported.

Excepciones

Se proporcionó una ruta de acceso no válida.An invalid path was given.

Ejemplos

Esta sección contiene tres ejemplos de código.This section contains three code examples. En el primer ejemplo de código se muestra cómo establecer la DataFile propiedad en un archivo Northwind. mdb que reside en el mismo directorio que la página de formularios Web Forms.The first code example demonstrates how to set the DataFile property to a Northwind.mdb file that resides in the same directory as the Web Forms page. En el segundo ejemplo de código se muestra cómo establecer la DataFile propiedad en la ruta de acceso virtual de un archivo Northwind. mdb que se encuentra en un directorio denominado Database, que está debajo del directorio en el que se encuentra la página de formularios Web Forms.The second code example demonstrates how to set the DataFile property to the virtual path of a Northwind.mdb file that resides in a directory named Database, which is beneath the directory that the Web Forms page is in. El tercer ejemplo de código muestra cómo establecer la DataFile propiedad en una ruta de acceso UNC de un archivo Northwind. mdb que está disponible en un recurso compartido UNC.The third code example demonstrates how to set the DataFile property to a UNC path of a Northwind.mdb file that is available on a UNC share.

En el ejemplo de código siguiente se muestra cómo establecer la DataFile propiedad en un archivo Northwind. mdb que reside en el mismo directorio que la página de formularios Web Forms.The following code example demonstrates how to set the DataFile property to a Northwind.mdb file that resides in the same directory as the Web Forms page.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataSet"
        DataFile="~/App_Data/Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        AllowSorting="True"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataSet"
        DataFile="~/App_Data/Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        AllowSorting="True"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

En el ejemplo de código siguiente se muestra cómo establecer la DataFile propiedad en la ruta de acceso virtual de un archivo Northwind. mdb que se encuentra en un directorio denominado Database, que está debajo del directorio en el que se encuentra la página de formularios Web Forms.The following code example demonstrates how to set the DataFile property to the virtual path of a Northwind.mdb file that resides in a directory named Database, which is beneath the directory that the Web Forms page is in.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataReader"
        DataFile="database/Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataReader"
        DataFile="database/Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

En el ejemplo de código siguiente se muestra cómo establecer la DataFile propiedad en una ruta de acceso UNC de un archivo Northwind. mdb que está disponible en un recurso compartido UNC.The following code example demonstrates how to set the DataFile property to a UNC path of a Northwind.mdb file that is available on a UNC share.

<%@Page  Language="C#" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataReader"
        DataFile="\\uncpath\Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>
<%@Page  Language="VB" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
    <form id="form1" runat="server">

      <asp:AccessDataSource
        id="AccessDataSource1"
        runat="server"
        DataSourceMode="DataReader"
        DataFile="\\uncpath\Northwind.mdb"
        SelectCommand="SELECT FirstName, LastName, Title FROM Employees">
      </asp:AccessDataSource>

      <asp:GridView
        id="GridView1"
        runat="server"
        DataSourceID="AccessDataSource1">
      </asp:GridView>

    </form>
  </body>
</html>

Comentarios

La DataFile propiedad es una ruta de acceso de directorio virtual, absoluta o UNC para el archivo. mdb de Access que el AccessDataSource control representa.The DataFile property is a virtual, absolute, or UNC directory path to the Access .mdb file that the AccessDataSource control represents. Si solo se escribe el nombre del archivo, esto indica que el archivo. mdb se encuentra en el mismo directorio que la página o el código de formularios Web Forms que se está ejecutando actualmente.If only the name of the file is entered, this indicates that the .mdb file is found in the same directory as the currently executing Web Forms page or code. Se admiten las rutas de acceso relativas con barras diagonales y hacia atrás.Relative paths with both forward and backward slashes are supported. Por ejemplo, "./test/test/Northwind.mdb" se asigna a la misma ruta de acceso que ".\test\test\Northwind.mdb" y "test/test/Northwind.mdb" .For example, "./test/test/Northwind.mdb" maps to the same path as ".\test\test\Northwind.mdb" and "test/test/Northwind.mdb". También se admiten rutas de acceso UNC, como "\\mymachine\somedatadirectory\Northwind.mdb" .UNC paths, such as "\\mymachine\somedatadirectory\Northwind.mdb", are also supported. Aunque se admiten las rutas de acceso físicas absolutas, debe evitar usarlas porque pueden complicar la implementación.Although absolute physical paths are supported, you should avoid using them because they can complicate deployment.

Configuración de permisos para una base de datos de AccessConfiguring Permissions for an Access Database

Un aspecto importante de trabajar con un archivo. mdb de Access es configurar los permisos correctamente.An important aspect of working with an Access .mdb file is to configure permissions properly. Cuando una aplicación web utiliza una base de datos de Access, la aplicación debe tener permiso de lectura en el archivo. mdb para que pueda tener acceso a los datos.When a Web application uses an Access database, the application must have Read permission to the .mdb file so that it can access the data. Además, la aplicación debe tener permiso de escritura en la carpeta que contiene el archivo. mdb.In addition, the application must have Write permission to the folder containing the .mdb file. Se requiere permiso de escritura porque Access crea un archivo adicional con la extensión. ldb en el que mantiene información acerca de los bloqueos de base de datos para usuarios simultáneos.Write permission is required because Access creates an additional file with the extension .ldb in which it maintains information about database locks for concurrent users. El archivo. ldb se crea en tiempo de ejecución.The .ldb file is created at run time.

De forma predeterminada, las aplicaciones Web de ASP.NET se ejecutan en el contexto de una cuenta de equipo local llamada ASPNET (para Microsoft Windows 2000 y Microsoft Windows XP), o en el contexto de la cuenta de servicio de red (para Microsoft Windows Server 2003).By default, ASP.NET Web applications run in the context of a local machine account called ASPNET (for Microsoft Windows 2000 and Microsoft Windows XP), or in the context of the NETWORK SERVICE account (for Microsoft Windows Server 2003). Por ejemplo, para Windows 2000 o Windows XP, si el servidor Web se denomina alserver, las aplicaciones de ASP.NET en el equipo de servidor se ejecutan en el contexto de la cuenta local MyServer\ASPNET.For example, for Windows 2000 or Windows XP, if the Web server is named MyServer, ASP.NET applications on the MyServer computer run in the context of the local account MyServer\ASPNET.

Por lo tanto, para utilizar una base de datos de Access en una aplicación Web de ASP.NET, debe configurar la carpeta que contiene la base de datos de Access para que tenga permisos de lectura y escritura.Therefore, to use an Access database in an ASP.NET Web application, you must configure the folder containing the Access database to have both Read and Write permissions.

Cuando se crea un sitio web en la herramienta de desarrollo web de Microsoft Visual Web Developer, Visual Web Developer crea una carpeta denominada App_Data debajo de la carpeta raíz actual.When you create a Web site in the Microsoft Visual Web Developer Web development tool, Visual Web Developer creates a folder named App_Data below the current root folder. La carpeta está diseñada para ser un almacén de datos de aplicaciones, incluidas las bases de datos de Access.The folder is designed to be a store for application data, including Access databases. ASP.NET también usa la carpeta App_Data para almacenar las bases de datos que el sistema mantiene, como la base de datos para la pertenencia y los roles.The App_Data folder is also used by ASP.NET to store databases that the system maintains, such as the database for membership and roles. Cuando Visual Web Developer crea la carpeta App_Data, concede permisos de lectura y escritura para la carpeta a la cuenta de usuario ASPNET o NETWORK SERVICE.When Visual Web Developer creates the App_Data folder, it grants Read and Write permissions for the folder to the ASPNET or NETWORK SERVICE user account.

Nota

Como medida de seguridad, Visual Web Developer también configura la carpeta App_Data de modo que el servidor Web no atienda los archivos de la carpeta.As a security measure, Visual Web Developer also configures the App_Data folder so that files in the folder are not served by the Web server. No almacene ninguna página web en la carpeta App_Data, ya que los usuarios verán un error si solicitan una página de esa carpeta.Do not store any Web pages in the App_Data folder, because users will see an error if they request a page from that folder.

Se aplica a

Consulte también