Propriedade NamedRange.Columns
Obtém Microsoft.Office.Interop.Excel.Range que representa uma ou mais colunas no controle de NamedRange .
Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)
Sintaxe
'Declaração
ReadOnly Property Columns As Range
Range Columns { get; }
Valor de propriedade
Tipo: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Range que representa uma ou mais colunas no controle de NamedRange .
Comentários
Quando usado sem parâmetros, essa propriedade retorna um objeto de Range 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ê 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:
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 cria NamedRange e use a propriedade de Columns para definir a cor, o nome, tamanho, e o arrojo da fonte de todas as células na primeira coluna do intervalo.
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 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"];
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 NamedRange e use a propriedade de Columns para determinar quantas colunas existem está no intervalo.
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 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.