AccessDataSource.DataFile Propriété

Référence

Définition

Espace de noms:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient ou définit l'emplacement du fichier Microsoft Access .mdb.

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

Valeur de propriété

String

Emplacement du fichier Access .mdb. Des chemins d'accès absolu, relatif et virtuel sont pris en charge.

Exceptions

ArgumentException

Un chemin d'accès non valide a été donné.

Exemples

Cette section contient trois exemples de code. Le premier exemple de code montre comment définir la DataFile propriété sur un fichier Northwind.mdb qui réside dans le même répertoire que la page Web Forms. Le deuxième exemple de code montre comment définir la DataFile propriété sur le chemin d’accès virtuel d’un fichier Northwind.mdb qui réside dans un répertoire nommé Database, qui se trouve sous le répertoire dans lequel se trouve la page Web Forms. Le troisième exemple de code montre comment définir la DataFile propriété sur un chemin UNC d’un fichier Northwind.mdb disponible sur un partage UNC.

L’exemple de code suivant montre comment définir la DataFile propriété sur un fichier Northwind.mdb qui se trouve dans le même répertoire que la page 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>

L’exemple de code suivant montre comment définir la DataFile propriété sur le chemin d’accès virtuel d’un fichier Northwind.mdb qui réside dans un répertoire nommé Database, qui se trouve sous le répertoire dans lequel se trouve la page 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="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>

L’exemple de code suivant montre comment définir la DataFile propriété sur un chemin UNC d’un fichier Northwind.mdb disponible sur un partage 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>

Remarques

La DataFile propriété est un chemin d’accès de répertoire virtuel, absolu ou UNC au fichier Access .mdb représenté par le AccessDataSource contrôle. Si seul le nom du fichier est entré, cela indique que le fichier .mdb se trouve dans le même répertoire que la page ou le code Web Forms en cours d’exécution. Les chemins relatifs avec des barres obliques vers l’avant et vers l’arrière sont pris en charge. Par exemple, "./test/test/Northwind.mdb" mappe au même chemin que ".\test\test\Northwind.mdb" et "test/test/Northwind.mdb". Les chemins UNC, tels que "\\mymachine\somedatadirectory\Northwind.mdb", sont également pris en charge. Bien que les chemins physiques absolus soient pris en charge, vous devez éviter de les utiliser, car ils peuvent compliquer le déploiement.

Configuration des autorisations pour une base de données Access

Un aspect important de l’utilisation d’un fichier Access .mdb consiste à configurer correctement les autorisations. Lorsqu’une application web utilise une base de données Access, l’application doit disposer d’une autorisation de lecture pour le fichier .mdb afin qu’elle puisse accéder aux données. En outre, l’application doit disposer de l’autorisation d’écriture dans le dossier contenant le fichier .mdb. L’autorisation d’écriture est requise, car Access crée un fichier supplémentaire avec l’extension .ldb dans laquelle il conserve des informations sur les verrous de base de données pour les utilisateurs simultanés. Le fichier .ldb est créé au moment de l’exécution.

Par défaut, ASP.NET applications web s’exécutent dans le contexte d’un compte d’ordinateur local appelé ASPNET (pour Microsoft Windows 2000 et Microsoft Windows XP), ou dans le contexte du compte NETWORK SERVICE (pour Microsoft Windows Server 2003). Par exemple, pour Windows 2000 ou Windows XP, si le serveur Web est nommé MyServer, ASP.NET applications sur l’ordinateur MyServer s’exécutent dans le contexte du compte local MyServer\ASPNET.

Par conséquent, pour utiliser une base de données Access dans une application web ASP.NET, vous devez configurer le dossier contenant la base de données Access pour disposer des autorisations lecture et écriture.

Lorsque vous créez un site web dans l’outil de développement web Microsoft Visual Web Developer, Visual Web Developer crée un dossier nommé App_Data sous le dossier racine actuel. Le dossier est conçu pour être un magasin pour les données d’application, y compris les bases de données Access. Le dossier App_Data est également utilisé par ASP.NET pour stocker les bases de données que le système gère, telles que la base de données pour l’appartenance et les rôles. Lorsque Visual Web Developer crée le dossier App_Data, il accorde des autorisations de lecture et d’écriture pour le dossier au compte d’utilisateur ASPNET ou NETWORK SERVICE.

Notes

En tant que mesure de sécurité, Visual Web Developer configure également le dossier App_Data afin que les fichiers du dossier ne soient pas servis par le serveur Web. Ne stockez pas de pages Web dans le dossier App_Data, car les utilisateurs verront une erreur s’ils demandent une page à partir de ce dossier.

S’applique à