AccessDataSource.DataFile Propriedade

Definição

Obtém ou define o local do arquivo .mdb do 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 da propriedade

String

O local do arquivo .mdb do Access.The location of the Access .mdb file. Há suporte para caminhos absolutos, relativos e virtuais.Absolute, relative, and virtual paths are supported.

Exceções

Um caminho inválido foi fornecido.An invalid path was given.

Exemplos

Esta seção contém três exemplos de código.This section contains three code examples. O primeiro exemplo de código demonstra como definir a DataFile propriedade como um arquivo Northwind. mdb que reside no mesmo diretório que a página de 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. O segundo exemplo de código demonstra como definir a DataFile propriedade para o caminho virtual de um arquivo Northwind. mdb que reside em um diretório chamado banco de dados, que está abaixo do diretório no qual a página Web Forms está.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. O terceiro exemplo de código demonstra como definir a DataFile propriedade como um caminho UNC de um arquivo Northwind. mdb que está disponível em um compartilhamento 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.

O exemplo de código a seguir demonstra como definir a DataFile propriedade para um arquivo Northwind. mdb que reside no mesmo diretório que a página de 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>

O exemplo de código a seguir demonstra como definir a DataFile propriedade para o caminho virtual de um arquivo Northwind. mdb que reside em um diretório chamado banco de dados, que está abaixo do diretório no qual a página Web Forms está.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>

O exemplo de código a seguir demonstra como definir a DataFile propriedade como um caminho UNC de um arquivo Northwind. mdb que está disponível em um compartilhamento 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>

Comentários

A DataFile propriedade é um caminho de diretório virtual, absoluto ou UNC para o arquivo Access. mdb que o AccessDataSource controle representa.The DataFile property is a virtual, absolute, or UNC directory path to the Access .mdb file that the AccessDataSource control represents. Se apenas o nome do arquivo for inserido, isso indica que o arquivo. mdb é encontrado no mesmo diretório que o código ou página de Web Forms em execução no momento.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. Há suporte para caminhos relativos com barras para frente e para trás.Relative paths with both forward and backward slashes are supported. Por exemplo, "./test/test/Northwind.mdb" mapeia para o mesmo caminho de ".\test\test\Northwind.mdb" e "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". Os caminhos UNC, como "\\mymachine\somedatadirectory\Northwind.mdb" , também têm suporte.UNC paths, such as "\\mymachine\somedatadirectory\Northwind.mdb", are also supported. Embora haja suporte para caminhos físicos absolutos, você deve evitar usá-los porque eles podem complicar a implantação.Although absolute physical paths are supported, you should avoid using them because they can complicate deployment.

Configurando permissões para um banco de dados do AccessConfiguring Permissions for an Access Database

Um aspecto importante do trabalho com um arquivo Access. mdb é configurar as permissões corretamente.An important aspect of working with an Access .mdb file is to configure permissions properly. Quando um aplicativo Web usa um banco de dados do Access, o aplicativo deve ter permissão de leitura para o arquivo. mdb para que ele possa acessar os dados.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. Além disso, o aplicativo deve ter permissão de gravação para a pasta que contém o arquivo. mdb.In addition, the application must have Write permission to the folder containing the .mdb file. A permissão de gravação é necessária porque o Access cria um arquivo adicional com a extensão. ldb, na qual ele mantém informações sobre bloqueios de banco de dados para usuários 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. O arquivo. ldb é criado em tempo de execução.The .ldb file is created at run time.

Por padrão, os aplicativos Web do ASP.NET são executados no contexto de uma conta de computador local chamada ASPNET (para Microsoft Windows 2000 e Microsoft Windows XP) ou no contexto da conta de serviço de rede (para o 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 exemplo, para Windows 2000 ou Windows XP, se o servidor Web for nomeado como meuservidor, os aplicativos ASP.NET no computador meuservidor serão executados no contexto da conta 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.

Portanto, para usar um banco de dados do Access em um aplicativo Web ASP.NET, você deve configurar a pasta que contém o banco de dados do Access para ter permissões de leitura e gravação.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.

Quando você cria um site da Web na ferramenta de desenvolvimento para Web do Microsoft Visual Web Developer, o Visual Web Developer cria uma pasta chamada App_Data abaixo da pasta raiz atual.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. A pasta foi projetada para ser um repositório de dados de aplicativo, incluindo bancos de dado do Access.The folder is designed to be a store for application data, including Access databases. A pasta de App_Data também é usada pelo ASP.NET para armazenar os bancos de dados que o sistema mantém, como o Database para associação e funções.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. Quando o Visual Web Developer cria a pasta App_Data, ele concede permissões de leitura e gravação para a pasta para a conta de usuário do serviço de rede ou ASPNET.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.

Observação

Como medida de segurança, o Visual Web Developer também configura a pasta App_Data para que os arquivos na pasta não sejam servidos pelo servidor Web.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. Não armazene páginas da Web na pasta App_Data, pois os usuários verão um erro se solicitarem uma página dessa pasta.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.

Aplica-se a

Confira também