Freigeben über

Gewusst wie: Hinzufügen von NamedRange-Steuerelementen zu Arbeitsblättern

  • Artikel

Sie können Microsoft Office Excel-Arbeitsblättern zur Entwurfszeit und zur Laufzeit NamedRange-Steuerelemente in Projekten auf Dokumentebene hinzufügen.

Betrifft: Die Informationen in diesem Thema betreffen Projekte auf Dokument- und auf Anwendungsebene für Excel 2007 und Excel 2010. Weitere Informationen finden Sie unter Verfügbare Funktionen nach Office-Anwendung und Projekttyp.

In Add-In-Projekten auf Anwendungsebene können zur Laufzeit auch NamedRange-Steuerelemente hinzugefügt werden.

In diesem Thema werden die folgenden Aufgaben erläutert:

  • Hinzufügen von NamedRange-Steuerelementen zur Entwurfszeit

  • Hinzufügen von NamedRange-Steuerelementen zur Laufzeit in einem Projekt auf Dokumentebene

  • Hinzufügen von NamedRange-Steuerelementen zur Laufzeit in einem Projekt auf Anwendungsebene

Weitere Informationen zu NamedRange-Steuerelementen finden Sie unter NamedRange-Steuerelement.

Hinzufügen von NamedRange-Steuerelementen zur Entwurfszeit

Es gibt verschiedene Möglichkeiten zum Hinzufügen von NamedRange-Steuerelementen zur Entwurfszeit zu Arbeitsblättern in einem Projekt auf Dokumentebene : in Excel, über die Toolbox von Visual Studio und mit dem Datenquellenfenster.

Tipp

Ihr Computer zeigt möglicherweise für einige der Elemente der Visual Studio-Benutzeroberfläche in der folgenden Anleitung andere Namen oder Standorte an. Diese Elemente sind von der jeweiligen Visual Studio-Version und den verwendeten Einstellungen abhängig. Weitere Informationen finden Sie unter Visual Studio-Einstellungen.

So fügen Sie einem Arbeitsblatt mithilfe des Namenfelds in Excel ein NamedRange-Steuerelement hinzu

  1. Wählen Sie die Zelle oder die Zellen aus, die Sie in den benannten Bereich einbinden möchten.

  2. Geben Sie im Namenfeld einen Namen für den Bereich ein, und drücken Sie die EINGABETASTE.

    Das Namenfeld befindet sich neben der Bearbeitungsleiste, genau über Spalte A des Arbeitsblatts.

So fügen Sie einem Arbeitsblatt mithilfe der Toolbox ein NamedRange-Steuerelement hinzu

  1. Öffnen Sie die Toolbox, und klicken Sie auf die Registerkarte Excel-Steuerelemente.

  2. Klicken Sie auf NamedRange, und ziehen Sie es in ein Arbeitsblatt.

    Das Dialogfeld Benannten Bereich hinzufügen wird angezeigt.

  3. Wählen Sie die Zelle oder die Zellen aus, die Sie in den benannten Bereich einbinden möchten.

  4. Klicken Sie auf OK.

    Wenn Ihnen der Standardname für das Steuerelement nicht gefällt, können Sie den Namen im Eigenschaftenfenster ändern.

So fügen Sie einem Arbeitsblatt mithilfe des Datenquellenfeldes in Excel ein NamedRange-Steuerelement hinzu

  1. Öffnen Sie das Datenquellenfenster, und erstellen Sie für Ihr Projekt eine Datenquelle. Weitere Informationen finden Sie unter Gewusst wie: Herstellen einer Verbindung zu Daten in einer Datenbank.

  2. Ziehen Sie ein einzelnes Feld aus dem Datenquellenfenster in das Arbeitsblatt.

    Ein datengebundenes NamedRange-Steuerelement wird dem Arbeitsblatt hinzugefügt. Weitere Informationen finden Sie unter Datenbindung und Windows Forms.

Hinzufügen von NamedRange-Steuerelementen zur Laufzeit in einem Projekt auf Dokumentebene

Sie können dem Arbeitsblatt zur Laufzeit programmgesteuert ein NamedRange-Steuerelement hinzufügen. Dies ermöglicht es Ihnen, die Hoststeuerelemente als Reaktion auf Ereignisse zu erstellen. Dynamisch erstellte NamedRange-Steuerelemente werden beim Schließen des Arbeitsblatts nicht als Hoststeuerelemente im Arbeitsblatt beibehalten. Weitere Informationen finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

So fügen Sie einem Arbeitsblatt ein NamedRange-Steuerelement programmgesteuert hinzu

  • Fügen Sie im Startup-Ereignishandler von Sheet1 folgenden Code ein, um der Zelle A1 das NamedRange-Steuerelement hinzuzufügen und seine Value2-Eigenschaft auf Hello world! festzulegen.

    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange
textInCell = Me.Controls.AddNamedRange(Me.Range("A1"), "cellText")

textInCell.Value2 = "Hello world!"

    Microsoft.Office.Tools.Excel.NamedRange textInCell;
textInCell = this.Controls.AddNamedRange(this.get_Range("A1", missing), "cellText");

textInCell.Value2 = "Hello world!";

Hinzufügen von NamedRange-Steuerelementen zur Laufzeit in einem Projekt auf Anwendungsebene

Sie können jedem geöffneten Arbeitsblatt in einem Projekt auf Anwendungsebene ein NamedRange-Steuerelement programmgesteuert hinzufügen. Dynamisch erstellte NamedRange-Steuerelemente werden beim Schließen des Arbeitsblatts nicht als Hoststeuerelemente im Arbeitsblatt beibehalten. Weitere Informationen finden Sie unter Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit.

So fügen Sie einem Arbeitsblatt ein NamedRange-Steuerelement programmgesteuert hinzu

  • Der folgende Code generiert ein Arbeitsblatt-Hostelement auf der Basis eines geöffneten Arbeitsblatts, fügt dann ein NamedRange-Steuerelement der Zelle A1 hinzu und legt als Value2-Eigenschaft dafür Hello world fest.

    Private Sub AddNamedRange()
    Dim textInCell As Microsoft.Office.Tools.Excel.NamedRange

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1)

    ' Use the following line of code in projects that target the .NET Framework 4.
    Dim worksheet As Microsoft.Office.Tools.Excel.Worksheet =
        Globals.Factory.GetVstoObject(NativeWorksheet)

    ' In projects that target the .NET Framework 3.5, use the following line of code.
    ' Dim worksheet = CType(Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets(1),  _
    '    Excel.Worksheet).GetVstoObject()

    Dim cell As Excel.Range = worksheet.Range("A1")
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange")
    textInCell.Value2 = "Hello World"
End Sub

    private void AddNamedRange()
{
    Microsoft.Office.Tools.Excel.NamedRange textInCell;

    // Use the following line of code in projects that target the .NET Framework 4.
    Worksheet worksheet = Globals.Factory.GetVstoObject(
        Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]);

    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Worksheet worksheet = 
    //     ((Excel.Worksheet)Globals.ThisAddIn.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();

    Excel.Range cell = worksheet.Range["A1", missing]; 
    textInCell = worksheet.Controls.AddNamedRange(cell, "MyNamedRange");
    textInCell.Value2 = "Hello World";
 }

Siehe auch

Aufgaben

Gewusst wie: Ändern der Größe von NamedRange-Steuerelementen

Konzepte

Erweitern von Word-Dokumenten und Excel-Arbeitsmappen in Add-Ins auf Anwendungsebene zur Laufzeit

NamedRange-Steuerelement

Automatisieren von Excel mithilfe von erweiterten Objekten

Übersicht über Hostelemente und Hoststeuerelemente

Programmgesteuerte Einschränkungen von Hostelementen und Hoststeuerelementen

Weitere Ressourcen

Steuerelemente für Office-Dokumente