AccessDataSource.DataFile Propriedade

Referência

Definição

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Obtém ou define o local do arquivo .mdb do Microsoft Access.

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. Há suporte para caminhos absolutos, relativos e virtuais.

Exceções

ArgumentException

Um caminho inválido foi fornecido.

Exemplos

Esta seção contém três exemplos de código. 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 do Web Forms. 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 do Web Forms está. O terceiro exemplo de código demonstra como definir a DataFile propriedade como um caminho UNC de um arquivo Northwind.mdb disponível em um compartilhamento UNC.

O exemplo de código a seguir demonstra como definir a DataFile propriedade como um arquivo Northwind.mdb que reside no mesmo diretório que a página do Web Forms.

<%@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 em que a página do Web Forms está.

<%@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 disponível em um compartilhamento UNC.

<%@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 .mdb do Access que o AccessDataSource controle representa. Se apenas o nome do arquivo for inserido, isso indicará que o arquivo .mdb será encontrado no mesmo diretório que a página ou o código do Web Forms em execução no momento. Há suporte para caminhos relativos com barras para frente e para trás. Por exemplo, "./test/test/Northwind.mdb" mapeia para o mesmo caminho que ".\test\test\Northwind.mdb" e "test/test/Northwind.mdb". Também há suporte para caminhos UNC, como "\\mymachine\somedatadirectory\Northwind.mdb", . Embora haja suporte para caminhos físicos absolutos, você deve evitar usá-los porque eles podem complicar a implantação.

Configurando permissões para um banco de dados de acesso

Um aspecto importante de trabalhar com um arquivo do Access .mdb é configurar as permissões corretamente. 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 possa acessar os dados. Além disso, o aplicativo deve ter permissão de Gravação na pasta que contém o arquivo .mdb. A permissão de gravação é necessária porque o Access cria um arquivo adicional com a extensão .ldb na qual mantém informações sobre bloqueios de banco de dados para usuários simultâneos. O arquivo .ldb é criado em tempo de execução.

Por padrão, ASP.NET aplicativos Web 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 NETWORK SERVICE (para o Microsoft Windows Server 2003). Por exemplo, para Windows 2000 ou Windows XP, se o servidor Web for chamado myServer, ASP.NET aplicativos no computador MyServer forem executados no contexto da conta local 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.

Quando você cria um site na ferramenta de desenvolvimento web do Desenvolvedor Web do Visual Web da Microsoft, o Desenvolvedor web do Visual cria uma pasta chamada App_Data abaixo da pasta raiz atual. A pasta foi projetada para ser um repositório de dados do aplicativo, incluindo bancos de dados do Access. A pasta App_Data também é usada por ASP.NET para armazenar bancos de dados que o sistema mantém, como o banco de dados para associação e funções. 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 ASPNET ou NETWORK SERVICE.

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 atendidos pelo servidor Web. Não armazene nenhuma página da Web na pasta App_Data, pois os usuários verão um erro se solicitarem uma página dessa pasta.

Aplica-se a

Compartilhar via