Provider di tipo SqlDataConnection (F#)

Articolo
02/18/2013

Fornisce tipi per accedere a un database SQL.

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>

Parametri statici

Parametro di tipo	Descrizione
ConnectionString: stringa	Stringa di connessione per la connessione al database.Se si utilizza Visual Studio, una stringa di connessione può essere individuato nelle proprietà del database nella finestra di Esplora server.
ConnectionStringName: stringa	Il nome della stringa di connessione per la connessione di database nel file di configurazione.
? LocalSchemaFile: stringa	Il percorso di un file .dbml contenente lo schema.Il valore predefinito non viene file di schema locale.Questa opzione viene spesso utilizzato con ForceUpdate.
? ForceUpdate: bool	Richiede che un collegamento diretto al database disponibili in fase di progettazione e forza il file di schema locale da aggiornare.Il valore predefinito è true.Quando ForceUpdate è false, il provider risponde alle modifiche in LocalSchemaFile.
? pluralizzi: bool	Se true, forme plurali per i nomi dei tipi generati.Le forme plurali generate sono basate sulle regole di lingua inglese.Il valore predefinito è false.
? visualizzazioni: bool	Se true, visualizzazioni del database di esposti nei tipi generati.Il valore predefinito è true.
? funzioni: bool	Se true, funzioni di database esposti nei tipi generati.Il valore predefinito è true.
? ConfigFile: stringa	Il nome del file di configurazione utilizzato per le stringhe di connessione.Il valore predefinito è app.config o web.config.
? DataDirectory: stringa	Il nome della directory dati, utilizzato per sostituire \|DataDirectory\| nelle stringhe di connessione.Il valore predefinito è il progetto o la directory di script.
? ResolutionFolder: stringa	Una cartella da utilizzare per risolvere percorsi di file relativi in fase di compilazione.Il valore predefinito è la cartella contenente il progetto o lo script.
? StoredProcedures	Se true, stored procedure di esposti nei tipi generati.Il valore predefinito è true.
? intervallo: int	L'intervallo, in secondi, per SQLMetal.exe utilizzare per la connessione al database.Il valore predefinito è zero, non significa intervallo.
? ContextTypeName: stringa	Il nome del tipo contenitore utilizzato per accedere a tutti i tipi generati.
? serializzabile: bool	Se true, i tipi generati sono serializzabili.Il valore predefinito è false.

Note

Per una procedura dettagliata che illustra come utilizzare il provider del tipo, vedere Procedura dettagliata: accesso a un database SQL tramite provider di tipi (F#).

Il provider del tipo di SqlDataConnection deve essere utilizzato quando è presente un collegamento diretto a un database SQL e si desidera generare i tipi che rappresentano i dati nel database.Se non si desidera utilizzare una connessione attiva a un database durante lo sviluppo, è possibile utilizzare Provider di tipo DbmlFile (F#).

Il tipo di primo livello generato da una chiamata semplice al provider del tipo contiene un tipo annidato definito ServiceTypes, in cui i tipi generati dallo schema del database vengono visualizzati.Il tipo di primo livello contiene due overload del metodo GetDataContext, uno che non accetta parametri e uno che prende una stringa di connessione come parametro.Due contesti dati disponibili, gli all'intera visualizzazione generati da SqlMetal.exe e una visualizzazione semplificata che rimuove i metodi di utilità ma le proprietà di mantenere per i campi dati.Questo GetDataContext di primo livello ottiene una visualizzazione semplificata dei tipi.Il metodo GetDataContext restituisce un tipo derivato da DataContexte il nome del tipo è specificato dal parametro statico ContextTypeName, o è determinato da SQLMetal.exe se il parametro statico non viene fornito.Oltre ai metodi della classe base, il tipo di contesto dati contiene le tabelle del database.

Nella tabella seguente sono riepilogati i tipi forniti dal provider del tipo per un'espressione nel formato:

type MyDb = SqlDataConnection<connectionString>

Nella tabella seguente, DataContextTypeName è un segnaposto per il nome del tipo di contesto dati per il provider e * indica tutti i tipi nello spazio dei nomi.

Type	Descrizione
MyDb	Il tipo world del contenitore. Contiene un metodo GetDataContext che restituisce una visualizzazione semplificata del contesto dati.Il metodo restituisce una nuova istanza di MyDB.ServiceTypes.SimpleDataContextTypes.DataContextTypeName.La versione con il parametro connectionString può essere utilizzata quando la stringa di connessione viene determinata in fase di esecuzione.
MyDb.ServiceTypes	Contiene i tipi completi incorporati e i tipi semplificati per il database.
MyDb.ServiceTypes.*	i tipi incorporati generati da SqlMetal.exe.
MyDb.ServiceTypes.DataContextTypeName	Il tipo di contesto dati, ereditato da DataContext.
MyDb.ServiceTypes.SimpleDataContextTypes.DataContextTypeName	Contiene un metodo per ogni metodo nel tipo completo di contesto, incluse le stored procedure e funzioni, se le opzioni per questi sono state selezionate.I metodi ISingleResult<T>restituita. Contiene una proprietà per ogni proprietà di tipo completo di contesto.Le proprietà Table<TEntity>restituita. La proprietà Connection ottiene la connessione di database come istanza DbConnection. La proprietà DataContext ottiene il contesto dati completo, di tipo DataContext.Questo tipo di base del tipo di DataContextTypeName generato dal provider del tipo.