Propriedade WorksheetBase.Columns

Artigo
05/21/2013

Obtém um objeto de Range que representa uma ou mais colunas na planilha.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (em Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Sintaxe

'Declaração
Public ReadOnly Property Columns As Range

public Range Columns { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
Um objeto de Range que representa uma ou mais colunas na planilha.

Comentários

Quando usado sem parâmetros, essa propriedade retorna um objeto de Range que contém todas as colunas da planilha.

Esta propriedade pode ser usada com os seguintes parâmetros opcionais para obter colunas específicas na planilha.Se você usa essa propriedade com parâmetros, o valor de retorno é um objeto que deve ser convertido em Range.

Parâmetro	Descrição
RowIndex	O índice de uma ou mais colunas para obter. Para obter uma única coluna, passe um dos seguintes objetos para esse parâmetro: Um número inteiro que especifica o índice da coluna que você deseja obter.A coluna indexa iniciam em 1. Uma cadeia de caracteres que consiste em letra da coluna que você deseja obter. Para obter mais colunas contíguos, passe uma cadeia de caracteres com o formato “first column letter:last column letter”.Por exemplo, para obter as colunas à, E passe A “: ” E. Observação O nome do parâmetro é induz a erro; este parâmetro especifica os índices das colunas que você deseja obter, não linhas.
ColumnIndex	Não use este parâmetro.Esta propriedade lança COMException se você tentar passar um valor para este parâmetro.

RowIndex

O índice de uma ou mais colunas para obter.

Para obter uma única coluna, passe um dos seguintes objetos para esse parâmetro:

Um número inteiro que especifica o índice da coluna que você deseja obter.A coluna indexa iniciam em 1.
Uma cadeia de caracteres que consiste em letra da coluna que você deseja obter.

Para obter mais colunas contíguos, passe uma cadeia de caracteres com o formato “first column letter:last column letter”.Por exemplo, para obter as colunas à, E passe A “: ” E.

Observação

O nome do parâmetro é induz a erro; este parâmetro especifica os índices das colunas que você deseja obter, não linhas.

ColumnIndex

Não use este parâmetro.Esta propriedade lança COMException se você tentar passar um valor para este parâmetro.

Exemplos

O exemplo de código a seguir usa a propriedade de Columns para definir a cor, o nome, tamanho, e o arrojo da fonte de todas as células na primeira coluna na planilha.

Este exemplo é para uma personalização da nível.Para executar esse código, copiá-los em uma das classes de planilha em seu projeto.

Private Sub SetFirstColumnFont()
    Dim fillColumn As Excel.Range = TryCast(Me.Columns("A"), Excel.Range)

    With fillColumn.Font
        ' Set the font color to blue (RGB value FF 00 00), and set other font properties.
        .Color = &HFF0000
        .Name = "Arial"
        .Size = 14
        .Bold = False
    End With

    ' Test the changes by writing a value to all the column cells.
    fillColumn.Value2 = "This is a test"
End Sub

private void SetFirstColumnFont()
{
    Excel.Range fillColumn = (Excel.Range)this.Columns["A"];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value FF 00 00), and set other font properties.
    columnsFont.Color = 0xFF0000;
    columnsFont.Name = "Arial";
    columnsFont.Size = 14;
    columnsFont.Bold = false;

    // Test the changes by writing a value to all the column cells.
    fillColumn.Value2 = "This is a test";
}

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via