Microsoft.Web.Management.DatabaseManager Namespace

O namespace Microsoft.Web.Management.DatabaseManager contém classes que um desenvolvedor pode usar para criar um provedor para gerenciar um banco de dados usando o Gerenciador do IIS. Os administradores podem usar esse provedor e a interface do Gerenciador do IIS para gerenciar remotamente um banco de dados pela Internet.

As classes no namespace Microsoft.Web.Management.DatabaseManager contêm uma série de objetos de nível superior que permitem aos desenvolvedores criar provedores que permitem tarefas de administração de banco de dados remoto usando o Gerenciador do IIS. Os diferentes objetos lógicos representam os vários objetos de banco de dados, incluindo tabelas, exibições, procedimentos armazenados, colunas, chaves e índices. Você pode usar a API para obter e trabalhar com esses objetos para executar ações como criar, excluir ou modificar tabelas, exibições, procedimentos armazenados, colunas, chaves e índices.

Notas para implementadores

Depois de criar um provedor de banco de dados, você deve registrá-lo no Cache de Assembly Global para seu servidor e registrá-lo em seu arquivo de Administration.config antes que o Gerenciador do IIS reconheça o provedor. O exemplo XML a seguir ilustra um registro do provedor de banco de dados de um arquivo Administration.config.

<system.webServer>
   <management>
      <dbManager>
         <DBProviders>
            <provider
                  name="SQL Server 2005/2008"
                  providerName="System.Data.SqlClient"
                  type="Microsoft.Web.Management.DatabaseManager.SqlDatabase.SqlDatabaseProvider, Microsoft.Web.Management.DatabaseManager.SqlDatabase, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" >
               <databaseBackup
                  backupEnabled="true"
                  restoreEnabled="true"
                  backupPath="C:\backups" />
            </provider>
         </DBProviders>
      </dbManager>
      </management>
</system.webServer>

Há três atributos que seu provedor de banco de dados deve especificar no <elemento> do provedor antes que o gerenciador de banco de dados reconheça seu provedor de banco de dados e exiba bancos de dados no Gerenciador do IIS. Esses atributos são listados na tabela a seguir:

Parâmetro	Descrição
nome	(Obrigatório) Uma cadeia de caracteres que contém o nome amigável do seu provedor.
nomeDoProvedor	(Obrigatório) Uma cadeia de caracteres que contém o nome do provedor .NET para seu banco de dados específico. Por exemplo, você pode especificar System.Data.SqlClient para Microsoft SQL Server ou System.Data.OleDb para um banco de dados OLEDB.
tipo	(Obrigatório) O tipo gerenciado para seu provedor de banco de dados.

Dependendo da implementação, há três atributos adicionais que o provedor de banco de dados pode especificar no elemento <databaseBackup> antes que o gerenciador de banco de dados exiba as opções de backup e restauração no Gerenciador do IIS. Esses atributos são listados na tabela a seguir:

Parâmetro	Descrição
backupPath	(Opcional) Uma cadeia de caracteres que contém o caminho em que o gerenciador de banco de dados armazenará arquivos de backup de banco de dados.
backupEnabled	(Opcional) true se o provedor der suporte ao backup de bancos de dados; caso contrário, false.
restoreEnabled	(Opcional) true se o provedor der suporte à restauração de bancos de dados; caso contrário, false.

O atributo backupPath pode conter variáveis que o Gerenciador do IIS expandirá para seus respectivos equivalentes de cadeia de caracteres. Esses nomes de variáveis diferenciam maiúsculas de minúsculas e suas descrições estão listadas na tabela a seguir:

Nomes de variáveis	Descrição
{userName}	O nome da conta do usuário atual.
{userDomain}	O nome do domínio em que o nome da conta do usuário atual está localizado.
{site}	O nome do site atual.
{appPath}	O nome do aplicativo atual.

Essas variáveis são úteis em um ambiente em que vários servidores estão armazenando backups em um repositório comum, como um local de rede. Por exemplo, você pode usar um caminho como \\server\share\{site}, para que vários servidores possam compartilhar o mesmo local de armazenamento, enquanto estiverem separados em pastas exclusivas por seus respectivos nomes de site.

Aulas

Tipo de classe	Classe	Descrição
	Coluna	Representa uma coluna dentro de um banco de dados.
	ColumnDataInfo	Representa as informações sobre os dados em uma coluna dentro do banco de dados que está sendo gerenciado.
	ConnectionArgument	Especifica um argumento de conexão para uma conexão de banco de dados.
	DatabaseInfo	Representa a classe que contém informações específicas do banco de dados para um provedor.
	DatabaseProvider	Representa a classe base que precisa ser implementada para gerenciar um banco de dados.
	DependenciesMissingException
	ForeignKey	Representa uma chave estrangeira em um banco de dados.
	ForeignKeyColumn	Representa uma coluna de chave estrangeira em um banco de dados.
	Index	Representa um índice dentro de um banco de dados.
	IndexColumn	Representa uma coluna de índice em um banco de dados.
	Consulta	Representa uma consulta de banco de dados.
	QueryColumnMetadata	Representa os metadados de uma coluna em um resultado de consulta.
	queryResult	Representa um resultado de consulta que foi retornado de uma consulta de banco de dados.
	StoredProcedure	Representa um procedimento armazenado em um banco de dados.
	StoredProcedureParameter	Representa um parâmetro para um procedimento armazenado em um banco de dados.
	Tabela	Representa uma tabela em um banco de dados.
	TableInfo	Representa as informações de uma tabela em um banco de dados.
	TypeInfo	Representa informações de tipo de dados em um banco de dados.
	Exibir	Representa uma exibição em um banco de dados.

Interfaces

Tipo de Interface	Interface	Descrição
interface pública	IDbBackupManager	Representa uma interface do gerenciador de backup de banco de dados.
interface pública	IDbCustomBackupRestoreManager	Representa uma interface personalizada do gerenciador de backup e restauração de banco de dados.
interface pública	IDbRestoreManager	Representa uma interface do gerenciador de restauração de banco de dados.
interface pública	IDbStoredProcedureManager	Representa uma interface do gerenciador de procedimentos armazenados para um provedor de banco de dados.
interface pública	IDbTableDataManager	Representa uma interface do gerenciador de dados de tabela em um provedor de banco de dados.
interface pública	IDbTableManager	Representa uma interface do gerenciador de tabelas para o provedor de banco de dados.
interface pública	IDbViewManager	Representa uma interface do gerenciador de exibição em um provedor de banco de dados.

Enumerações

Tipo de enumeração	Enumeração	Descrição
	ColumnChanges	Define os valores das alterações de coluna pendentes.
	ForeignKeyChanges	Especifica as alterações para chaves estrangeiras em um banco de dados.
	IndexChanges	Especifica os tipos de alterações de índice para um banco de dados.
	IndexType	Especifica os tipos de índice para bancos de dados.