Freigeben über

Exemplarische Vorgehensweise: Verwenden von freigegebenem Code in Websites in Visual Web Developer

  • Artikel

Aktualisiert: November 2007

Beim Erstellen von Websites können Sie mithilfe von Visual Web Developer auf einfache Weise freigegeben Code in Klassendateien erstellen, die dann von Seiten in der Anwendung auch ohne Kompilierung von Klassendateien verwendet werden können.

Hinweis:

Wenn Sie über vorhandene Assemblys (DLL-Dateien) verfügen, können Sie diese dem Verzeichnis Bin der Website hinzufügen. Der Verweis auf diese Assemblys erfolgt dann automatisch durch die Website.

In dieser exemplarischen Vorgehensweise wird eine einfache Klasse erstellt und anschließend als ASP-NET-Webseite verwendet.

In dieser exemplarischen Vorgehensweise werden u. a. folgende Aufgaben veranschaulicht:

  • Hinzufügen einer Klasse zu einer Website

  • Automatisches Verweisen von Visual Web Developer auf die Komponente

Vorbereitungsmaßnahmen

Für die Durchführung dieser exemplarischen Vorgehensweise benötigen Sie Folgendes:

  • Visual Web Developer (Visual Studio).

  • .NET Framework.

Für diese exemplarische Vorgehensweise müssen Sie über allgemeine Kenntnisse in Visual Web Developer verfügen. Eine Einführung finden Sie unter Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite in Visual Web Developer.

Erstellen der Website und der Webseite

Wenn Sie bereits eine Website in Visual Web Developer erstellt haben (z. B. durch Abschließen von Exemplarische Vorgehensweise: Erstellen einer einfachen Webseite in Visual Web Developer oder Exemplarische Vorgehensweise: Erstellen einer lokalen IIS-Website in Visual Web Developer), können Sie diese Website verwenden und mit dem nächsten Abschnitt fortfahren. Erstellen Sie andernfalls eine neue Website und eine neue Webseite, indem Sie folgende Schritte ausführen:

So erstellen Sie eine Dateisystem-Website

  1. Öffnen Sie Visual Web Developer.

  2. Klicken Sie im Menü Datei auf Neue Website. (Klicken Sie in Visual Web Developer Express Edition im Menü Datei auf Neu, und klicken Sie dann auf Website.)

    Das Dialogfeld Neue Website wird angezeigt.

  3. Klicken Sie unter Von Visual Studio installierte Vorlagen auf ASP.NET-Website.

  4. Geben Sie im Feld Speicherort den Namen des Ordners ein, in dem Sie die Seiten der Website ablegen möchten.

    Beispiel:

    • Wenn Sie eine Dateisystem-Website erstellen, geben Sie C:\SampleSite ein.

    • Wenn IIS installiert ist und Sie eine HTTP-Website erstellen, geben Sie https://localhost/SampleSite ein.

  5. Wählen Sie in der Liste Sprache die Programmiersprache aus, in der Sie arbeiten möchten.

  6. Klicken Sie auf OK.

    Visual Web Developer erstellt die Website und öffnet die neue Seite Default.aspx.

Erstellen einer freigegebenen Klasse

Sie können wiederverwendbare Klassen erstellen, indem Sie sie im Ordner App_Code ablegen. Visual Web Developer überwacht den Ordner App_Code. Wenn neue Klassendateien hinzugefügt werden, macht Visual Web Developer die Komponenten für den restlichen Code in der Anwendung verfügbar. Die Klassen im Ordner App_Code werden standardmäßig zur Laufzeit in einer einzigen Assembly kompiliert.

Hinweis:

Legen Sie nur Klassen (und andere unterstützte freigegebene Typen) im Ordner App_Code ab. Legen Sie Webseiten, Webbenutzer-Steuerelemente oder andere Dateien mit Nicht-Code-Elementen nicht im Ordner App_Code ab.

So erstellen Sie den Ordner App_Code

  • Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Website, klicken Sie auf Ordner hinzufügen, und klicken Sie dann auf Ordner App_Code.

    Sie können der Site jetzt die Komponente hinzufügen.

So erstellen Sie im Ordner App_Code eine freigegebene Klasse

  1. Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf App_Code, und klicken Sie dann auf Neues Element hinzufügen.

    Hinweis:

    Vergewissern Sie sich, dass das neue Element im Ordner App_Code und nicht im Stammordner der Website erstellt wird.

  2. Klicken Sie unter Von Visual Studio installierte Vorlagen auf Klasse.

  3. Geben Sie im Feld Name den Namen SampleClass1 ein.

  4. Wählen Sie in der Liste Sprache die Sprache aus, die von der Webseite verwendet wird, die die freigegebene Klasse verwendet.

  5. Klicken Sie auf Hinzufügen.

    Visual Web Developer öffnet die neue Klassendatei im Editor.

  6. Erstellen Sie eine Klasse, die über die testString-Eigenschaft verfügt, indem Sie den folgenden Code in die Klassendatei kopieren:

    Public Class SampleClass1
    private testStringValue As String
    Public Property testString as String
        Get
            return testStringValue
        End Get
        Set (Value as String)
            testStringValue = value
        End Set
    End Property
End Class

    using System;
public class SampleClass1
{
    public SampleClass1() 
    {
    }
    private string testStringValue;
    public string testString 
    {
        get
        {
              return testStringValue;
        }
        set
        {
               testStringValue = value;
        }
    }
}

  7. Speichern Sie die Datei, und schließen Sie sie dann.

    Beachten Sie, dass die Datei nicht als kompilierte Datei gespeichert wird.

    Hinweis:

    Wenn Sie freigegebene Klassen im Ordner App_Code verwenden, müssen Sie die Komponenten nicht gespeichert werden, damit Visual Web Developer einen Verweis auf die Komponenten speichert. Wenn die Webseite und die Komponente in derselben Programmiersprache vorliegen, speichert Visual Web Developer im Arbeitsspeicher einen Verweis auf die Komponente. In diesem Fall schließen Sie die Datei, da sie fertig gestellt ist.

Verwenden der freigegebenen Klasse

Im nächsten Schritt wird die freigegebene Klasse auf einer ASP.Net-Webseite verwendet. Sie können die beim Erstellen der Website erstellte Seite Default.aspx verwenden.

So verwenden Sie die freigegebene Klasse

  1. Öffnen Sie die Seite Default.aspx, oder wechseln Sie zur Seite Default.aspx, und wechseln Sie dann zur Entwurfsansicht.

    Hinweis:

    Wenn keine Default.aspx-Seite vorhanden ist, kann eine andere Seite verwendet werden. Sie können der Website auch eine neue Seite hinzufügen. Klicken Sie dazu im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Website, klicken Sie auf Neues Element hinzufügen, und klicken Sie dann auf Web Form. Geben Sie in der Liste Sprache dieselbe Programmiersprache ein, die für die Komponente verwendet wurde, und klicken Sie dann auf OK.

  2. Ziehen Sie die Steuerelemente TextBox, Label und Button aus dem Ordner Standard der Toolbox auf die Seite.

    Hinweis:

    Für diese exemplarische Vorgehensweise ist das Layout der Seite nicht wichtig.

  3. Doppelklicken Sie auf das Button-Steuerelement, um einen Click-Handler für das Steuerelement zu erstellen.

    Der Click-Handler-Code entspricht in etwa der folgenden Darstellung:

    Protected Sub Button1_Click(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

End Sub

    protected void Button1_Click(object sender, EventArgs e)
{

}

  4. Geben Sie im Handler Folgendes ein:

    Dim sc As New

    SampleClass1 sc = new

    Wenn Sie die LEERTASTE drücken, nachdem New oder new eingegeben wurde, zeigt Visual Web Developer eine Liste der verfügbaren Klassen an. Die im vorangehenden Abschnitt erstellte Klasse SampleClass1 ist in der Liste enthalten.

  5. Beenden Sie die Anweisung, indem Sie SampleClass1 eingeben oder in der Liste darauf doppelklicken, sodass die Anweisung wie folgt lautet:

    Dim sc As New SampleClass1

    SampleClass1 sc = new SampleClass1();

  6. Drücken Sie die EINGABETASTE, und geben Sie dann Folgendes ein:

    sc.

    Sobald Sie den Zeitraum eingeben, zeigt Visual Web Developer erneut eine Liste der Member an, sodass ein Member aus der Beispielklasse ausgewählt werden kann.

  7. Beenden Sie die Anweisung und den Handler wie folgt:

    sc.testString = TextBox1.Text
Label1.Text = sc.testString

    sc.testString = TextBox1.Text;
Label1.Text = sc.testString;

  8. Speichern Sie die Dateien.

Testen der Seite und der Klasse

Sie können die Website ausführen, um zu überprüfen, ob die freigegebene Klasse funktioniert.

So testen Sie die Seite und die Komponente

  1. Öffnen Sie die Seite Default.aspx.

  2. Drücken Sie STRG+F5, um die Seite auszuführen.

  3. Wenn die Seite im Browser angezeigt wird, geben Sie Text in das Textfeld ein, und klicken Sie dann auf die Schaltfläche.

    Auf diese Weise wird eine Eigenschaft in der einfachen Klasse festgelegt und anschließend im Label-Steuerelement angezeigt.

Wenn Sie mithilfe von Microsoft Windows Explorer das Verzeichnis überprüfen, in dem sich die Website befindet, werden die Seite und der Ordner App_Code angezeigt. Beachten Sie, dass weder im Ordner App_Code noch im Stammordner der Website DLL-Code oder anderer ausführbarer Code vorhanden ist. Stattdessen wurden die Seite und die freigegebene Klasse von Visual Web Developer dynamisch kompiliert.

Nächste Schritte

In dieser exemplarischen Vorgehensweise wird veranschaulicht, wie einer Website freigegebene Klassen hinzugefügt werden, ohne Komponenten zu kompilieren. Freigegebene Klassen können auf verschiedene Weise verwendet werden. Auf diese Weise können Sie beispielsweise folgende Vorgänge durchführen:

Siehe auch

Konzepte

ASP.NET-Websitelayout

Ordner für freigegebenen Code in ASP.NET-Websites