AccessDataSource.DataFile Eigenschaft

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Speicherort der MDB-Datei von Microsoft Access ab oder legt diesen fest.

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

Eigenschaftswert

String

Der Speicherort der MDB-Datei von Access. Absolute, relative und virtuelle Pfade werden unterstützt.

Ausnahmen

ArgumentException

Ein ungültiger Pfad wurde angegeben.

Beispiele

Dieser Abschnitt enthält drei Codebeispiele. Im ersten Codebeispiel wird veranschaulicht, wie Sie die Eigenschaft auf eine Northwind.mdb-Datei festlegen, die DataFile sich in demselben Verzeichnis wie auf der Web Forms-Seite befindet. Im zweiten Codebeispiel wird veranschaulicht, wie Sie die DataFile Eigenschaft auf den virtuellen Pfad einer Northwind.mdb-Datei festlegen, die sich in einem Verzeichnis mit dem Namen Datenbank befindet, das sich unter dem Verzeichnis befindet, in dem die Web Forms Seite vorhanden ist. Das dritte Codebeispiel veranschaulicht, wie Sie die Eigenschaft auf einen UNC-Pfad einer Northwind.mdb-Datei festlegen, die DataFile auf einer UNC-Freigabe verfügbar ist.

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Eigenschaft auf eine Northwind.mdb-Datei festlegen, die DataFile sich in demselben Verzeichnis wie auf der Web Forms-Seite befindet.

<%@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>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die DataFile Eigenschaft auf den virtuellen Pfad einer Northwind.mdb-Datei festlegen, die sich in einem Verzeichnis namens "Datenbank" befindet, das sich unter dem Verzeichnis befindet, in dem die Web Forms Seite vorhanden ist.

<%@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>

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Eigenschaft auf einen UNC-Pfad einer Northwind.mdb-Datei festlegen, die DataFile auf einer UNC-Freigabe verfügbar ist.

<%@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>

Hinweise

Die DataFile Eigenschaft ist ein virtueller, absoluter oder UNC-Verzeichnispfad zur Access.mdb-Datei, die das AccessDataSource Steuerelement darstellt. Wenn nur der Name der Datei eingegeben wird, gibt dies an, dass die MDB-Datei im selben Verzeichnis wie die derzeit ausgeführte Web Forms Seite oder Code gefunden wird. Relative Pfade mit Vorwärts- und Rückwärtsstrichen werden unterstützt. Ordnet z. B. "./test/test/Northwind.mdb" demselben Pfad wie ".\test\test\Northwind.mdb" und ."test/test/Northwind.mdb" UNC-Pfade, z "\\mymachine\somedatadirectory\Northwind.mdb". B. , werden ebenfalls unterstützt. Obwohl absolute physische Pfade unterstützt werden, sollten Sie die Verwendung vermeiden, da sie die Bereitstellung komplizieren können.

Konfigurieren von Berechtigungen für eine Access-Datenbank

Ein wichtiger Aspekt der Arbeit mit einer Access.mdb-Datei besteht darin, Berechtigungen ordnungsgemäß zu konfigurieren. Wenn eine Webanwendung eine Access-Datenbank verwendet, muss die Anwendung über leseberechtigungen für die MDB-Datei verfügen, damit sie auf die Daten zugreifen kann. Darüber hinaus muss die Anwendung über die Schreibberechtigung für den Ordner verfügen, der die MDB-Datei enthält. Schreibberechtigung ist erforderlich, da Access eine zusätzliche Datei mit der Erweiterung LDB erstellt, in der Informationen zu Datenbanksperren für gleichzeitige Benutzer verwaltet werden. Die LDB-Datei wird zur Laufzeit erstellt.

Standardmäßig werden ASP.NET Webanwendungen im Kontext eines lokalen Computerkontos namens ASPNET (für Microsoft Windows 2000 und Microsoft Windows XP) oder im Kontext des NETWORK SERVICE-Kontos (für Microsoft Windows Server 2003) ausgeführt. Beispiel: Für Windows 2000 oder Windows XP, wenn der Webserver "MyServer" heißt, ASP.NET Anwendungen auf dem MyServer-Computer im Kontext des lokalen Kontos MyServer\ASPNET ausgeführt werden.

Um daher eine Access-Datenbank in einer ASP.NET Webanwendung zu verwenden, müssen Sie den Ordner konfigurieren, der die Access-Datenbank enthält, um sowohl Lese- als auch Schreibberechtigungen zu besitzen.

Wenn Sie eine Website im Microsoft Visual Web Developer Web Development Tool erstellen, erstellt Visual Web Developer einen Ordner namens App_Data unterhalb des aktuellen Stammordners. Der Ordner ist so konzipiert, dass es sich um einen Speicher für Anwendungsdaten handelt, einschließlich Access-Datenbanken. Der ordner App_Data wird auch von ASP.NET verwendet, um Datenbanken zu speichern, die das System verwaltet, z. B. die Datenbank für Mitgliedschaft und Rollen. Wenn Visual Web Developer den ordner App_Data erstellt, gewährt er Lese- und Schreibberechtigungen für den Ordner für das ASPNET- oder NETWORK SERVICE-Benutzerkonto.

Hinweis

Als Sicherheitsmaßnahme konfiguriert Visual Web Developer auch den App_Data Ordner, sodass Dateien im Ordner nicht vom Webserver bereitgestellt werden. Speichern Sie keine Webseiten im ordner App_Data, da Benutzer einen Fehler sehen, wenn sie eine Seite aus diesem Ordner anfordern.

Gilt für