Compartilhar via

Compilando e executando exemplos de código

  • Artigo

[Este tópico é uma documentação de pré-lançamento e está sujeito a alterações em versões futuras. Os tópicos em branco são incluídos como espaços reservados. OBSERVAÇÃO: A fim de fornecer uma documentação mais extensa em diferentes idiomas, a Microsoft está disponibilizando documentos traduzidos através de métodos de tradução alternativos. Para esta versão de pré-lançamento, parte do conteúdo desta documentação foi traduzida utilizando um desses métodos. Sabemos que documentos traduzidos dessa forma não são perfeitos e podem conter erros de terminologia, sintaxe e gramática. A versão final deste material será traduzida através dos métodos tradicionais e a qualidade será equivalente àquela das versões anteriores.]

Os exemplos de código na documentação da biblioteca do serviço Web Servidor de Relatórios são simples aplicativos que executam operações do serviço Web Servidor de Relatórios usando muitos dos métodos de serviço Web disponíveis. Esses aplicativos gravam a saída no console ou no prompt de comando.

Importante

O Os exemplos são fornecidos somente para fins educativos. Eles não se destinam ao uso em um ambiente de produção e nem foram testados nesse tipo de ambiente. AMicrosoft não fornece suporte técnico para esses exemplos. Os aplicativos de exemplo e assemblies não devem ser conectados nem utilizados com o banco de dados de produção doSQL Server nem com o servidor de relatório sem a permissão do administrador de sistema. Microsoft não dá suporte técnico a esses exemplos.

Os exemplos do SQL Server não são instalados automaticamente durante a instalação. Para obter instruções sobre como instalar os exemplos, consulte Considerações para instalar exemplos e bancos de dados de exemplo do SQL Server.

Usando o Microsoft .NET Framework SDK

Você pode usar várias ferramentas no .NET Framework SDK para compilar e executar exemplos de código do Reporting Services. Você pode obter o .NET Framework SDK gratuitamente. Para obter mais informações, consulte Instalando a documentação do .NET Framework.

Para compilar e executar um exemplo de código

  1. Crie uma classe proxy Reporting Services no Microsoft Visual Basic ou Microsoft Visual C++ usando a ferramenta WSDL. Para obter mais informações sobre como usar essa ferramenta, consulte Criando o proxy de serviço Web.

  2. Compile o arquivo do código-fonte da classe proxy em um assembly .NET Framework usando os seguintes comandos:

    • No Visual Basic, use Vbc.exe para compilar a classe proxy e produzir um DLL. Por exemplo:

      vbc /target:library ReportingService2005.vb /r:System.dll /r:System.Xml.dll /r:System.Web.Services.dll

    • No C#, use Csc.exe para compilar a classe proxy e produzir um DLL. Por exemplo:

      csc /target:library ReportingService2005.cs /r:System.dll /r:System.Xml.dll /r:System.Web.Services.dll

  3. Usando um editor de texto, crie um exemplo nomeado de arquivo de texto em branco com uma extensão .vb (para código de exemplo Visual Basic) ou uma extensão .cs (para código de exemplo C#).

  4. Copie e cole o exemplo de código a ser executado no arquivo em branco. Salve o arquivo.

  5. Abra um prompt de comando: No menu Iniciar, clique em Executar, digite cmd na caixa de texto ** e clique em OK.

  6. No prompt de comando, digite um dos comandos a seguir para compilar o exemplo. Os caminhos para seu arquivo de exemplo e para o RSWebService.dll podem diferir dos caminhos fornecidos nos exemplos a seguir.

    • Para Visual Basic, use Vbc.exe e o seguinte comando para referenciar a classe proxy e as bibliotecas do sistema necessárias na execução do aplicativo:

      vbc sample.vb /r:ReportingService2005.dll /r:System.dll /r:System.Web.Services.dll /r:System.Xml.dll

    • Para C#, use Csc.exe e o seguinte comando para referenciar a classe proxy e as bibliotecas do sistema necessárias na execução do aplicativo:

      csc sample.cs /r:ReportingService2005.dll /r:System.dll /r:System.Web.Services.dll /r:System.Xml.dll

  7. O compilador cria um executável chamado Sample.exe. Para executar o exemplo compilado, digite sample.exe no prompt de comando.

Usando o Visual Studio

Você pode usar o ambiente de desenvolvimento Visual Studio para criar e executar exemplos de código do Reporting Services.

Para compilar e executar um exemplo de código

  1. No menu Arquivo, clique em Novo Projeto.

  2. Na caixa de diálogo Novo Projeto, em Tipos de Projeto, clique em Projetos do Visual Basic ou Projetos do Visual C#.

  3. No painel direito, clique em Aplicativo do Console.

  4. Na caixa Nome digite um nome para o novo projeto.

  5. Na caixa Local, selecione o local onde você deseja salvar o arquivo.

  6. Adicione uma referência da Web ao aplicativo. Para obter mais informações sobre como adicionar a referência da Web ao serviço Web Servidor de Relatórios no Visual Studio .NET, consulte Criando o proxy de serviço Web.

  7. Renomeie o arquivo de projeto Class1.cs como Sample.cs. Para Visual Basic, renomeie Module1.vb como Sample.vb.

  8. Copie e cole o exemplo de código que você quer usar no espaço fornecido no arquivo de código de exemplo. Salve o arquivo.

  9. Inicie o aplicativo: Pressione F5 ou clique em Iniciar no menu Depurar.

Usando o utilitário rs

O Reporting Services fornece um utilitário de script, o utilitário rs, que é enviado como um arquivo denominado rs.exe. Você pode executar qualquer exemplo de código Visual Basic, fornecido na documentação da biblioteca do serviço Web Servidor de Relatórios, usando o utilitário rs incluído no Reporting Services.

Para executar um exemplo de código

  1. Usando um editor de textos, crie um exemplo nomeado de arquivo de texto em branco com uma extensão .rss.

  2. Copie e cole o seguinte código no arquivo em branco:

    Public Sub Main()
    ' Your code goes here.
End Sub

  3. Copie e cole o exemplo de código que você quer usar no espaço fornecido no exemplo de código anterior. Salve o arquivo. Se você estiver copiando diretamente de um exemplo de código fornecido em um tópico de referência, remova qualquer instrução importante, declarações de módulo e a seguinte linha de código:

    Dim rs As New ReportingService2005()

    O objeto ReportingService2005 já está declarado e instanciado no ambiente de script. Se você declarar novamente o objeto em seu código, o script irá falhar. Para obter mais informações sobre scripts corretamente formados, consulte Formatando o arquivo de script do Reporting Services.

  4. Abra um prompt de comando: No menu Iniciar, clique em Executar, digite cmd na caixa de texto e clique em OK.

  5. Navegue até o diretório que contém seu arquivo Sample.rss. No prompt de comando, digite o comando a seguir para executar o arquivo de script de exemplo. Substitua a URL do servidor determinada pela URL do servidor de relatório e ponto de extremidade que você está acessando. Por exemplo:

    rs –i sample.rss –s http://myserver/reportserver

    Dica

    Se você receber uma mensagem dizendo que rs não é reconhecido será necessário adicionar o local do rs.exe à variável PATH de ambiente do Windows.

Consulte também

Tarefas

Exemplos do Reporting Services

Outros recursos

Criando o proxy de serviço Web
Autenticação de serviço Web

Ajuda e informações

Obtendo assistência do SQL Server 2008 R2