NamedRange.Columns (Propiedad)

Artículo
08/10/2011

Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa una o más columnas del control NamedRange.

Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)

Sintaxis

'Declaración
ReadOnly Property Columns As Range
    Get

Range Columns { get; }

Valor de propiedad

Tipo: Microsoft.Office.Interop.Excel.Range
Un objeto Microsoft.Office.Interop.Excel.Range que representa una o más columnas del control NamedRange.

Comentarios

Cuando se usa sin parámetros, esta propiedad devuelve un objeto Range que contiene todas las columnas en el rango con nombre.

Esta propiedad se puede usar con los parámetros opcionales siguientes para obtener columnas concretas en el rango con nombre. Si usa esta propiedad con parámetros, el valor devuelto es un objeto que se debe convertir en Range.

Parámetro	Descripción
RowIndex	El índice de una o más columnas que se va a obtener. Para obtener una columna única, pase uno de los objetos siguientes a este parámetro: Un entero que especifica el índice de la columna que desea obtener. Los índices de columna comienzan en 1. Cadena que consta de las letras de la columna que desea obtener. Para obtener varias columnas contiguas, pase una cadena con el formato "first column letter:last column letter". Por ejemplo, para obtener las columnas desde A hasta E, pase "A:E". Nota El nombre de este parámetro puede conducir a error; este parámetro especifica los índices de las columnas que desea obtener, no las filas.
ColumnIndex	No use este parámetro. Esta propiedad producirá un COMException si intenta pasar un valor a este parámetro.

RowIndex

El índice de una o más columnas que se va a obtener.

Para obtener una columna única, pase uno de los objetos siguientes a este parámetro:

Un entero que especifica el índice de la columna que desea obtener. Los índices de columna comienzan en 1.
Cadena que consta de las letras de la columna que desea obtener.

Para obtener varias columnas contiguas, pase una cadena con el formato "first column letter:last column letter". Por ejemplo, para obtener las columnas desde A hasta E, pase "A:E".

Nota

El nombre de este parámetro puede conducir a error; este parámetro especifica los índices de las columnas que desea obtener, no las filas.

ColumnIndex

No use este parámetro. Esta propiedad producirá un COMException si intenta pasar un valor a este parámetro.

Ejemplos

En el ejemplo de código siguiente se crea NamedRange y, a continuación, se usa la propiedad Columns para establecer el color, nombre, tamaño y estado de negrita de la fuente de todas las celdas de la primera columna del intervalo.

Se trata de un ejemplo para una personalización en el nivel del documento. Para ejecutar este código, cópielo en una de las clases de hoja de cálculo en su proyecto.

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";
}

En el ejemplo de código siguiente se crea NamedRange y, a continuación, se usa la propiedad Columns para determinar cuántas columnas hay en el intervalo.

Se trata de un ejemplo para una personalización en el nivel del documento. Para ejecutar este código, cópielo en una de las clases de hoja de cálculo en su proyecto.

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.");
}

Seguridad de .NET Framework

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Vea también

Referencia

NamedRange Interfaz

Microsoft.Office.Tools.Excel (Espacio de nombres)

Share via