Compartilhar via


Como: Conversão objetos retornados por aplicativos do Office

Quando você Gravar código gerenciado, por padrão você deve especificar tipo de objeto.Entretanto, vários métodos e propriedades nos assemblies de interoperabilidade primárias do Microsoft Office retornam tipo Object, pois eles têm a capacidade de retornar vários tipos diferentes.Quando o objeto é retornado, você deve explicitamente converter (no Visual Basic) ou converter (em C#) do objeto para o tipo correto.Converter ou converter o objeto permite que o IntelliSense para o objeto no Editor de códigos.

Para obter informações sobre a conversão no Visual Basic, consulte Conversões explícita e implícita  e CType Function.Para obter informações sobre a conversão em C#, consulte Operador () (Referência C#).

O procedimento a seguir é um exemplo de converter um objeto retornado por um aplicativo do Microsoft Office a um tipo específico para uso em código gerenciado.Este exemplo usa uma personalização de nível de documento para o Microsoft Office Excel.

Para converter um objeto para um tipo específico

  1. Adicionar um Controlarar NamedRange para a célula A1.

    Dim NamedRange1 As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A1"), "NamedRange1")
    
    Microsoft.Office.Tools.Excel.NamedRange NamedRange1 = 
        this.Controls.AddNamedRange(this.Range["A1", missing], "NamedRange1");
    
  2. O objeto retornado da propriedade ColumnWidth do intervalo nomeado para uma Double de conversão e Atribuir-lo para uma variável.

    Embora o valor subjacente da propriedade ColumnWidth seja um valor decimal, a propriedade retorna o valor como um tipo de Object.Você deve converter o Object para um Double para trabalhar com o valor decimal diretamente.

    Dim width As Double = CType(NamedRange1.ColumnWidth, Double)
    
    double width = (double)NamedRange1.ColumnWidth;
    
  3. Exibir a largura da coluna do Controlarar NamedRange em uma caixa de diálogo.

    MessageBox.Show("Column width: " & width.ToString())
    
    MessageBox.Show("Column width: " + width.ToString());
    

Consulte também

Conceitos

Escrevendo código in Office Solutions

Gerenciado código e Programação do Office com o Visual Studio

Noções básicas sobre parâmetros opcionais in Office Solutions

Outros recursos

Controles em documentos do Office

Exemplos de desenvolvimento do Office e Walkthroughs