NamedRange.Columns – vlastnost

Článek
05/14/2013

Získá Microsoft.Office.Interop.Excel.Range , která představuje jeden nebo více sloupců v NamedRange ovládacího prvku.

Obor názvů: Microsoft.Office.Tools.Excel
Sestavení: Microsoft.Office.Tools.Excel (v Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Deklarace
ReadOnly Property Columns As Range

Range Columns { get; }

Hodnota vlastnosti

Typ: Microsoft.Office.Interop.Excel.Range
A Microsoft.Office.Interop.Excel.Range , která představuje jeden nebo více sloupcích NamedRange ovládacího prvku.

Poznámky

Při použití bez parametrů, vrátí tato vlastnost Range objekt, který obsahuje všechny sloupce v pojmenované oblasti.

Tuto vlastnost lze použít s následující volitelné parametry, chcete-li získat určité sloupce pojmenované oblasti.Pokud tuto vlastnost použít s parametry, vrácená hodnota je objekt, který musíte přetypovat Range.

Parametr	Description
RowIndex	Index jeden nebo více sloupců, které chcete získat. Chcete-li získat jeden sloupec, předáte jeden z následujících objektů tento parametr: Celé číslo, které určuje index sloupce, které chcete získat.Indexy sloupců začne v 1. Řetězec, který se skládá z písmeno sloupce, které chcete získat. Chcete-li získat více sousedních sloupců, předejte řetězec ve formátu "first column letter:last column letter".Například chcete-li získat sloupcích A až E, předáte "A:E". Poznámka Název tohoto parametru je zavádějící; Tento parametr určuje indexy sloupců, které chcete zobrazit, nikoli řádky.
ColumnIndex	Tento parametr nelze použít.Tato vlastnost vyvolá COMException Pokud chcete předat hodnotu tohoto parametru.

RowIndex

Index jeden nebo více sloupců, které chcete získat.

Chcete-li získat jeden sloupec, předáte jeden z následujících objektů tento parametr:

Celé číslo, které určuje index sloupce, které chcete získat.Indexy sloupců začne v 1.
Řetězec, který se skládá z písmeno sloupce, které chcete získat.

Chcete-li získat více sousedních sloupců, předejte řetězec ve formátu "first column letter:last column letter".Například chcete-li získat sloupcích A až E, předáte "A:E".

Poznámka

Název tohoto parametru je zavádějící; Tento parametr určuje indexy sloupců, které chcete zobrazit, nikoli řádky.

ColumnIndex

Tento parametr nelze použít.Tato vlastnost vyvolá COMException Pokud chcete předat hodnotu tohoto parametru.

Příklady

Následující příklad kódu vytvoří NamedRange a použije Columns vlastnost, kterou chcete nastavit barvu, název, velikost a výraznosti písmo všechny buňky v prvním sloupci oblasti.

V tomto příkladu je úroveň dokument přizpůsobení.Chcete-li spustit tento kód, zkopírujte jej do jednoho listu tříd v projektu.

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

Následující příklad kódu vytvoří NamedRange a použije Columns vlastnost k určení, kolik sloupců tam jsou v rozsahu.

V tomto příkladu je úroveň dokument přizpůsobení.Chcete-li spustit tento kód, zkopírujte jej do jednoho listu tříd v projektu.

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

Zabezpečení rozhraní .NET Framework

Plná důvěra přímému volajícímu. Částečně zabezpečený kód nemůže tento člen použít. Další informace naleznete v tématu Používání knihoven z částečně důvěryhodného kódu.

Viz také

Referenční dokumentace

NamedRange Rozhraní

Microsoft.Office.Tools.Excel – obor názvů

Sdílet prostřednictvím