Właściwość NamedRange.Columns —

Pobiera Microsoft.Office.Interop.Excel.Range , oznaczającą jeden 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 , oznaczającą jeden 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ących parametrów uzyskać określonych kolumn z nazwanego zakresu.Jeśli używasz tej właściwości z parametrami, wartość zwracana jest obiekt, który musi być rzutowane na Range.

Parametr	Opis
RowIndex	Indeks jedną lub więcej kolumn, aby uzyskać. Aby uzyskać jednej kolumnie, należy przekazać jedną z następujących obiektów do tego parametru: Liczba całkowita określająca indeks kolumny, którą chcesz uzyskać.Indeksy kolumna rozpoczynać się 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ć kolumnach od A do E, należy przekazać "A:E". Uwaga Nazwa tego parametru jest błąd. Ten parametr określa indeksy kolumn w celu uzyskania nie wierszy.
ColumnIndex	Nie należy używać tego parametru.Ta właściwość będzie rzucić COMException podczas próby przekazać wartość do tego parametru.

Przykłady

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

Ten przykład dotyczy dostosowywania poziomie 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ść w celu określenia, ile kolumn znajdują się w zakresie.

Ten przykład dotyczy dostosowywania poziomie 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 Przy użyciu bibliotek z częściowo zaufanego kodu..

Zobacz też

Informacje

NamedRange Interfejs

Przestrzeń nazw Microsoft.Office.Tools.Excel