WorksheetBase.Columns-Eigenschaft

Artikel
05/07/2013

Ruft ein Range-Objekt ab, das eine oder alle Spalten im Arbeitsblatt darstellt.

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

Syntax

'Declaration
Public ReadOnly Property Columns As Range

public Range Columns { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.Range
Ein Range-Objekt, das eine oder alle Spalten im Arbeitsblatt darstellt.

Hinweise

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

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

Parameter	Beschreibung
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 mit der Columns-Eigenschaft die Farbe, der Name, der Schriftgrad und die Fettformatierung der Schriftart für alle Zellen in der ersten Spalte des Arbeitsblatts 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 fillColumn As Excel.Range = TryCast(Me.Columns("A"), Excel.Range)

    With fillColumn.Font
        ' Set the font color to blue (RGB value FF 00 00), 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()
{
    Excel.Range fillColumn = (Excel.Range)this.Columns["A"];
    Excel.Font columnsFont = fillColumn.Font;

    // Set the font color to blue (RGB value FF 00 00), 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";
}

.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

WorksheetBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über