Właściwość NamedRange.Columns —

Pobiera Microsoft.Office.Interop.Excel.Range który reprezentuje jedną lub więcej kolumn w NamedRange kontroli.

Przestrzeń nazw:  Microsoft.Office.Tools.Excel
Zestaw:  Microsoft.Office.Tools.Excel (w Microsoft.Office.Tools.Excel.dll)

Składnia

'Deklaracja
ReadOnly Property Columns As Range

Range Columns { get; }

Wartość właściwości

Typ: Microsoft.Office.Interop.Excel.Range
A Microsoft.Office.Interop.Excel.Range który reprezentuje jedną lub więcej kolumn w NamedRange kontroli.

Uwagi

Jeżeli nie określono parametrów, właściwość ta zwraca Range obiekt, który zawiera wszystkie kolumny z nazwanego zakresu.

Ta właściwość może służyć z następujące parametry opcjonalne uzyskanie określonych kolumn z nazwanego zakresu.Jeśli używasz tej właściwości z parametrami, wartość zwracana jest obiektem, który musi być rzutowane na Range.

Parametr	Opis
RowIndex	Indeks jedną lub więcej kolumn, aby uzyskać. Aby uzyskać pojedyncza kolumna, przekazać do tego parametru jeden z następujących obiektów: Liczba całkowita określająca indeks kolumny, którą chcesz uzyskać.Indeksy kolumn rozpoczynać od 1. Ciąg, który składa się z litery kolumny, którą chcesz uzyskać. Aby uzyskać wiele sąsiadujących kolumn, należy przekazać ciąg w formacie "first column letter:last column letter".Na przykład aby uzyskać kolumny od A do E, przekazać "A:E". Uwaga Nazwa tego parametru jest mylące; Ten parametr określa indeksy kolumn chcesz uzyskać, nie wierszy.
ColumnIndex	Nie należy używać tego parametru.Ta właściwość będzie rzucić COMException przy próbie przekazać wartość tego parametru.

Przykłady

Poniższy przykład kodu tworzy NamedRange , a następnie używa Columns właściwość, aby ustawić kolor, nazwa, rozmiar i grubość czcionki wszystkich komórek w pierwszej kolumnie zakresu.

W tym przykładzie jest dla dostosowania poziomu dokumentu.Aby uruchomić ten kod, skopiuj go do jednej z klas arkusza w projekcie.

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

Poniższy przykład kodu tworzy NamedRange , a następnie używa Columns właściwość, aby określić, ile kolumn są w zakresie.

W tym przykładzie jest dla dostosowania poziomu dokumentu.Aby uruchomić ten kod, skopiuj go do jednej z klas arkusza w projekcie.

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

Zabezpieczenia programu .NET Framework

• Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel