Provedor de tipo de SqlDataConnection (F#)

Artigo
02/25/2013

Fornece tipos para acessar um banco de dados SQL.

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

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

Parâmetros de tipo estáticos

Parâmetro de tipo	Descrição
O ConnectionString: cadeia de caracteres	a cadeia de conexão para a conexão de banco de dados.Se você estiver usando o Visual Studio, uma cadeia de conexão podem ser encontradas em propriedades de banco de dados na janela do server Explorer.
ConnectionStringName: cadeia de caracteres	O nome da cadeia de conexão para a conexão de banco de dados no arquivo de configuração.
? LocalSchemaFile: cadeia de caracteres	O caminho para um arquivo .dbml que contém o esquema.O valor padrão não há nenhum arquivo local de esquema.Essa opção é freqüentemente usada com ForceUpdate.
? ForceUpdate: bool	Requer que uma conexão direta para o banco de dados está disponível em tempo de design e força o esquema local do arquivo a ser atualizado.O valor padrão é válido.Quando ForceUpdate é falso, o provedor reage a alterações em LocalSchemaFile.
? Pluralize: bool	Se verdadeiro, formulários plurais usos para os nomes gerados do tipo.Os formulários plurais gerados são baseados em regras de idioma inglês.o valor padrão é falso.
? Modos de Exibição: bool	Se verdadeiro, exibições de banco de dados de expõe os tipos gerados.O valor padrão é válido.
? funções: bool	Se verdadeiro, funções de banco de dados de expõe os tipos gerados.O valor padrão é válido.
? ConfigFile: cadeia de caracteres	O nome do arquivo de configuração que é usado para cadeias de conexão.o valor padrão é app.config ou web.config.
? DataDirectory: cadeia de caracteres	O nome do diretório de dados, usado para substituir \|DataDirectory\| cadeias de conexão.O valor padrão é o projeto ou o diretório de script.
? ResolutionFolder: cadeia de caracteres	Uma pasta a ser usada para resolver em tempo de compilação caminhos de arquivos relacionados.O valor padrão é a pasta que contém o projeto ou o script.
? StoredProcedures	Se verdadeiro, procedimentos armazenados expõe os tipos gerados.O valor padrão é válido.
? tempo limite: int	O tempo limite, em segundos, para que SQLMetal.exe usar quando se conecta ao banco de dados.o valor padrão é zero, que não significa nenhum tempo limite.
? ContextTypeName: cadeia de caracteres	O nome do tipo recipiente que você usa para acessar todos os tipos gerados.
? Serializável: bool	Se sim, os tipos gerados são serializados.o valor padrão é falso.

Comentários

Para uma explicação passo a passo que mostra como usar esse provedor do tipo, considere passo a passo: Acessando um banco de dados SQL usando provedores de tipo () F#.

O provedor do tipo de SqlDataConnection está significado ser usado quando você tiver uma conexão direta a um banco de dados SQL e deseja gerar os tipos que representam os dados no banco de dados.Se você não desejar usar uma conexão ativa a um banco de dados durante o desenvolvimento, você pode usar Provedor de tipo de DbmlFile (F#).

O tipo de nível superior gerado por uma chamada simples para o provedor de tipo contém um tipo aninhado chamado ServiceTypes, em que os tipos gerados do esquema do banco de dados aparecem.O tipo de nível superior próprio contém duas sobrecargas do método GetDataContext, um que não leva nenhum parâmetro e um que usa uma cadeia de conexão como um parâmetro.Dois contextos de dados estiverem disponíveis, os gerados modo de exibição total por SqlMetal.exe e um modo de exibição simplificada que remove os métodos utilitário mas as propriedades de um preserva para campos de dados.Este GetDataContext de nível superior obtém uma versão simplificada de tipos.O método de GetDataContext retorna um tipo derivado de DataContext, e o nome de tipo é determinado pelo parâmetro de tipo estático ContextTypeName, ou determinado por SQLMetal.exe se o parâmetro estático não for fornecido.Além dos métodos da classe base, o tipo de contexto de dados contém as tabelas no banco de dados.

A tabela a seguir resume os tipos fornecidos pelo provedor de tipo para uma expressão do formulário:

type MyDb = SqlDataConnection<connectionString>

Em a tabela a seguir, DataContextTypeName é um espaço reservado para o nome do tipo de contexto de dados para o provedor, e * indica todos os tipos no namespace.

Tipo	Descrição
MyDb	Total do tipo recipiente. GetDataContext contém um método que retorna uma versão simplificada de contexto de dados.O método retorna uma nova instância de MyDB.ServiceTypes.SimpleDataContextTypes.DataContextTypeName.A versão com o parâmetro connectionString pode ser usada quando a cadeia de conexão é determinada em tempo de execução.
MyDb.ServiceTypes	Contém os tipos completos inseridos e tipos simplificados para o banco de dados.
MyDb.ServiceTypes.*	Os tipos inseridos gerados por SqlMetal.exe.
MyDb.ServiceTypes.DataContextTypeName	O tipo de contexto de dados herdado, de DataContext.
MyDb.ServiceTypes.SimpleDataContextTypes.DataContextTypeName	Contém um método para cada método no tipo completo de contexto, incluindo procedimentos armazenados e funções, se as opções para eles foram selecionadas.Os métodos ISingleResult<T>de retorno. Contém uma propriedade para cada propriedade do tipo completo de contexto.As propriedades Table<TEntity>de retorno. A propriedade obtém Connection a conexão de banco de dados como uma instância de DbConnection. A propriedade obtém o DataContext contexto completo de dados, do tipo DataContext.Este é o tipo base do tipo de DataContextTypeName gerado pelo provedor do tipo.

Cuidado
Observação Para melhorar o desempenho de operações somente leitura, defina a propriedade de ObjectTrackingEnabled no objeto de DataContext como false.