LabelDesigner 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 Label kontrol server Web.
public ref class LabelDesigner : System::Web::UI::Design::TextControlDesigner
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
[System.Web.UI.Design.SupportsPreviewControl(true)]
public class LabelDesigner : System.Web.UI.Design.TextControlDesigner
type LabelDesigner = class
inherit TextControlDesigner
[<System.Web.UI.Design.SupportsPreviewControl(true)>]
type LabelDesigner = class
inherit TextControlDesigner
Public Class LabelDesigner
Inherits TextControlDesigner
- Warisan
- Atribut
Contoh
Contoh kode berikut menunjukkan cara mendapatkan SampleLabel
kontrol dari Label kontrol, dan menerapkan DesignerAttribute atribut pada SampleLabel
kontrol untuk mengaitkannya dengan SampleLabelDesigner
kelas .
Contoh kode juga berasal SampleLabelDesigner
dari LabelDesigner kelas . Ini mengambil alih GetDesignTimeHtml metode untuk mengatur BorderStyle properti ke Dashed, jika aslinya BorderStyle adalah NotSet nilai atau None . Ini meningkatkan visibilitas kontrol terkait pada waktu desain.
using System;
using System.Web;
using System.Web.UI.WebControls;
using System.Web.UI.Design.WebControls;
using System.ComponentModel;
using System.Security.Permissions;
namespace Examples.CS.WebControls.Design
{
// The SampleLabel is a copy of the Label.
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(Examples.CS.WebControls.Design.SampleLabelDesigner))]
public class SampleLabel : Label
{
} // SampleLabel
// Override members of the LabelDesigner.
public class SampleLabelDesigner : LabelDesigner
{
// Generate the design-time markup.
public override string GetDesignTimeHtml()
{
// Make the control more visible in the designer. If the border
// style is None or NotSet, change the border to a dashed line.
SampleLabel sampleLabel = (SampleLabel)Component;
string designTimeMarkup = null;
// Check if the border style should be changed.
if (sampleLabel.BorderStyle == BorderStyle.NotSet ||
sampleLabel.BorderStyle == BorderStyle.None)
{
BorderStyle oldBorderStyle = sampleLabel.BorderStyle;
try
{
// Set the design-time BorderStyle.
sampleLabel.BorderStyle = BorderStyle.Dashed;
// Call the base method to generate the markup.
designTimeMarkup = base.GetDesignTimeHtml();
}
catch (Exception ex)
{
// If an exception occurs, generate an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex);
}
finally
{
// Restore the BorderStyle to its original setting.
sampleLabel.BorderStyle = oldBorderStyle;
}
}
else
{
// Call the base method to generate the markup.
designTimeMarkup = base.GetDesignTimeHtml();
}
return designTimeMarkup;
} // GetDesignTimeHtml
} // SampleLabelDesigner
} // Examples.CS.WebControls.Design
Imports System.Web
Imports System.ComponentModel
Imports System.Web.UI.WebControls
Imports System.Web.UI.Design.WebControls
Imports System.Security.Permissions
Namespace Examples.VB.WebControls.Design
' The SampleLabel is a copy of the Label.
<AspNetHostingPermission(SecurityAction.Demand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, _
Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(Examples.VB.WebControls.Design.SampleLabelDesigner))> _
Public Class SampleLabel
Inherits Label
End Class
' Override members of the LabelDesigner.
Public Class SampleLabelDesigner
Inherits LabelDesigner
' Generate the design-time markup.
Public Overrides Function GetDesignTimeHtml() As String
' Make the control more visible in the designer. If the border
' style is None or NotSet, change the border to a dashed line.
Dim sampleLabel As SampleLabel = CType(Component, SampleLabel)
Dim designTimeMarkup As String = Nothing
' Check if the border style should be changed.
If (sampleLabel.BorderStyle = BorderStyle.NotSet Or _
sampleLabel.BorderStyle = BorderStyle.None) Then
Dim oldBorderStyle As BorderStyle = sampleLabel.BorderStyle
Try
' Set the design-time BorderStyle.
sampleLabel.BorderStyle = BorderStyle.Dashed
' Call the base method to generate the markup.
designTimeMarkup = MyBase.GetDesignTimeHtml()
Catch ex As Exception
' If an exception occurs, generate an error message.
designTimeMarkup = GetErrorDesignTimeHtml(ex)
Finally
' Restore the BorderStyle to its original setting.
sampleLabel.BorderStyle = oldBorderStyle
End Try
Else
' Call the base method to generate the markup.
designTimeMarkup = MyBase.GetDesignTimeHtml()
End If
Return designTimeMarkup
End Function ' GetDesignTimeHtml
End Class
End Namespace ' Examples.VB.WebControls.Design
Keterangan
Kontrol Label memungkinkan teks ditampilkan secara terprogram pada halaman Web.
Dalam desainer visual, saat Anda beralih dari tampilan Sumber ke Desain, kode sumber markup yang menjelaskan Label 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 LabelDesigner menyediakan dukungan waktu desain untuk Label kontrol.
Metode OnComponentChanged ini dipanggil ketika ada perubahan pada kontrol terkait Label .
Konstruktor
LabelDesigner() |
Menginisialisasi instans baru kelas LabelDesigner. |
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 Label 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 mewakili kontrol terkait pada waktu desain. (Diperoleh dari TextControlDesigner) |
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) |