Ce sujet n'a pas encore été évalué - Évaluez ce sujet

AccessDataSource.DataFile, propriété

.NET Framework 3.5

Autres versions

Mise à jour : novembre 2007

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

Espace de noms : System.Web.UI.WebControls
Assembly : System.Web (dans System.Web.dll)

Syntaxe

C++

public string DataFile { get; set; }

/** @property */
public String get_DataFile()
/** @property */
public  void set_DataFile(String value)

JScript

public function get DataFile () : String
public function set DataFile (value : String)

ASP.NET

<asp:AccessDataSource DataFile="String" />

Valeur de propriété

Type : System.String

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

Exceptions

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

Notes

La propriété DataFile est un chemin d'accès du répertoire virtuel, absolu ou UNC qui mène au fichier Access .mdb que le contrôle AccessDataSource représente. Si le nom du fichier uniquement est entré, cela indique que le fichier .mdb est recherché dans le même répertoire que la page Web Forms ou le code en cours d'exécution. Les chemins d'accès relatifs comportant des barres obliques à la fois vers l'avant et vers l'arrière sont pris en charge. Par exemple, "./test/test/Northwind.mdb" mappe au même chemin d'accès 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 d'accès physiques absolus soient pris en charge, vous devez éviter de les utiliser parce qu'ils peuvent compliquer le déploiement.

Configuration d'autorisations pour une base de données Access

Un aspect important de l'utilisation d'un fichier Accès .mdb consiste à configurer correctement les autorisations. Lorsqu'une application Web utilise une base de données Access, l'application doit avoir l'autorisation Read pour le fichier .mdb afin qu'elle puisse accéder aux données. En outre, l'application doit avoir l'autorisation Write pour le dossier contenant le fichier .mdb. L'autorisation Write est requise, car Access crée un fichier supplémentaire avec l'extension .ldb dans lequel il conserve des informations relatives aux verrouillages de base de données pour les utilisateurs simultanés. Le fichier .ldb est créé au moment de l'exécution.

Par défaut, les applications Web ASP.NET 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 de Service Réseau (pour Microsoft Windows Server 2003). Par exemple, pour Windows 2000 ou Windows XP, si le serveur Web est appelé MonServeur, les applications ASP.NET sur l'ordinateur MonServeur s'exécutent dans le contexte du compte local MonServeur\ASPNET.

Par conséquent, vous devez configurer le dossier contenant la base de données Access pour disposer des autorisations Write et Read afin de pouvoir utiliser une base de données Access dans une application Web ASP.NET.

Lorsque vous créez un site Web dans l'outil de développement Web Microsoft Visual Web Developer, cet outil crée un dossier nommé App_Data au-dessous du dossier racine actuel. Le dossier est conçu pour être un magasin de données d'application, y compris les bases de données Access. Le dossier App_Data est également utilisé par ASP.NET pour stocker des bases de données que le système conserve, 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 les autorisations Write et Read pour le dossier au compte d'utilisateur ASPNET ou Service Réseau.

Remarque :
Une mesure de sécurité de Visual Web Developer consiste également à configurer le dossier App_Data afin que les fichiers contenus dans le dossier ne soient pas fournis par le serveur Web. Ne stocke pas de pages Web dans le dossier App_Data, car les utilisateurs engendreront une erreur s'ils demandent une page de ce dossier.

Exemples

Cette section contient trois exemples de code. Le premier exemple de code illustre comment affecter à la propriété DataFile un fichier Northwind.mdb qui réside dans le même répertoire que la page Web Forms. Le deuxième exemple de code illustre comment affecter à la propriété DataFile le chemin d'accès virtuel d'un fichier Northwind.mdb qui réside dans un répertoire nommé Database situé sous le répertoire contenant la page Web Forms. Le troisième exemple de code illustre comment affecter à la propriété DataFile un chemin d'accès UNC d'un fichier Northwind.mdb disponible sur un partage UNC.

L'exemple de code suivant illustre comment affecter à la propriété DataFile un fichier Northwind.mdb qui réside 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="VJ#" %>
<!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 illustre comment affecter à la propriété DataFile le chemin d'accès virtuel d'un fichier Northwind.mdb qui réside dans un répertoire nommé Database situé sous le répertoire contenant 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="VJ#" %>
<!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 illustre comment affecter à la propriété DataFile un chemin d'accès 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="VJ#" %>
<!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>

Plateformes

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professionnel Édition x64, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Informations de version