HyperLinkDesigner Класс

Определение

Пространство имен:: System.Web.UI.Design.WebControls

Сборка:: System.Design.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет поддержку во время разработки в визуальном конструкторе HyperLink для элемента управления веб-сервера.

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

Наследование: Object

ComponentDesigner

HtmlControlDesigner

ControlDesigner

TextControlDesigner
HyperLinkDesigner

Атрибуты: SupportsPreviewControlAttribute

Примеры

В этом разделе содержатся два примера кода. Первый демонстрирует, как наследовать класс из HyperLinkDesigner класса, переопределить метод и указать значение свойства. Второй демонстрирует, как наследовать элемент управления от HyperLink элемента управления и применить атрибут к производном элементу управления.

В следующем примере кода показано, как наследовать CustomHyperLinkDesigner класс из HyperLinkDesigner класса. Он переопределяет GetDesignTimeHtml метод, чтобы указать значение по умолчанию для Text свойства, если исходное значение для Text него является пустой строкой (""). Это гарантирует, что связанный элемент управления будет отображаться во время разработки.

// 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

В следующем примере кода показано, как наследовать CustomHyperLink элемент управления и HyperLink применить DesignerAttribute атрибут к CustomHyperLink элементу управления, чтобы связать его с элементом 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

В визуальном конструкторе при переходе с исходного представления на конструктор исходный код разметки, описывающий HyperLink анализ элемента управления, создается версия элемента управления во время разработки на поверхности конструктора. При переходе к представлению источника элемент управления времени разработки сохраняется в исходном коде разметки и редактируется в разметку веб-страницы. Класс HyperLinkDesigner предоставляет поддержку времени разработки HyperLink для элемента управления.

Метод GetDesignTimeHtml возвращает разметку, которая используется для отрисовки связанного HyperLink элемента управления во время разработки. Метод OnComponentChanged вызывается при изменении связанного элемента управления.

Конструкторы

Имя	Описание
HyperLinkDesigner()	Инициализирует новый экземпляр класса HyperLinkDesigner.

Свойства

Имя	Описание
ActionLists	Возвращает коллекцию списков действий для конструктора элементов управления. (Унаследовано от ControlDesigner)
AllowResize	Возвращает значение, указывающее, можно ли изменить размер элемента управления в среде времени разработки. (Унаследовано от ControlDesigner)
AssociatedComponents	Возвращает коллекцию компонентов, связанных с компонентом, управляемым конструктором. (Унаследовано от ComponentDesigner)
AutoFormats	Возвращает коллекцию предопределенных схем автоматического форматирования, отображаемых в диалоговом окне автоформатирования для связанного элемента управления во время разработки. (Унаследовано от ControlDesigner)
Behavior	Устаревшие.. Возвращает или задает поведение DHTML, связанное с конструктором. (Унаследовано от HtmlControlDesigner)
Component	Возвращает компонент, который проектируется этим конструктором. (Унаследовано от ComponentDesigner)
DataBindings	Возвращает коллекцию привязок данных для текущего элемента управления. (Унаследовано от HtmlControlDesigner)
DataBindingsEnabled	Возвращает значение, указывающее, поддерживается ли привязка данных содержащим регионом для связанного элемента управления. (Унаследовано от ControlDesigner)
DesignerState	Возвращает объект, используемый для сохранения данных связанного элемента управления во время разработки. (Унаследовано от ControlDesigner)
DesignTimeElement	Устаревшие.. Возвращает объект времени разработки, представляющий элемент управления, связанный с HtmlControlDesigner объектом в области конструктора. (Унаследовано от HtmlControlDesigner)
DesignTimeElementView	Устаревшие.. Возвращает объект элемента управления представления для конструктора элементов управления. (Унаследовано от ControlDesigner)
DesignTimeHtmlRequiresLoadComplete	Устаревшие.. Возвращает значение, указывающее, должен ли узел конструктора завершить загрузку перед вызовом GetDesignTimeHtml метода. (Унаследовано от ControlDesigner)
Expressions	Возвращает привязки выражений для текущего элемента управления во время разработки. (Унаследовано от HtmlControlDesigner)
HidePropertiesInTemplateMode	Возвращает значение, указывающее, скрыты ли свойства связанного элемента управления, когда элемент управления находится в режиме шаблона. (Унаследовано от ControlDesigner)
ID	Возвращает или задает строку идентификатора для элемента управления. (Унаследовано от ControlDesigner)
InheritanceAttribute	Возвращает атрибут, указывающий тип наследования связанного компонента. (Унаследовано от ComponentDesigner)
Inherited	Возвращает значение, указывающее, наследуется ли этот компонент. (Унаследовано от ComponentDesigner)
InTemplateMode	Получает значение, указывающее, находится ли элемент управления в режиме просмотра или редактирования шаблона в узле конструктора. Свойство InTemplateMode доступно только для чтения. (Унаследовано от ControlDesigner)
IsDirty	Устаревшие.. Возвращает или задает значение, указывающее, помечен ли элемент управления веб-сервера как измененный. (Унаследовано от ControlDesigner)
ParentComponent	Возвращает родительский компонент для этого конструктора. (Унаследовано от ComponentDesigner)
ReadOnly	Устаревшие.. Возвращает или задает значение, указывающее, доступны ли свойства элемента управления только для чтения во время разработки. (Унаследовано от ControlDesigner)
RootDesigner	Возвращает конструктор элементов управления для страницы веб-форм, содержащей связанный элемент управления. (Унаследовано от ControlDesigner)
ShadowProperties	Возвращает коллекцию значений свойств, которые переопределяют параметры пользователя. (Унаследовано от ComponentDesigner)
ShouldCodeSerialize	Устаревшие.. Возвращает или задает значение, указывающее, следует ли создавать объявление поля для элемента управления в файле программной части текущего документа конструктора во время сериализации. (Унаследовано от HtmlControlDesigner)
Tag	Возвращает объект, представляющий элемент разметки HTML для связанного элемента управления. (Унаследовано от ControlDesigner)
TemplateGroups	Получает коллекцию групп шаблонов, каждая из которых содержит одно или несколько определений шаблонов. (Унаследовано от ControlDesigner)
UsePreviewControl	Возвращает значение, указывающее, использует ли конструктор элементов управления временный предварительный просмотр для создания разметки HTML во время разработки. (Унаследовано от ControlDesigner)
Verbs	Возвращает команды времени разработки, поддерживаемые компонентом, связанным с конструктором. (Унаследовано от ComponentDesigner)
ViewControl	Возвращает или задает элемент управления веб-сервера, который можно использовать для предварительного просмотра разметки HTML во время разработки. (Унаследовано от ControlDesigner)
ViewControlCreated	Возвращает или задает значение, указывающее, был ли `View` элемент управления создан для отображения на поверхности конструктора. (Унаследовано от ControlDesigner)
Visible	Возвращает значение, указывающее, отображается ли элемент управления во время разработки. (Унаследовано от ControlDesigner)

Методы

Имя	Описание
CreateErrorDesignTimeHtml(String, Exception)	Создает разметку HTML для отображения указанного сообщения об ошибке исключения во время разработки. (Унаследовано от ControlDesigner)
CreateErrorDesignTimeHtml(String)	Создает разметку HTML для отображения указанного сообщения об ошибке во время разработки. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml()	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления. (Унаследовано от ControlDesigner)
CreatePlaceHolderDesignTimeHtml(String)	Предоставляет простое прямоугольное представление заполнителя, отображающее тип и идентификатор элемента управления, а также дополнительные инструкции или сведения. (Унаследовано от ControlDesigner)
CreateViewControl()	Возвращает копию связанного элемента управления для просмотра или отрисовки на поверхности конструктора. (Унаследовано от ControlDesigner)
Dispose()	Освобождает все ресурсы, используемые параметром ComponentDesigner. (Унаследовано от ComponentDesigner)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые HtmlControlDesigner объектом, и при необходимости освобождает управляемые ресурсы. (Унаследовано от HtmlControlDesigner)
DoDefaultAction()	Создает сигнатуру метода в файле исходного кода для события по умолчанию компонента и перемещает курсор пользователя в это расположение. (Унаследовано от ComponentDesigner)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
GetBounds()	Извлекает координаты прямоугольника, представляющего границы элемента управления, отображаемого на поверхности конструктора. (Унаследовано от ControlDesigner)
GetDesignTimeHtml()	Получает разметку, которая используется для отрисовки связанного элемента управления во время разработки.
GetDesignTimeHtml(DesignerRegionCollection)	Извлекает разметку HTML для отображения элемента управления и заполняет коллекцию текущими областями конструктора элементов управления. (Унаследовано от ControlDesigner)
GetEditableDesignerRegionContent(EditableDesignerRegion)	Возвращает содержимое редактируемой области представления времени разработки связанного элемента управления. (Унаследовано от ControlDesigner)
GetEmptyDesignTimeHtml()	Извлекает разметку HTML для представления элемента управления веб-сервера во время разработки, которое не будет визуального представления во время выполнения. (Унаследовано от ControlDesigner)
GetErrorDesignTimeHtml(Exception)	Извлекает разметку HTML, которая предоставляет сведения об указанном исключении. (Унаследовано от ControlDesigner)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetPersistenceContent()	Извлекает сохраняемую внутреннюю разметку HTML элемента управления во время разработки. (Унаследовано от ControlDesigner)
GetPersistInnerHtml()	Возвращает разметку, сохраняемую для внутренних тегов элемента управления. (Унаследовано от TextControlDesigner)
GetService(Type)	Пытается получить указанный тип службы из сайта режима конструктора компонента конструктора. (Унаследовано от ComponentDesigner)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetViewRendering()	Извлекает объект, содержащий разметку времени разработки для содержимого и регионов связанного элемента управления. (Унаследовано от ControlDesigner)
Initialize(IComponent)	Инициализирует конструктор с указанным компонентом. (Унаследовано от TextControlDesigner)
InitializeExistingComponent(IDictionary)	Повторно инициализирует существующий компонент. (Унаследовано от ComponentDesigner)
InitializeNewComponent(IDictionary)	Инициализирует только что созданный компонент. (Унаследовано от ComponentDesigner)
InitializeNonDefault()	Устаревшие.. Устаревшие.. Инициализирует параметры импортированного компонента, который уже инициализирован для параметров, отличных от значений по умолчанию. (Унаследовано от ComponentDesigner)
Invalidate()	Отменяет всю область элемента управления, отображаемую на поверхности конструктора, и сообщает конструктору элементов управления перераскрыть элемент управления. (Унаследовано от ControlDesigner)
Invalidate(Rectangle)	Отменяет указанную область элемента управления, отображаемую на поверхности конструктора, и сообщает конструктору элементов управления перераскрыть элемент управления. (Унаследовано от ControlDesigner)
InvokeGetInheritanceAttribute(ComponentDesigner)	InheritanceAttribute Возвращает указанный ComponentDesignerобъект. (Унаследовано от ComponentDesigner)
IsPropertyBound(String)	Устаревшие.. Извлекает значение, указывающее, привязано ли указанное свойство связанного элемента управления. (Унаследовано от ControlDesigner)
Localize(IDesignTimeResourceWriter)	Использует предоставленный модуль записи ресурсов для сохранения локализованных свойств связанного элемента управления с ресурсом в узле конструктора. (Унаследовано от ControlDesigner)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
OnAutoFormatApplied(DesignerAutoFormat)	Вызывается при применении предопределенной схемы автоматического форматирования к связанному элементу управления. (Унаследовано от ControlDesigner)
OnBehaviorAttached()	Вызывается при присоединении конструктора элементов управления к объекту Behavior. (Унаследовано от ControlDesigner)
OnBehaviorDetaching()	Устаревшие.. Вызывается, когда поведение отсоединяется от элемента. (Унаследовано от HtmlControlDesigner)
OnBindingsCollectionChanged(String)	Устаревшие.. Вызывается при изменении коллекции привязки данных. (Унаследовано от ControlDesigner)
OnClick(DesignerRegionMouseEventArgs)	Вызывается узлом конструктора, когда пользователь щелкает связанный элемент управления во время разработки. (Унаследовано от ControlDesigner)
OnComponentChanged(Object, ComponentChangedEventArgs)	Вызывается при изменении связанного элемента управления.
OnComponentChanged(Object, ComponentChangedEventArgs)	Вызывается при изменении связанного элемента управления. (Унаследовано от ControlDesigner)
OnComponentChanging(Object, ComponentChangingEventArgs)	Представляет метод, который будет обрабатывать ComponentChanging событие для связанного элемента управления. (Унаследовано от ControlDesigner)
OnControlResize()	Устаревшие.. Вызывается при изменении размера связанного веб-сервера в узле конструктора во время разработки. (Унаследовано от ControlDesigner)
OnPaint(PaintEventArgs)	Вызывается, когда конструктор элементов управления рисует связанный элемент управления на поверхности конструктора, если CustomPaint значение равно `true`. (Унаследовано от ControlDesigner)
OnSetComponentDefaults()	Устаревшие.. Устаревшие.. Задает свойства по умолчанию для компонента. (Унаследовано от ComponentDesigner)
OnSetParent()	Предоставляет способ выполнения дополнительной обработки при присоединении связанного элемента управления к родительскому элементу управления. (Унаследовано от HtmlControlDesigner)
PostFilterAttributes(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора атрибутов, предоставляемых через объект TypeDescriptor. (Унаследовано от ComponentDesigner)
PostFilterEvents(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора событий, предоставляемых через TypeDescriptorобъект. (Унаследовано от ComponentDesigner)
PostFilterProperties(IDictionary)	Позволяет конструктору изменять или удалять элементы из набора свойств, предоставляемых через объект TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterAttributes(IDictionary)	Позволяет конструктору добавлять в набор атрибутов, предоставляемых с помощью TypeDescriptor. (Унаследовано от ComponentDesigner)
PreFilterEvents(IDictionary)	Задает список событий, предоставляемых во время разработки для TypeDescriptor объекта компонента. (Унаследовано от HtmlControlDesigner)
PreFilterProperties(IDictionary)	Добавляет свойства в сетку свойств в узле конструктора или удаляет их во время разработки или предоставляет новые свойства времени разработки, которые могут соответствовать свойствам связанного элемента управления. (Унаследовано от ControlDesigner)
RaiseComponentChanged(MemberDescriptor, Object, Object)	Уведомляет об IComponentChangeService изменении этого компонента. (Унаследовано от ComponentDesigner)
RaiseComponentChanging(MemberDescriptor)	Уведомляет IComponentChangeService об изменении этого компонента. (Унаследовано от ComponentDesigner)
RaiseResizeEvent()	Устаревшие.. Вызывает событие OnControlResize(). (Унаследовано от ControlDesigner)
RegisterClone(Object, Object)	Регистрирует внутренние данные в клонируемом элементе управления. (Унаследовано от ControlDesigner)
SetEditableDesignerRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области элемента управления во время разработки. (Унаследовано от ControlDesigner)
SetRegionContent(EditableDesignerRegion, String)	Указывает содержимое редактируемой области в представлении времени разработки элемента управления. (Унаследовано от ControlDesigner)
SetViewFlags(ViewFlags, Boolean)	Назначает указанное побитовое ViewFlags перечисление указанному значению флага. (Унаследовано от ControlDesigner)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
UpdateDesignTimeHtml()	Обновляет разметку HTML во время разработки для связанного веб-сервера, вызывая GetDesignTimeHtml метод. (Унаследовано от ControlDesigner)

Явные реализации интерфейса

Имя	Описание
IDesignerFilter.PostFilterAttributes(IDictionary)	Описание этого элемента см. в описании PostFilterAttributes(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterEvents(IDictionary)	Описание этого элемента см. в описании PostFilterEvents(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PostFilterProperties(IDictionary)	Описание этого элемента см. в описании PostFilterProperties(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterAttributes(IDictionary)	Описание этого элемента см. в описании PreFilterAttributes(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterEvents(IDictionary)	Описание этого элемента см. в описании PreFilterEvents(IDictionary) метода. (Унаследовано от ComponentDesigner)
IDesignerFilter.PreFilterProperties(IDictionary)	Описание этого элемента см. в описании PreFilterProperties(IDictionary) метода. (Унаследовано от ComponentDesigner)
ITreeDesigner.Children	Описание этого элемента см. в свойстве Children . (Унаследовано от ComponentDesigner)
ITreeDesigner.Parent	Описание этого элемента см. в свойстве Parent . (Унаследовано от ComponentDesigner)

Применяется к

См. также раздел

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через