SqlDataConnection-Typanbieter (F#)

Artikel
02/20/2013

Stellt die Typen, die in einer SQL-Datenbank zuzugreifen.

Namespace/Module Path: Microsoft.FSharp.Data.TypeProviders

Assembly: FSharp.Data.TypeProviders (in FSharp.Data.TypeProviders.dll)

type SqlDataConnection<?ConnectionString : string,
                       ?ConnectionStringName : string,
                       ?LocalSchemaFile : string,
                       ?ForceUpdate : bool,
                       ?Pluralize : bool,
                       ?Views : bool,
                       ?Functions : bool,
                       ?ConfigFile : string,
                       ?DataDirectory : string,
                       ?ResolutionFolder : string,
                       ?StoredProcedures : bool,
                       ?Timeout : int,
                       ?ContextTypeName : string,
                       ?Serializable : bool>

Statikähnliche Parameter

Typparameter	Description
Zeichenfolge: Zeichenfolge	Die Verbindungszeichenfolge für die Datenbankverbindung.Wenn Sie Visual Studio verwenden, kann eine Verbindungszeichenfolge in den Datenbankeigenschaften im Fenster "Server-Explorer" gefunden werden.
ConnectionStringName: Zeichenfolge	Der Name der Verbindungszeichenfolge für die Datenbankverbindung in der Konfigurationsdatei.
? LocalSchemaFile: Zeichenfolge	Der Pfad zu einer DBML-Datei, die das Schema enthält.Der Standardwert ist keine lokale Schemadatei.Diese Option wird häufig mit ForceUpdate verwendet.
? ForceUpdate: bool	Erfordert, dass ein, direkte Verbindung zur Datenbank zur Entwurfszeit verfügbar ist und erzwingt die lokale Schemadatei, aktualisiert werden.Der Standardwert ist true.Wenn ForceUpdate falsch, antwortet der Anbieter auf Änderungen in LocalSchemaFile.
? Pluralize: bool	Wenn true, Verwendungspluralformen für die generierten Typnamen.Die generierten Pluralformen basieren auf englische Sprachregeln.Der Standardwert ist false.
? Ansichten: bool	Wenn true, Exposeedatenbankansichten in den generierten Typen.Der Standardwert ist true.
? Funktionen: bool	Wenn true, Exposeedatenbankfunktionen in den generierten Typen.Der Standardwert ist true.
? ConfigFile: Zeichenfolge	Der Name der Konfigurationsdatei, die für Verbindungszeichenfolgen verwendet wird.Der Standardwert ist app.config oder web.config.
? DataDirectory: Zeichenfolge	Der Name des Datenverzeichnisses, verwendet, um zu ersetzen \|DataDirectory\| in den Verbindungszeichenfolgen.Der Standardwert ist das Projekt oder das Scripts-Verzeichnis.
? ResolutionFolder: Zeichenfolge	Ein, um relative Dateipfade zur Kompilierzeit aufzulösen Ordner verwendet werden.Der Standardwert ist der Ordner, der das Projekt oder das Skript enthält.
? StoredProcedures	Wenn true, Exposégespeicherte Prozeduren in den generierten Typen.Der Standardwert ist true.
? Timeout: int	Das Timeout, in Sekunden, damit SQLMetal.exe verwendet, wenn es mit der Datenbank herstellt.Der Standardwert ist null, der kein Timeout bedeutet.
? ContextTypeName: Zeichenfolge	Der Name des Containertyps, auf dem Sie verwenden, um alle generierten Typen zuzugreifen.
? Serialisierbar: bool	Wenn true, generierte Typen serialisierbar sind.Der Standardwert ist false.

Hinweise

Eine exemplarische Vorgehensweise, die zeigt, wie Sie diesen Typanbieter, finden Exemplarische Vorgehensweise: Zugreifen auf eine SQL-Datenbank mithilfe von Typanbietern (F#) verwendet.

Der SqlDataConnections-Typanbieter ist implizit verwendet werden, wenn Sie eine direkte Verbindung zu einer SQL-Datenbank und Typen generieren möchten verfügen, die die Daten in der Datenbank darstellen.Wenn Sie keine aktive Verbindung zu einer Datenbank während der Entwicklung verwenden möchten, können Sie DbmlFile-Typanbieter (F#) verwenden.

Der Typ der obersten Ebene, der durch einen einfachen Aufruf des Typanbieter generiert wird, enthält einen geschachtelten Typ, der ServiceTypes aufgerufen wird, unter denen die Typen, die vom Datenbankschema generiert werden, werden angezeigt.Der Typ der obersten Ebene selbst enthält zwei Überladungen der Methode GetDataContext, eine, die keine Parameter akzeptiert und eine, die eine Verbindungszeichenfolge als Parameter akzeptieren.Zwei Datenkontexte sind verfügbar, die Ansicht doppelklicken, die von SqlMetal.exe generiert und eine vereinfachte Ansicht, die Dienstprogrammmethoden jedoch Konserveneigenschaften für Datenfelder entfernt.Dieser GetDataContext der obersten Ebene ruft eine vereinfachte Ansicht der Typen ab.Die GetDataContext-Methode gibt einen Typ zurück, der von DataContext abgeleitet wird, und der Name des Typs wird entweder durch den Typs umgeht Parameter ContextTypeName zugewiesen oder von SQLMetal.exe bestimmt, wenn der statische Parameter nicht bereitgestellt wird.Zusätzlich zu den Basisklassenmethoden enthält der Datenkontexttyp die Tabellen in der Datenbank.

In der folgenden Tabelle sind die Typen, die vom Typanbieter für einen Ausdruck des Formulars bereitgestellt werden:

type MyDb = SqlDataConnection<connectionString>

In der folgenden Tabelle DataContextTypeName ist ein Platzhalter für den Namen des Datenkontexttyps für den Anbieter und * gibt alle Typen im - Namespace an.

Text [Type]	Description
MyDb	Der gesamte Containertyp. Enthält eine Methode GetDataContext, die eine vereinfachte Ansicht des Datenkontexts zurückgibt.Die Methode gibt eine neue Instanz von MyDB.ServiceTypes.SimpleDataContextTypes zurück.DataContextTypeName.Die Version mit dem connectionString Parameter verwendet werden, wenn die Verbindungszeichenfolge zur Laufzeit bestimmt wird.
MyDb.ServiceTypes	Enthält die eingebetteten vollständigen Typen und die vereinfachten Typen für die Datenbank.
MyDb.ServiceTypes.*	Die eingebetteten Typen von SqlMetal.exe generiert.
MyDb.ServiceTypes.DataContextTypeName	Der Datenkontexttyp, geerbt von DataContext.
MyDb.ServiceTypes.SimpleDataContextTypes.DataContextTypeName	Enthält eine Methode für jede Methode im vollständigen Kontexttyp, einschließlich gespeicherte Prozeduren und Funktionen, wenn die Optionen für diese ausgewählt wurden.Die Methoden geben ISingleResult<T> zurück. Enthält eine Eigenschaft für jede Eigenschaft des vollständigen Kontexttyps.Die Eigenschaften geben Table<TEntity> zurück. Die Eigenschaft Connection ruft die Datenbankverbindung als Instanz von DbConnection ab. Die Eigenschaft DataContext ruft den vollständigen Datenkontext, des Typs DataContext ab.Dies ist der Basistyp des DataContextTypeName-Typs, der vom Typanbieter generiert wird.

Vorsicht
Hinweis, um die Leistung von schreibgeschützten Operationen zu verbessern, dann die ObjectTrackingEnabled-Eigenschaft auf dem DataContext-Objekt auf false fest.