Özel denetim kullanmak için bir derlemeyi WebForm'a kaydetme

Bu makalede, bir derlemeyi webformunda ASP.NET özel sunucu denetimleriyle kullanmak üzere kullanılabilir hale getirmek ve kaydetmek için bilgiler sağlanır.

Orijinal ürün sürümü: ASP.NET
Özgün KB numarası: 321749

Örnek derleme özellikleri

Özel Sunucu Denetimi olarak temsil edilebilmesi için derlemenin doğrudan veya dolaylı olarak türetilen System.Web.UI.Control bir sınıfı olması ve sınıfı bir ad alanına almanız gerekir. Bu makaledeki örnekler sınıfın ad alanına eklendiğini CustomControlNamespace ve derlemenin CustomControl.dlladlı bir dosyada başarıyla derlendiğini varsayar.

Derlemeyi ASP.NET uygulama için kullanılabilir hale getirme

Bir derlemeyi ASP.NET bir uygulama için kullanılabilir hale getirmek için derlemenin .dll /bin uygulamanın klasörüne yerleştirmeniz gerekir.

  1. Windows Gezgini'nde uygulamanın kök dizinine gidin.

    Uygulama projesi klasörünün ne olduğunu öğrenmek için:

    1. .NET ortamındaki Görünüm menüsünün altında Çözüm Gezgini'ı seçin.
    2. Çözüm Gezgini'da bir proje ana öğesine sağ tıklayın ve Özellikler'i seçin.
    3. Proje Özellikleri iletişim kutusunda Ortak Özellikler'i ve ardından Genel'i seçin.

    Ağaç bölmesinde, Proje Klasörü özelliğini içeren listeyi görürsünüz. Bu genellikle uygulamanın kök dizinidir.

  2. Web Uygulaması proje klasöründe, yoksa bin adlı bir klasör oluşturun.

  3. Derlemenin .dll bu klasöre kopyalayın veya taşıyın. Artık uygulamanızın kök dizinindeki (veya alt klasörlerinden herhangi birinin) herhangi bir ASP.NET sayfasından denetimi kullanabilirsiniz.

Derlemeyi ASP.NET uygulama web formuna kaydetme

.NET programlama ortamında , Form.aspx kaynak penceresini açın ve kodun üstüne aşağıdaki etiketi ekleyin:

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

Yukarıdaki kodda:

  • Custom , ad alanıyla ilişkilendirdiğiniz bir diğer addır.
  • CustomControlNamespace , bir derleme sınıflarının içine eklendiği bir ad alanıdır.
  • CustomControl , uzantısı olmayan derleme dosyasının adıdır (.dll).

Kodunuzda, bu parametreleri derlemeniz için uygun adlarla değiştirin.

Şimdi derleme bir Web Formu'na kaydedilir. Bu kayıtlı derlemeyi seçilen adlarla ASP.NET kodunuzda kullanabilirsiniz. Örneğin, etiket şu olabilir:

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

Yukarıdaki etikette, Custom derlemenin ad alanı için seçilen addır, CustomControl özel sunucu denetim adıdır ve parameter 1parameter2 gerçek kodunuz temelinde değişen isteğe bağlı denetim özellikleridir.