Acesso local e remoto dados em aplicativos ClickOnce

A maioria dos aplicativos consomem ou produzir dados.ClickOnce oferece uma variedade de opções para leitura e gravação de dados, tanto local quanto remotamente.

Dados Locais

Com ClickOnce, você pode carregar e armazenar dados localmente usando qualquer um dos seguintes métodos:

• ClickOnce Diretório de dados

• armazenamentos isolados

• Outros arquivos locais

Diretório de dados do ClickOnce

Cada ClickOnce aplicativo instalado em um computador local possui um diretório de dados armazenado na pasta de documentos e configurações do usuário. Qualquer arquivo incluído um ClickOnceaplicativos e marcado sistema autônomo um arquivo de "dados" é copiado para este diretório quando um aplicativo está instalado. Arquivos de dados podem ser qualquer tipo de arquivo usado com mais freqüência sendo texto, XML e arquivos de banco de dados, sistema autônomo arquivos .mdb do Microsoft acesso.

O diretório de dados é destinado aplicativo-dados gerenciados, dados que o aplicativo armazena e mantém explicitamente.Todo estático, nondependency arquivos não marcados sistema autônomo "dados" no manifesto do aplicativo em vez disso residirá no diretório de aplicativo.Este diretório é onde residem os arquivos executável (.exe) e assemblies do aplicativo.

Observação:
Quando um ClickOnce aplicativo é desinstalado, seu diretório de dados também será removido. Nunca use o diretório de dados para armazenar dados usuário–gerenciado participante, sistema autônomo documentos.

Marcando arquivos de dados em uma distribuição do ClickOnce

Para colocar um arquivo existente dentro do diretório de dados, você deve marcar o arquivo existente sistema autônomo um arquivo de dados no seu ClickOnce arquivo de manifesto do aplicativo do aplicativo. Para obter mais informações, consulte Como: Incluir um arquivo de dados em um aplicativo ClickOnce.

Leitura e gravação ao diretório de dados

A leitura do diretório de dados requer que seu ClickOnce a solicitação do aplicativo a permissão de leitura; da mesma forma, para o diretório de gravar requer permissão de gravar. O aplicativo automaticamente terá essa permissão se ele estiver configurado para ser executado com confiança total.Para obter mais informações sobre s permissão elevador para seu aplicativo usando permissão elevação ou implantação de aplicativos confiáveis, consulte Implantação ClickOnce e segurança.

Observação:
Se sua organização não usa confiáveis aplicativo implantação e tenha desativado a elevação de permissões, declarar permissões falhará.

Depois de seu aplicativo tiver essas permissões, ele pode acesso chama o diretório de dados usando método em classes dentro de System.IO. Você pode obter o caminho do diretório de dados dentro de um Windows Forms ClickOnce aplicativos usando o DataDirectory definido na propriedade de CurrentDeployment propriedade de ApplicationDeployment. Essa é a maneira mais conveniente e recomendada para acessar seus dados.O exemplo de código a seguir demonstra sistema autônomo fazer isso para um arquivo de texto chamado CSV.txt inclusas na sua implantação sistema autônomo um arquivo de dados.

If (ApplicationDeployment.IsNetworkDeployed) Then
    Dim SR As StreamReader = Nothing

    Try
        SR = New StreamReader(ApplicationDeployment.CurrentDeployment.DataDirectory & "\CSV.txt")
        MessageBox.Show(SR.ReadToEnd())
    Catch Ex As Exception
        MessageBox.Show("Could not read file.")
    Finally
        SR.Close()
    End Try
End If

Para obter mais informações marcação de arquivos em sua implantação sistema autônomo arquivos de dados, consulte Como: Incluir um arquivo de dados em um aplicativo ClickOnce.

Você também pode obter o caminho do diretório de dados usando sistema autônomo variáveis relevantes sobre o Application classe, sistema autônomo LocalUserAppDataPath.

Manipulação de outros tipos de arquivos pode exigir permissões adicionais.Por exemplo, se você quiser usar um arquivo de banco de dados do acesso (.mdb), seu aplicativo deve declarar confiança total para usar o relevantes System.Data classes.

Dados diretório e versões de aplicativo

Cada versão de um aplicativo tem seu próprio diretório de dados, que é isolado de outras versões.ClickOnce cria este diretório independentemente de se quaisquer arquivos de dados são incluídos na implantação para que o aplicativo tem um local para criar novos arquivos de dados em time de execução. Quando uma nova versão de um aplicativo estiver instalada, ClickOnce irá copiar todos os arquivos dados existentes do diretório de dados da versão anterior para diretório a nova versão de dados — que foram incluídos na implantação original ou criadas pelo aplicativo.

ClickOnce substituirá a versão mais antiga do arquivo com a versão mais recente do servidor se um arquivo de dados tem um valor de hash diferente na versão antiga do aplicativo sistema autônomo na nova versão. Além disso, se a versão anterior do aplicativo criado um novo arquivo que tem o mesmo nome sistema autônomo um arquivo incluído na implantação da nova versão, ClickOnce o <a0></a0> substituirá arquivo a versão antiga com o novo arquivo. Em ambos os casos, os arquivos antigos serão incluídos em um subdiretório no diretório de dados chamado .Pre, para que o aplicativo ainda pode acesso os dados antigos para fins de migração.

Se você precisar de mais refinados de migração de dados, você pode usar o ClickOnce Implantação de API para realizar migração personalizada do diretório de dados antigo para o novo diretório de dados. Você precisará testar para um baixar disponível por meio de IsFirstRun, baixe a atualização usando Update ou UpdateAsync, e siga qualquer personalizado migração de dados funcionam em seu próprio após a atualização for concluída.

armazenamentos isolados

Armazenamento isolado fornece uma API para criar e acessar arquivos usando uma API simples.Localização real dos arquivos armazenados é oculta do desenvolvedor e o usuário.

Armazenamento isolado funciona em todas as versões do .NET Framework. Armazenamento isolado também funciona em aplicativos parcialmente confiável sem a necessidade de concessões de permissão adicional.Você deve usar armazenamento isolado se seu aplicativo deve ser executado em confiança parcial, mas deve manter dados específicos do aplicativo.

Para obter mais informações, consulte Introdução ao armazenamento isolado.

Outros arquivos locais

Se seu aplicativo deve funcionar com ou salvar dados de usuário participante sistema autônomo relatórios, imagens, música e assim por diante, o aplicativo exigirá FileIOPermission para ler e gravar dados no sistema de arquivos local.

Dados remoto

Em algum momento, seu aplicativo provavelmente terá que recuperar sistema autônomo informações de um site remoto, sistema autônomo informações de dados ou de entrada no mercado de cliente.Esta seção discute as técnicas mais comuns para a recuperação de dados remoto.

Acessando arquivos por meio de HTTP

Você pode acessar dados de um servidor Web usando qualquer um do WebClient ou o HttpWebRequest classe na System.Net namespace. Os dados podem ser arquivos estático ou ASP.NET aplicativos que retornam dados XML ou de texto bruto. Se sistema autônomo dados estiverem no formato XML, a maneira mais rápida de recuperar sistema autônomo dados é usando o XmlDocument classe cuja Load método usa uma URL sistema autônomo um argumento. Para um exemplo, consulte Reading an Documento XML em the DOM.

Você precisa considerar a segurança quando o aplicativo acessa dados remoto por HTTP.Por padrão, o seu ClickOnce o acesso do aplicativo aos recursos da rede pode ser restrito, dependendo de como seu aplicativo foi implantado. Essas restrições são aplicadas para impedir que programas mal-intencionados obtenham acesso a dados remoto privilegiados ou usando um computador do usuário para atacar outros computadores na rede.

A tabela a seguir lista as estratégias de implantação, que você pode usar e suas permissões de Web padrão.

Se seu ClickOnce o aplicativo não pode acessar um servidor Web devido a restrições de segurança, o aplicativo deve declarar WebPermission para esse site. Para obter mais informações sobre como aumentar as permissões de segurança para um ClickOnce aplicativo, consulte Implantação ClickOnce e segurança.

Acessando dados através de um serviço Web XML

Se expor seus dados sistema autônomo um serviço XML da Web, você poderá acesso sistema autônomo dados usando um serviço Web XML proxy.O proxy é um .NET Framework classe que criar usando um Visual Studio ou o Tool WSDL (Web Serviços Description Idioma) (WSDL.exe). sistema autônomo operações do serviço Web XML — sistema autônomo recuperar sistema autônomo clientes, ordens de inserção e assim por diante — são expostos sistema autônomo métodos no proxy.Isso torna muito mais fácil de usar do que o texto bruto ou arquivos XML Web services.

Se o seu serviço Web XML opera sobre HTTP, o serviço será limite, sistema autônomo mesmas restrições de segurança sistema autônomo a WebClient e HttpWebRequest classes.

Para obter exemplos de como criar serviço Web XML proxies, consulte Criando clientes XML Web Services. Você também pode executar essa tarefa usando Visual Studio.  

Acessando um banco de dados diretamente

Você pode usar sistema autônomo classes dentro de System.Data espaço para nome para estabelecer conexões diretas com um servidor de banco de dados, sistema autônomo o SQL Server em sua rede, mas você deve considerar sistema autônomo questões de segurança. Ao contrário das solicitações de HTTP, solicitações de conexão de banco de dados sempre são proibidas por padrão, com confiança parcial; você só terá essa permissão por padrão se você instalar o ClickOnce aplicativo de um CD-ROM. Isso permite que sua confiança total do aplicativo.Para permitir o acesso a um banco de dados do SQL servidor específico, seu aplicativo deve solicitar SqlClientPermission a ele; para permitir o acesso a um banco de dados diferente do SQL servidor, ele deve solicitar OleDbPermission.

Na maioria das vezes, você não precisará acesso o banco de dados diretamente, mas irá acesso-lo em vez disso, por meio de um aplicativo de servidor da Web escritas em ASP.NET ou um XML Web Services. Acessar o banco de dados dessa maneira com freqüência é o melhor método se o ClickOnce aplicativo será implantado em um servidor Web. Você pode acessar o servidor em confiança parcial sem elevar permissões do seu aplicativo.

Consulte também

Tarefas

Como: Incluir um arquivo de dados em um aplicativo ClickOnce

Outros recursos

Implantação de ClickOnce para aplicativos de formulários do Windows