HyperLinkDesigner Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
Menyediakan dukungan waktu desain dalam desainer visual untuk HyperLink kontrol server Web.
public ref class HyperLinkDesigner : System::Web::UI::Design::TextControlDesigner
public class HyperLinkDesigner : System.Web.UI.Design.TextControlDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class HyperLinkDesigner : System.Web.UI.Design.TextControlDesigner
type HyperLinkDesigner = class
inherit TextControlDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type HyperLinkDesigner = class
inherit TextControlDesigner
Public Class HyperLinkDesigner
Inherits TextControlDesigner
- Warisan
- Atribut
Contoh
Bagian ini berisi dua contoh kode. Yang pertama menunjukkan cara memperoleh kelas dari HyperLinkDesigner kelas, mengambil alih metode, dan menyediakan nilai properti. Yang kedua menunjukkan cara mendapatkan kontrol dari HyperLink kontrol dan menerapkan atribut pada kontrol turunan.
Contoh kode berikut menunjukkan cara memperoleh CustomHyperLinkDesigner
kelas dari HyperLinkDesigner kelas . Ini mengambil alih GetDesignTimeHtml metode untuk menyediakan nilai default untuk Text properti jika nilai asli untuk Text adalah string kosong (""). Ini memastikan bahwa kontrol terkait akan terlihat pada waktu desain.
// Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
public class CustomHyperLinkDesigner : HyperLinkDesigner
{
// Override the GetDesignTimeHtml to set the CustomHyperLink Text
// property so that it displays at design time.
public override string GetDesignTimeHtml()
{
CustomHyperLink hype = (CustomHyperLink)Component;
string designTimeMarkup = null;
// Save the original Text and note if it is empty.
string text = hype.Text;
bool noText = (text.Trim().Length == 0);
try
{
// If the Text is empty, supply a default value.
if (noText)
hype.Text = "Click here.";
// Call the base method to generate the markup.
designTimeMarkup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
// If an error occurs, generate the markup for an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the original value of the Text, if necessary.
if (noText)
hype.Text = text;
}
// If the markup is empty, generate the markup for a placeholder.
if(designTimeMarkup == null || designTimeMarkup.Length == 0)
designTimeMarkup = GetEmptyDesignTimeHtml();
return designTimeMarkup;
} // GetDesignTimeHtml
} // CustomHyperLinkDesigner
' Derive the CustomHyperLinkDesigner from the HyperLinkDesigner.
Public Class CustomHyperLinkDesigner
Inherits HyperLinkDesigner
' Override the GetDesignTimeHtml to set the CustomHyperLink Text
' property so that it displays at design time.
Public Overrides Function GetDesignTimeHtml() As String
Dim hype As CustomHyperLink = CType(Component, CustomHyperLink)
Dim designTimeMarkup As String = Nothing
' Save the original Text and note if it is empty.
Dim text As String = hype.Text
Dim noText As Boolean = (text.Trim().Length = 0)
Try
' If the Text is empty, supply a default value.
If noText Then
hype.Text = "Click here."
End If
' Call the base method to generate the markup.
designTimeMarkup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
' If an error occurs, generate the markup for an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the original value of the Text, if necessary.
If noText Then
hype.Text = text
End If
End Try
' If the markup is empty, generate the markup for a placeholder.
If ((designTimeMarkup = Nothing) Or _
(designTimeMarkup.Length = 0)) Then
designTimeMarkup = GetEmptyDesignTimeHtml()
End If
Return designTimeMarkup
End Function ' GetDesignTimeHtml
End Class
Contoh kode berikut menunjukkan cara mendapatkan CustomHyperLink
kontrol dari HyperLink kontrol dan menerapkan DesignerAttribute atribut pada CustomHyperLink
kontrol untuk mengaitkannya dengan CustomHyperLinkDesigner
.
using System.Web;
using System.Web.UI.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The CustomHyperLink is a copy of the HyperLink.
// It uses the CustomHyperLinkDesigner for design-time support.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.
CustomHyperLinkDesigner))]
public class CustomHyperLink : HyperLink
{
} // CustomHyperLink
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The CustomHyperLink is a copy of the HyperLink.
' It uses the CustomHyperLinkDesigner for design-time support.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design. _
CustomHyperLinkDesigner))> _
Public Class CustomHyperLink
Inherits HyperLink
End Class
End Namespace ' Examples.VB.WebControls.Design
Keterangan
Kontrol HyperLink membuat tautan untuk browser klien untuk menavigasi ke halaman Web lain.
Dalam desainer visual, saat Anda beralih dari tampilan Sumber ke Desain, kode sumber markup yang menjelaskan HyperLink kontrol diurai dan versi waktu desain kontrol dibuat pada permukaan desain. Saat Anda beralih kembali ke tampilan Sumber, kontrol waktu desain dipertahankan ke kode sumber markup dan diedit ke markup untuk halaman Web. Kelas ini HyperLinkDesigner menyediakan dukungan waktu desain untuk HyperLink kontrol.
Metode mengembalikan GetDesignTimeHtml markup yang digunakan untuk merender kontrol terkait HyperLink pada waktu desain. Metode OnComponentChanged ini dipanggil ketika ada perubahan pada kontrol terkait.
Konstruktor
HyperLinkDesigner() |
Menginisialisasi instans baru kelas HyperLinkDesigner. |
Properti
ActionLists |
Mendapatkan kumpulan daftar tindakan untuk perancang kontrol. (Diperoleh dari ControlDesigner) |
AllowResize |
Mendapatkan nilai yang menunjukkan apakah kontrol dapat diubah ukurannya di lingkungan waktu desain. (Diperoleh dari ControlDesigner) |
AssociatedComponents |
Mendapatkan koleksi komponen yang terkait dengan komponen yang dikelola oleh perancang. (Diperoleh dari ComponentDesigner) |
AutoFormats |
Mendapatkan kumpulan skema pemformatan otomatis yang telah ditentukan sebelumnya untuk ditampilkan dalam kotak dialog Format Otomatis untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
Behavior |
Kedaluwarsa.
Mendapatkan atau mengatur perilaku DHTML yang terkait dengan perancang. (Diperoleh dari HtmlControlDesigner) |
Component |
Mendapatkan komponen yang didesain desainer ini. (Diperoleh dari ComponentDesigner) |
DataBindings |
Mendapatkan pengumpulan pengikatan data untuk kontrol saat ini. (Diperoleh dari HtmlControlDesigner) |
DataBindingsEnabled |
Mendapatkan nilai yang menunjukkan apakah pengikatan data didukung oleh wilayah yang berisi untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
DesignerState |
Mendapatkan objek yang digunakan untuk mempertahankan data untuk kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
DesignTimeElement |
Kedaluwarsa.
Mendapatkan objek waktu desain yang mewakili kontrol yang terkait dengan HtmlControlDesigner objek pada permukaan desain. (Diperoleh dari HtmlControlDesigner) |
DesignTimeElementView |
Kedaluwarsa.
Mendapatkan objek kontrol tampilan untuk perancang kontrol. (Diperoleh dari ControlDesigner) |
DesignTimeHtmlRequiresLoadComplete |
Kedaluwarsa.
Mendapatkan nilai yang menunjukkan apakah host desain harus menyelesaikan pemuatan sebelum GetDesignTimeHtml metode dapat dipanggil. (Diperoleh dari ControlDesigner) |
Expressions |
Mendapatkan pengikatan ekspresi untuk kontrol saat ini pada waktu desain. (Diperoleh dari HtmlControlDesigner) |
HidePropertiesInTemplateMode |
Mendapatkan nilai yang menunjukkan apakah properti kontrol terkait disembunyikan saat kontrol berada dalam mode templat. (Diperoleh dari ControlDesigner) |
ID |
Mendapatkan atau mengatur string ID untuk kontrol. (Diperoleh dari ControlDesigner) |
InheritanceAttribute |
Mendapatkan atribut yang menunjukkan jenis pewarisan komponen terkait. (Diperoleh dari ComponentDesigner) |
Inherited |
Mendapatkan nilai yang menunjukkan apakah komponen ini diwariskan. (Diperoleh dari ComponentDesigner) |
InTemplateMode |
Mendapatkan nilai yang menunjukkan apakah kontrol berada dalam mode tampilan templat atau pengeditan di host desain. Properti InTemplateMode bersifat baca-saja. (Diperoleh dari ControlDesigner) |
IsDirty |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah kontrol server Web telah ditandai sebagai diubah. (Diperoleh dari ControlDesigner) |
ParentComponent |
Mendapatkan komponen induk untuk perancang ini. (Diperoleh dari ComponentDesigner) |
ReadOnly |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah properti kontrol bersifat baca-saja pada waktu desain. (Diperoleh dari ControlDesigner) |
RootDesigner |
Mendapatkan perancang kontrol untuk halaman Formulir Web yang berisi kontrol terkait. (Diperoleh dari ControlDesigner) |
SetTextualDefaultProperty |
Menyediakan dukungan waktu desain dalam desainer visual untuk HyperLink kontrol server Web. (Diperoleh dari ComponentDesigner) |
ShadowProperties |
Mendapatkan kumpulan nilai properti yang mengambil alih pengaturan pengguna. (Diperoleh dari ComponentDesigner) |
ShouldCodeSerialize |
Kedaluwarsa.
Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan membuat deklarasi bidang untuk kontrol dalam file code-behind untuk dokumen desain saat ini selama serialisasi. (Diperoleh dari HtmlControlDesigner) |
Tag |
Mendapatkan objek yang mewakili elemen markup HTML untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
TemplateGroups |
Mendapatkan kumpulan grup templat, masing-masing berisi satu atau beberapa definisi templat. (Diperoleh dari ControlDesigner) |
UsePreviewControl |
Mendapatkan nilai yang menunjukkan apakah perancang kontrol menggunakan kontrol pratinjau sementara untuk menghasilkan markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
Verbs |
Mendapatkan kata kerja waktu desain yang didukung oleh komponen yang terkait dengan perancang. (Diperoleh dari ComponentDesigner) |
ViewControl |
Mendapatkan atau mengatur kontrol server Web yang dapat digunakan untuk mempratinjau markup HTML waktu desain. (Diperoleh dari ControlDesigner) |
ViewControlCreated |
Mendapatkan atau mengatur nilai yang menunjukkan apakah |
Visible |
Mendapatkan nilai yang menunjukkan apakah kontrol terlihat pada waktu desain. (Diperoleh dari ControlDesigner) |
Metode
CreateErrorDesignTimeHtml(String) |
Membuat markup HTML untuk menampilkan pesan kesalahan tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
CreateErrorDesignTimeHtml(String, Exception) |
Membuat markup HTML untuk menampilkan pesan kesalahan pengecualian tertentu pada waktu desain. (Diperoleh dari ControlDesigner) |
CreatePlaceHolderDesignTimeHtml() |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol. (Diperoleh dari ControlDesigner) |
CreatePlaceHolderDesignTimeHtml(String) |
Menyediakan representasi tempat penampung persegi panjang sederhana yang menampilkan jenis dan ID kontrol, dan juga instruksi atau informasi tambahan yang ditentukan. (Diperoleh dari ControlDesigner) |
CreateViewControl() |
Mengembalikan salinan kontrol terkait untuk menampilkan atau merender pada permukaan desain. (Diperoleh dari ControlDesigner) |
Dispose() |
Merilis semua sumber daya yang ComponentDesignerdigunakan oleh . (Diperoleh dari ComponentDesigner) |
Dispose(Boolean) |
Merilis sumber daya tidak terkelola yang digunakan oleh HtmlControlDesigner objek dan secara opsional merilis sumber daya terkelola. (Diperoleh dari HtmlControlDesigner) |
DoDefaultAction() |
Membuat tanda tangan metode dalam file kode sumber untuk peristiwa default pada komponen dan menavigasi kursor pengguna ke lokasi tersebut. (Diperoleh dari ComponentDesigner) |
Equals(Object) |
Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object) |
GetBounds() |
Mengambil koordinat persegi panjang yang mewakili batas untuk kontrol seperti yang ditampilkan pada permukaan desain. (Diperoleh dari ControlDesigner) |
GetDesignTimeHtml() |
Mendapatkan markup yang digunakan untuk merender kontrol terkait pada waktu desain. |
GetDesignTimeHtml(DesignerRegionCollection) |
Mengambil markup HTML untuk menampilkan kontrol dan mengisi koleksi dengan wilayah perancang kontrol saat ini. (Diperoleh dari ControlDesigner) |
GetEditableDesignerRegionContent(EditableDesignerRegion) |
Mengembalikan konten untuk wilayah yang dapat diedit dari tampilan waktu desain kontrol terkait. (Diperoleh dari ControlDesigner) |
GetEmptyDesignTimeHtml() |
Mengambil markup HTML untuk mewakili kontrol server Web pada waktu desain yang tidak akan memiliki representasi visual pada durasi. (Diperoleh dari ControlDesigner) |
GetErrorDesignTimeHtml(Exception) |
Mengambil markup HTML yang menyediakan informasi tentang pengecualian yang ditentukan. (Diperoleh dari ControlDesigner) |
GetHashCode() |
Berfungsi sebagai fungsi hash default. (Diperoleh dari Object) |
GetPersistenceContent() |
Mengambil markup HTML dalam yang dapat dipertahankan dari kontrol pada waktu desain. (Diperoleh dari ControlDesigner) |
GetPersistInnerHtml() |
Mendapatkan markup untuk mempertahankan tag dalam kontrol. (Diperoleh dari TextControlDesigner) |
GetService(Type) |
Upaya untuk mengambil jenis layanan yang ditentukan dari situs mode desain komponen perancang. (Diperoleh dari ComponentDesigner) |
GetType() |
Mendapatkan dari instans Type saat ini. (Diperoleh dari Object) |
GetViewRendering() |
Mengambil objek yang berisi markup waktu desain untuk konten dan wilayah kontrol terkait. (Diperoleh dari ControlDesigner) |
Initialize(IComponent) |
Menginisialisasi perancang dengan komponen yang ditentukan. (Diperoleh dari TextControlDesigner) |
InitializeExistingComponent(IDictionary) |
Menginisialisasi ulang komponen yang ada. (Diperoleh dari ComponentDesigner) |
InitializeNewComponent(IDictionary) |
Menginisialisasi komponen yang baru dibuat. (Diperoleh dari ComponentDesigner) |
InitializeNonDefault() |
Kedaluwarsa.
Kedaluwarsa.
Menginisialisasi pengaturan untuk komponen impor yang sudah diinisialisasi ke pengaturan selain default. (Diperoleh dari ComponentDesigner) |
Invalidate() |
Membatalkan seluruh area kontrol yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
Invalidate(Rectangle) |
Membatalkan area kontrol yang ditentukan yang ditampilkan pada permukaan desain dan memberi sinyal kepada perancang kontrol untuk menggambar ulang kontrol. (Diperoleh dari ControlDesigner) |
InvokeGetInheritanceAttribute(ComponentDesigner) |
InheritanceAttribute Mendapatkan dari yang ditentukanComponentDesigner. (Diperoleh dari ComponentDesigner) |
IsPropertyBound(String) |
Kedaluwarsa.
Mengambil nilai yang menunjukkan apakah properti yang ditentukan pada kontrol terkait terikat dengan data. (Diperoleh dari ControlDesigner) |
Localize(IDesignTimeResourceWriter) |
Menggunakan penulis sumber daya yang disediakan untuk mempertahankan properti yang dapat dilokalkan dari kontrol terkait ke sumber daya di host desain. (Diperoleh dari ControlDesigner) |
MemberwiseClone() |
Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object) |
OnAutoFormatApplied(DesignerAutoFormat) |
Dipanggil ketika skema pemformatan otomatis yang telah ditentukan sebelumnya telah diterapkan ke kontrol terkait. (Diperoleh dari ControlDesigner) |
OnBehaviorAttached() |
Dipanggil ketika perancang kontrol dilampirkan ke objek Perilaku. (Diperoleh dari ControlDesigner) |
OnBehaviorDetaching() |
Kedaluwarsa.
Dipanggil ketika perilaku memisahkan diri dari elemen . (Diperoleh dari HtmlControlDesigner) |
OnBindingsCollectionChanged(String) |
Kedaluwarsa.
Dipanggil saat pengumpulan pengikatan data berubah. (Diperoleh dari ControlDesigner) |
OnClick(DesignerRegionMouseEventArgs) |
Dipanggil oleh host desain saat pengguna mengklik kontrol terkait pada waktu desain. (Diperoleh dari ControlDesigner) |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Dipanggil ketika ada perubahan pada kontrol terkait. |
OnComponentChanged(Object, ComponentChangedEventArgs) |
Dipanggil ketika kontrol terkait berubah. (Diperoleh dari ControlDesigner) |
OnComponentChanging(Object, ComponentChangingEventArgs) |
Mewakili metode yang akan menangani ComponentChanging peristiwa untuk kontrol terkait. (Diperoleh dari ControlDesigner) |
OnControlResize() |
Kedaluwarsa.
Dipanggil ketika kontrol server Web terkait telah diubah ukurannya di host desain pada waktu desain. (Diperoleh dari ControlDesigner) |
OnPaint(PaintEventArgs) |
Dipanggil ketika perancang kontrol menggambar kontrol terkait pada permukaan desain, jika CustomPaint nilainya adalah |
OnSetComponentDefaults() |
Kedaluwarsa.
Kedaluwarsa.
Mengatur properti default untuk komponen. (Diperoleh dari ComponentDesigner) |
OnSetParent() |
Menyediakan cara untuk melakukan pemrosesan tambahan ketika kontrol terkait dilampirkan ke kontrol induk. (Diperoleh dari HtmlControlDesigner) |
PostFilterAttributes(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
PostFilterEvents(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari serangkaian peristiwa yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
PostFilterProperties(IDictionary) |
Memungkinkan perancang untuk mengubah atau menghapus item dari sekumpulan properti yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
PreFilterAttributes(IDictionary) |
Memungkinkan perancang untuk menambahkan ke sekumpulan atribut yang diekspos melalui TypeDescriptor. (Diperoleh dari ComponentDesigner) |
PreFilterEvents(IDictionary) |
Mengatur daftar peristiwa yang diekspos pada waktu desain untuk TypeDescriptor objek untuk komponen. (Diperoleh dari HtmlControlDesigner) |
PreFilterProperties(IDictionary) |
Menambahkan properti ke atau menghapus properti dari kisi Properti di host desain pada waktu desain atau menyediakan properti waktu desain baru yang mungkin sesuai dengan properti pada kontrol terkait. (Diperoleh dari ControlDesigner) |
RaiseComponentChanged(MemberDescriptor, Object, Object) |
Memberi tahu IComponentChangeService bahwa komponen ini telah diubah. (Diperoleh dari ComponentDesigner) |
RaiseComponentChanging(MemberDescriptor) |
Memberi tahu IComponentChangeService bahwa komponen ini akan diubah. (Diperoleh dari ComponentDesigner) |
RaiseResizeEvent() |
Kedaluwarsa.
Memunculkan kejadian OnControlResize(). (Diperoleh dari ControlDesigner) |
RegisterClone(Object, Object) |
Mendaftarkan data internal dalam kontrol kloning. (Diperoleh dari ControlDesigner) |
SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
Menentukan konten untuk wilayah kontrol yang dapat diedit pada waktu desain. (Diperoleh dari ControlDesigner) |
SetRegionContent(EditableDesignerRegion, String) |
Menentukan konten untuk wilayah yang dapat diedit dalam tampilan waktu desain kontrol. (Diperoleh dari ControlDesigner) |
SetViewFlags(ViewFlags, Boolean) |
Menetapkan enumerasi bitwise ViewFlags yang ditentukan ke nilai bendera yang ditentukan. (Diperoleh dari ControlDesigner) |
ToString() |
Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object) |
UpdateDesignTimeHtml() |
Menyegarkan markup HTML waktu desain untuk kontrol server Web terkait dengan memanggil GetDesignTimeHtml metode . (Diperoleh dari ControlDesigner) |