AccessDataSource.DataFile Proprietà

Riferimento

Definizione

Spazio dei nomi:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Ottiene o imposta la posizione del file mdb di 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

Valore della proprietà

String

Posizione del file mdb di Access. Sono supportati percorsi assoluti, relativi e virtuali.

Eccezioni

ArgumentException

È stato assegnato un percorso non valido.

Esempio

Questa sezione contiene tre esempi di codice. Il primo esempio di codice illustra come impostare la DataFile proprietà su un file Northwind.mdb che si trova nella stessa directory della pagina Web Forms. Nel secondo esempio di codice viene illustrato come impostare la DataFile proprietà sul percorso virtuale di un file Northwind.mdb che si trova in una directory denominata Database, che si trova sotto la directory in cui si trova la pagina Web Forms. Il terzo esempio di codice illustra come impostare la DataFile proprietà su un percorso UNC di un file Northwind.mdb disponibile in una condivisione UNC.

Nell'esempio di codice seguente viene illustrato come impostare la DataFile proprietà su un file Northwind.mdb che si trova nella stessa directory della pagina 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>

Nell'esempio di codice seguente viene illustrato come impostare la DataFile proprietà sul percorso virtuale di un file Northwind.mdb che si trova in una directory denominata Database, che si trova sotto la directory in cui si trova la pagina 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>

Nell'esempio di codice seguente viene illustrato come impostare la DataFile proprietà su un percorso UNC di un file Northwind.mdb disponibile in una condivisione 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>

Commenti

La DataFile proprietà è un percorso di directory virtuale, assoluto o UNC per il file mdb di Access rappresentato dal AccessDataSource controllo. Se viene immesso solo il nome del file, questo indica che il file con estensione mdb si trova nella stessa directory della pagina o del codice attualmente in esecuzione Web Forms. Sono supportati i percorsi relativi con barre avanti e indietro. Ad esempio, "./test/test/Northwind.mdb" esegue il mapping allo stesso percorso di ".\test\test\Northwind.mdb" e "test/test/Northwind.mdb". Sono supportati anche i percorsi UNC, ad esempio "\\mymachine\somedatadirectory\Northwind.mdb", . Anche se sono supportati percorsi fisici assoluti, è consigliabile evitare di usarli perché possono complicare la distribuzione.

Configurazione delle autorizzazioni per un database di Access

Un aspetto importante dell'uso di un file con estensione mdb di Access consiste nel configurare correttamente le autorizzazioni. Quando un'applicazione Web usa un database di Access, l'applicazione deve disporre dell'autorizzazione lettura per il file con estensione mdb in modo che possa accedere ai dati. Inoltre, l'applicazione deve disporre dell'autorizzazione di scrittura per la cartella contenente il file con estensione mdb. L'autorizzazione di scrittura è necessaria perché Access crea un file aggiuntivo con l'estensione ldb in cui gestisce informazioni sui blocchi di database per gli utenti simultanei. Il file con estensione ldb viene creato in fase di esecuzione.

Per impostazione predefinita, ASP.NET applicazioni Web vengono eseguite nel contesto di un account computer locale denominato ASPNET (per Microsoft Windows 2000 e Microsoft Windows XP) o nel contesto dell'account del servizio di rete (per Microsoft Windows Server 2003). Per Windows 2000 o Windows XP, ad esempio, se il server Web è denominato MyServer, applicazioni ASP.NET sul computer MyServer eseguite nel contesto dell'account locale Myserver\aspnet.

Pertanto, per usare un database di Access in un'applicazione Web ASP.NET, è necessario configurare la cartella contenente il database di Access in modo che disponga delle autorizzazioni di lettura e scrittura.

Quando si crea un sito Web nello strumento di sviluppo Web Visual Web Developer Microsoft, Visual Web Developer crea una cartella denominata App_Data sotto la cartella radice corrente. La cartella è progettata per essere un archivio per i dati dell'applicazione, inclusi i database di Access. La cartella App_Data viene usata anche da ASP.NET per archiviare i database gestiti dal sistema, ad esempio il database per l'appartenenza e i ruoli. Quando Visual Web Developer crea la cartella App_Data, concede le autorizzazioni lettura e scrittura per la cartella all'account utente ASPNET o NETWORK SERVICE.

Nota

Come misura di sicurezza, Visual Web Developer configura anche la cartella App_Data in modo che i file nella cartella non vengano gestiti dal server Web. Non archiviare pagine Web nella cartella App_Data, perché gli utenti visualizzeranno un errore se richiedono una pagina da tale cartella.

Si applica a