Propriedade NamedRange.Columns

Artigo
08/01/2011

Obtém um Microsoft.Office.Interop.Excel.Range que representa uma ou mais colunas da NamedRange de controle.

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

Sintaxe

'Declaração
ReadOnly Property Columns As Range
    Get

Range Columns { get; }

Valor de propriedade

Tipo: Microsoft.Office.Interop.Excel.Range
A Microsoft.Office.Interop.Excel.Range que representa uma ou mais colunas do NamedRange de controle.

Comentários

Quando usado sem parâmetros, essa propriedade retornará um Range objeto que contém todas as colunas no intervalo nomeado.

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

Parameter	Description
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. Os índices de coluna começam com 1. Uma seqüência de caracteres que consiste na letra da coluna que você deseja obter. Para obter a várias colunas contíguas, passe uma seqüência de caracteres com o formato "first column letter:last column letter". Por exemplo, para obter as colunas de a E, passe "a:e". Observação O nome deste parâmetro é equivocado; Este parâmetro especifica os índices das colunas que você deseja obter, não as linhas.
ColumnIndex	Não use esse parâmetro. Esta propriedade lançará um COMException se você tentar passar um valor para esse 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. Os índices de coluna começam com 1.
Uma seqüência de caracteres que consiste na letra da coluna que você deseja obter.

Para obter a várias colunas contíguas, passe uma seqüência de caracteres com o formato "first column letter:last column letter". Por exemplo, para obter as colunas de a E, passe "a:e".

Observação

O nome deste parâmetro é equivocado; Este parâmetro especifica os índices das colunas que você deseja obter, não as linhas.

ColumnIndex

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

Exemplos

O exemplo de código a seguir cria um NamedRange e, em seguida, usa o Columns a propriedade para definir a cor, nome, tamanho e o negrito da fonte de todas as células na primeira coluna do intervalo.

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

Private Sub SetFirstColumnFont()
    Dim testRange As Microsoft.Office.Tools.Excel.NamedRange = _
        Me.Controls.AddNamedRange(Me.Range("A1", "J10"), _
        "TestRange")
    testRange.Select()

    Dim fillColumn As Excel.Range = TryCast(testRange.Columns("A"), Excel.Range)
    With fillColumn.Font
        ' Set the font color to blue (RGB value 00 00 FF), 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()
{
    Microsoft.Office.Tools.Excel.NamedRange testRange = 
        this.Controls.AddNamedRange(this.Range["A1", "J10"],
        "TestRange");
    testRange.Select();

    Excel.Range fillColumn = (Excel.Range)testRange.Columns["A", missing];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value 00 00 FF), 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";
}

O exemplo de código a seguir cria um NamedRange e, em seguida, usa o Columns propriedade para determinar quantas colunas no intervalo.

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

Private compositeRange As Microsoft.Office.Tools.Excel.NamedRange

Private Sub DisplayRangeComposition()
    compositeRange = Me.Controls.AddNamedRange( _
        Me.Range("B2", "E5"), "compositeRange")
    compositeRange.Cells.Interior.Color = &HFF00
    MessageBox.Show("The range has " & _
        compositeRange.Count & " cells.")
    MessageBox.Show("The range has " & _
        compositeRange.Columns.Count & " columns.")
    MessageBox.Show("The range has " & _
        compositeRange.Rows.Count & " rows.")
End Sub

Microsoft.Office.Tools.Excel.NamedRange compositeRange;
private void DisplayRangeComposition()
{
    compositeRange = this.Controls.AddNamedRange(
        this.Range["B2", "E5"], "compositeRange");
    compositeRange.Cells.Interior.Color = 0xFF00;
    MessageBox.Show("The range has " + compositeRange.Count + 
        " cells.");
    MessageBox.Show("The range has " + 
        compositeRange.Columns.Count + " columns.");
    MessageBox.Show("The range has " + 
        compositeRange.Rows.Count + " rows.");
}

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

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via