Proprietà NamedRange.Columns

Articolo
08/11/2011

Ottiene un oggetto Microsoft.Office.Interop.Excel.Range che rappresenta una o più colonne nel controllo NamedRange.

Spazio dei nomi: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Columns As Range
    Get

Range Columns { get; }

Valore proprietà

Tipo: Microsoft.Office.Interop.Excel.Range
Microsoft.Office.Interop.Excel.Range che rappresenta una o più colonne nel controllo NamedRange.

Note

Quando utilizzata senza parametri, questa proprietà restituisce un oggetto Range che contiene tutte le colonne nell'intervallo denominato.

Questa proprietà può essere utilizzata con i parametri facoltativi seguenti per ottenere colonne specifiche nell'intervallo denominato. Se si utilizza questa proprietà con i parametri, il valore restituito è un oggetto di cui deve essere eseguito il cast su un oggetto Range.

Parametro	Oggetto di descrizione
RowIndex	Indice di una o più colonne da ottenere. Per ottenere una sola colonna, passare uno degli oggetti seguenti a questo parametro: Un intero che specifica l'indice della colonna che si desidera ottenere. Gli indici di colonna iniziano da 1. Una stringa costituita dalla lettera della colonna che si desidera ottenere. Per ottenere più colonne contigue, passare una stringa con il formato "first column letter:last column letter". Ad esempio, per ottenere le colonne che vanno da A a E, passare "A:E". Nota Il nome di questo parametro è fuorviante; questo parametro specifica gli indici delle colonne che si desidera ottenere, non le righe.
ColumnIndex	Non utilizzare questo parametro. Questa proprietà genererà un oggetto COMException se si tenta di passare un valore a questo parametro.

RowIndex

Indice di una o più colonne da ottenere.

Per ottenere una sola colonna, passare uno degli oggetti seguenti a questo parametro:

Un intero che specifica l'indice della colonna che si desidera ottenere. Gli indici di colonna iniziano da 1.
Una stringa costituita dalla lettera della colonna che si desidera ottenere.

Per ottenere più colonne contigue, passare una stringa con il formato "first column letter:last column letter". Ad esempio, per ottenere le colonne che vanno da A a E, passare "A:E".

Nota

Il nome di questo parametro è fuorviante; questo parametro specifica gli indici delle colonne che si desidera ottenere, non le righe.

ColumnIndex

Non utilizzare questo parametro. Questa proprietà genererà un oggetto COMException se si tenta di passare un valore a questo parametro.

Esempi

Nell'esempio di codice riportato di seguito viene creata NamedRange, quindi viene utilizzata la proprietà Columns per impostare il colore, il nome, la dimensione e il grassetto del carattere di tutte le celle nella prima colonna dell'intervallo.

Questo esempio è valido per una personalizzazione a livello di documento. Per eseguire questo codice, copiarlo in una delle classi del foglio grafico nel progetto.

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

Nell'esempio di codice riportato di seguito viene creato un NamedRange e quindi viene utilizzata la proprietà Columns per determinare quante colonne si trovano nell'intervallo.

Questo esempio è valido per una personalizzazione a livello di documento. Per eseguire questo codice, copiarlo in una delle classi del foglio grafico nel progetto.

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

Sicurezza di .NET Framework

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel

Share via