SqlDataConnection, fournisseur de type (F#)

Article
06/10/2015

Fournit les types pour accéder à une base de données SQL.

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

Assembly: FSharp.Data.TypeProviders (dans 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>

Paramètres statiques

Paramètre de type	Description
ConnectionString : chaîne	La chaîne de connexion pour la connexion de base de données. Si vous utilisez Visual Studio, une chaîne de connexion peut être récupérée dans les propriétés de base de données dans la fenêtre explorateur de serveurs.
ConnectionStringName : chaîne	Le nom de la chaîne de connexion pour la connexion de base de données dans le fichier de configuration.
? LocalSchemaFile : chaîne	Le chemin d'accès à un fichier .dbml qui contient le schéma. La valeur par défaut n'a aucun fichier de schéma local. Cette option est fréquemment utilisée avec ForceUpdate.
? ForceUpdate : bool	Requiert qu'une connexion directe à la base de données soit disponible au moment de le design et force le le fichier de schéma local à actualiser. La valeur par défaut est true. Lorsque ForceUpdate a la valeur false, le fournisseur réagit aux modifications dans LocalSchemaFile.
? prenez le pluriel : bool	Si la valeur true, formulaires plurielles d'utilisation du type généré noms. Les formulaires plurielles générées sont basés sur des règles de langue anglaise. La valeur par défaut est false.
? vues : bool	Si la valeur true, vues de base de données d'expose des types générés. La valeur par défaut est true.
? fonctions : bool	Si la valeur true, fonctions de base de données d'expose des types générés. La valeur par défaut est true.
? ConfigFile : chaîne	Le nom du fichier de configuration utilisé pour les chaînes de connexion. La valeur par défaut est app.config ou web.config.
? DataDirectory : chaîne	Le nom du répertoire de données, utilisé pour remplacer \|DataDirectory\| dans les chaînes de connexion. La valeur par défaut est le projet ou le dossier scripts.
? ResolutionFolder : chaîne	Un dossier à utiliser pour résoudre les chemins d'accès relatifs au moment de la compilation. La valeur par défaut est le répertoire qui contient le projet ou le script.
? StoredProcedures	Si la valeur true, procédures stockées d'expose des types générés. La valeur par défaut est true.
? délai d'attente : int	Le délai d'attente, en secondes, pour que SQLMetal.exe utilise lorsqu'il se connecte à la base de données. La valeur par défaut est zéro, ce qui signifie qu'aucun délai d'attente.
? ContextTypeName : chaîne	Le nom du type de conteneur que vous utilisez pour accéder à tous les types générés.
? sérialisable : bool	Si la valeur true, les types générés sont sérialisables. La valeur par défaut est false.

Notes

Pour une procédure pas - à - pas qui montre comment utiliser ce type de fournisseur, consultez Procédure pas à pas : accès à une base de données SQL à l'aide des fournisseurs de type (F#).

Le type de fournisseur SqlDataConnection est destiné à être utilisé lorsque vous avez une connexion directe à une base de données SQL et générer les types qui représentent les données dans la base de données. Si vous ne souhaitez pas utiliser une connexion active à une base de données pendant le développement, vous pouvez utiliser DbmlFile, fournisseur de type (F#).

Le type de niveau supérieur généré par un appel simple au type de fournisseur contient un type imbriqué appelé ServiceTypes, sous lequel les types générés de schémas de bases de données apparaissent. Le type de niveau supérieur lui-même contient deux surcharges de la méthode GetDataContext, une qui n'accepte aucun paramètre et une acceptant une chaîne de connexion comme paramètre. Deux contextes de données sont disponibles, les à pleine vue générés par SqlMetal.exe et une vue simplifiée qui supprime les méthodes utilitaires mais des propriétés de conserve des champs de données. Ce GetDataContext de niveau supérieur obtient une vue simplifiée des types. La méthode d' GetDataContext retourne un type dérivé d' DataContext, et le nom du type est fourni par le paramètre statique ContextTypeName, ou est déterminé par SQLMetal.exe si le paramètre statique n'est pas fourni. En plus de les méthodes de classe de base, le type de contexte de données contient des tables dans la base de données.

Le tableau suivant résume les types fournis par le type de fournisseur pour une expression de formulaire :

type MyDb = SqlDataConnection<connectionString>

Dans le tableau suivant, DataContextTypeName est un espace réservé pour le nom du type de contexte de données du fournisseur, et * indique tous les types dans l'espace de noms.

Type	Description
MyDb	Le type d'agrégat de conteneur. Contient une méthode GetDataContext qui retourne une vue simplifiée du contexte de données. La méthode retourne une nouvelle instance de MyDB.ServiceTypes.SimpleDataContextTypes.DataContextTypeName. La version avec le paramètre connectionString peut être utilisée lorsque la chaîne de connexion est déterminée au moment de l'exécution.
MyDb.ServiceTypes	Contient les types complets inline et les types simplifiés pour la base de données.
MyDb.ServiceTypes.*	Les types incorporés générés par SqlMetal.exe.
MyDb.ServiceTypes.DataContextTypeName	Le type de contexte de données hérité, d' DataContext.
MyDb.ServiceTypes.SimpleDataContextTypes. DataContextTypeName	Contient une méthode pour chaque méthode sur le type complet de contexte, y compris les procédures stockées et les fonctions, si les options de ces derniers ont été sélectionnées. Les méthodes ISingleResultde retour. Contient une propriété pour chaque propriété du type complet de contexte. Les propriétés Tablede retour. La propriété Connection obtient la connexion de base de données comme instance d' DbConnection. La propriété DataContext obtient le contexte complet de données, du type DataContext. Il s'agit du type de base du type de DataContextTypeName généré par le type de fournisseur.

Avertissement

Notez pour améliorer les performances des opérations en lecture seule, définissez la propriété d' ObjectTrackingEnabled sur l'objet d' DataContext false.

Plateformes

Windows 8, Windows 7, Windows Server 2008 R2

Informations de version

Versions de bibliothèque principale F#

Prise en charge dans : 4.0

Voir aussi

Tâches

Procédure pas à pas : accès à une base de données SQL à l'aide des fournisseurs de type (F#)

Référence

Microsoft.FSharp.Data.TypeProviders, espace de noms (F#)

SqlMetal.exe (outil de génération de code)

Partager via