Een assembly registreren in een WebForm om een aangepast besturingselement te gebruiken

Dit artikel bevat informatie over het beschikbaar maken en registreren van een assembly in een WebForm voor gebruik met ASP.NET aangepaste serverbesturingselementen.

Oorspronkelijke productversie: ASP.NET
Origineel KB-nummer: 321749

Voorbeeldassembly-eigenschappen

Als u wilt worden weergegeven als een aangepast serverbesturingselement, moet de assembly een klasse hebben die direct of indirect is afgeleid en System.Web.UI.Control moet u de klasse insluiten in een naamruimte. In voorbeelden in dit artikel wordt ervan uitgegaan dat de klasse is opgenomen in de CustomControlNamespace naamruimte en dat de assembly is gecompileerd in een bestand met de naam CustomControl.dll.

Een assembly beschikbaar maken voor ASP.NET toepassing

Als u een assembly beschikbaar wilt maken voor een ASP.NET-toepassing, moet u de .dll van de assembly in de /bin map van de toepassing plaatsen.

  1. Navigeer naar de hoofdmap van de toepassing in Windows Verkenner.

    Ga als volgt te werk om erachter te komen wat de projectmap van de toepassing is:

    1. Selecteer in de .NET-omgeving onder het menu Beeldde optie Solution Explorer.
    2. Klik met de rechtermuisknop op een projecthoofditem in Solution Explorer en selecteer Eigenschappen.
    3. Selecteer in het dialoogvenster Projecteigenschappen de optie Algemene eigenschappen en selecteer Algemeen.

    In het structuurvenster ziet u de lijst met de eigenschap Projectmap . Dit is meestal de hoofdmap van de toepassing.

  2. Maak in een webtoepassingsprojectmap een map met de naam bin als deze niet bestaat.

  3. Kopieer of verplaats de .dll van de assembly in deze map. U kunt het besturingselement nu gebruiken vanaf elke ASP.NET pagina in de hoofdmap van uw toepassing (of een van de submappen).

De assembly registreren in een webformulier voor een ASP.NET-toepassing

Open in een .NET-programmeeromgeving het Form.aspx bronvenster en voeg de volgende tag boven aan de code toe:

<%@ Register TagPrefix="Custom" Namespace="CustomControlNamespace" Assembly= "CustomControl" %>

In de bovenstaande code:

  • Custom is een alias die u koppelt aan een naamruimte.
  • CustomControlNamespace is een naamruimte waarin klassen van een assembly zijn ingesloten.
  • CustomControl is de naam van het assemblybestand zonder extensie (.dll).

Wijzig deze parameters in uw code in de juiste namen voor uw assembly.

De assembly is nu geregistreerd in een webformulier. U kunt deze geregistreerde assembly gebruiken in uw ASP.NET code met de gekozen namen. De tag kan bijvoorbeeld zijn:

<Custom:CustomControl id="CustomControl1" parameter1="value1" parameter2="value2" runat="server"/>

In de bovenstaande Custom tag is de gekozen naam voor de naamruimte van de assembly, CustomControl de naam van het aangepaste serverbeheer en parameter2parameter 1 zijn optionele besturingseigenschappen die variƫren op basis van uw werkelijke code.