NamedRange.Columns-Eigenschaft

Artikel
08/10/2011

Ruft ein Microsoft.Office.Interop.Excel.Range-Element ab, das eine oder alle Spalten im NamedRange-Steuerelement darstellt.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Columns As Range
    Get

Range Columns { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.Range
Ein Microsoft.Office.Interop.Excel.Range-Element, das eine oder alle Spalten im NamedRange-Steuerelement darstellt.

Hinweise

Wenn sie ohne Parameter verwendet wird, gibt diese Eigenschaft ein Range-Objekt zurück, das alle Spalten im benannten Bereich enthält.

Diese Eigenschaft kann mit den folgenden optionalen Parametern verwendet werden, um bestimmte Spalten im benannten Bereich abzurufen. Wenn Sie diese Eigenschaft mit Parametern verwenden, ist der Rückgabewert ein Objekt, das in einen Range umgewandelt werden muss.

Parameter	Beschreibungen
RowIndex	Der Index einer oder mehrerer Spalten, die abgerufen werden sollen. Um eine einzelne Spalte abzurufen, übergeben Sie eines der folgenden Objekte an diesen Parameter: Eine ganze Zahl, die den Index der Spalte angibt, die Sie abrufen möchten. Die Spaltenindizes beginnen bei 1. Eine Zeichenfolge, die aus dem Buchstaben der abzurufenden Spalte besteht. Um mehrere zusammenhängende Spalten abzurufen, übergeben Sie eine Zeichenfolge mit dem Format "first column letter:last column letter". Um z.B. die Spalten A bis E abzurufen, übergeben Sie "A:E". Hinweis Der Name dieses Parameters ist irreführend: Der Parameter gibt die Indizes der Spalten an, die Sie abrufen möchten, nicht die Zeilen.
ColumnIndex	Verwenden Sie diesen Parameter nicht. Diese Eigenschaft löst eine COMException aus, wenn Sie versuchen, einen Wert an diesen Parameter zu übergeben.

RowIndex

Der Index einer oder mehrerer Spalten, die abgerufen werden sollen.

Um eine einzelne Spalte abzurufen, übergeben Sie eines der folgenden Objekte an diesen Parameter:

Eine ganze Zahl, die den Index der Spalte angibt, die Sie abrufen möchten. Die Spaltenindizes beginnen bei 1.
Eine Zeichenfolge, die aus dem Buchstaben der abzurufenden Spalte besteht.

Um mehrere zusammenhängende Spalten abzurufen, übergeben Sie eine Zeichenfolge mit dem Format "first column letter:last column letter". Um z.B. die Spalten A bis E abzurufen, übergeben Sie "A:E".

Hinweis

Der Name dieses Parameters ist irreführend: Der Parameter gibt die Indizes der Spalten an, die Sie abrufen möchten, nicht die Zeilen.

ColumnIndex

Verwenden Sie diesen Parameter nicht. Diese Eigenschaft löst eine COMException aus, wenn Sie versuchen, einen Wert an diesen Parameter zu übergeben.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt und anschließend mit der Columns-Eigenschaft die Farbe, der Name, der Schriftgrad und die Fettformatierung der Schriftart für alle Zellen in der ersten Spalte des Bereichs festgelegt.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene. Wenn Sie diesen Code ausführen möchten, kopieren Sie ihn in eine der Arbeitsblattklassen im Projekt.

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

Im folgenden Codebeispiel wird ein NamedRange erstellt und anschließend mit der Columns-Eigenschaft ermittelt, wie viele Spalten sich im Bereich befinden.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene. Wenn Sie diesen Code ausführen möchten, kopieren Sie ihn in eine der Arbeitsblattklassen im Projekt.

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

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Share via