NamedRange.Columns (Propiedad)
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
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:
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"];
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.