Provedor de tipo SqlDataConnection (F#)

Artigo
06/10/2015

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 Instruções passo a passo: acessando um banco de dados SQL por meio de provedores de tipos (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 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 ISingleResultde retorno. Contém uma propriedade para cada propriedade do tipo completo de contexto. As propriedades Tablede 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.

Aviso

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

Plataformas

Windows 8, Windows 7, Windows Server 2008 R2

Informações de Versão

Versões da biblioteca principal de F#

Suportado em: 4,0

Consulte também

Tarefas

Instruções passo a passo: acessando um banco de dados SQL por meio de provedores de tipos (F#)

Referência

Namespace Microsoft.FSharp.Data.TypeProviders (F#)

SqlMetal.exe (ferramenta de geração de código)

Partilhar via