HtmlSelectBuilder Klasa

Definicja

Namespace:: System.Web.UI.HtmlControls

Montaż:: System.Web.dll

Ważny

Niektóre informacje dotyczą produktów przedpremierowych, które mogą zostać znacznie zmodyfikowane przed premierą. Microsoft nie udziela żadnych gwarancji, ani wyraźnych, ani domniemanych, dotyczących informacji podanych tutaj.

Wchodzi w interakcję z analizatorem w celu utworzenia kontrolki HtmlSelect .

public ref class HtmlSelectBuilder : System::Web::UI::ControlBuilder

public class HtmlSelectBuilder : System.Web.UI.ControlBuilder

type HtmlSelectBuilder = class
    inherit ControlBuilder

Public Class HtmlSelectBuilder
Inherits ControlBuilder

Dziedziczenie: Object

ControlBuilder
HtmlSelectBuilder

Przykłady

W poniższym przykładzie kodu pokazano, jak utworzyć kontrolkę niestandardową, która definiuje dwa typy <option> elementów podrzędnych kontrolki niestandardowej HtmlSelectBuilder HtmlSelect, a następnie przetwarza każdy typ inaczej.

<%@ Page Language="C#"%>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.CS.Controls" Assembly="Samples.AspNet.CS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlSelectBuilder Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
      <h3>HtmlSelectBuilder Example</h3>

      <aspSample:CustomHtmlSelect
       id="customhtmlselect1"
       runat="server">
      <aspSample:MyOption1 optionid="option1" value="1" text="item 1"/>
      <aspSample:MyOption1 optionid="option2" value="2" text="item 2"/>
      <aspSample:MyOption2 optionid="option3" value="3" text="item 3"/>
      <aspSample:MyOption2 optionid="option4" value="4" text="item 4"/>
      </aspSample:CustomHtmlSelect>

    </form>

  </body>

</html>

<%@ Page Language="VB"%>
<%@ Register TagPrefix="aspSample" Namespace="Samples.AspNet.VB.Controls" Assembly="Samples.AspNet.VB" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>HtmlSelectBuilder Example</title>
</head>
  <body>
    <form id="Form1" runat="server">
      <h3>HtmlSelectBuilder Example</h3>

      <aspSample:CustomHtmlSelect
       id="customhtmlselect1"
       runat="server">
      <aspSample:MyOption1 optionid="option1" value="1" text="item 1"/>
      <aspSample:MyOption1 optionid="option2" value="2" text="item 2"/>
      <aspSample:MyOption2 optionid="option3" value="3" text="item 3"/>
      <aspSample:MyOption2 optionid="option4" value="4" text="item 4"/>
      </aspSample:CustomHtmlSelect>

    </form>

  </body>

</html>

using System;
using System.Security.Permissions;
using System.Collections;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;

namespace Samples.AspNet.CS.Controls
{
        // Define a type of child control for the custom HtmlSelect control.
    public class MyOption1
    {
        string _id;
        string _value;
        string _text;

        public string optionid
        {
            get
            { return _id; }
            set
            { _id = value; }
        }

        public string value
        {
            get
            { return _value; }
            set
            { _value = value; }
        }

        public string text
        {
            get
            { return _text; }
            set
            { _text = value; }
        }
    }

       // Define a type of child control for the custom HtmlSelect control.
    public class MyOption2
    {
        string _id;
        string _value;
        string _text;

        public string optionid
        {
            get
            { return _id; }
            set
            { _id = value; }
        }

        public string value
        {
            get
            { return _value; }
            set
            { _value = value; }
        }

        public string text
        {
            get
            { return _text; }
            set
            { _text = value; }
        }
    }

    // Define a custom HtmlSelectBuilder control.
    public class MyHtmlSelectBuilder : HtmlSelectBuilder
    {
        [AspNetHostingPermission(SecurityAction.Demand, Level = AspNetHostingPermissionLevel.Minimal)]
        public override Type GetChildControlType(string tagName, IDictionary attribs)
        {
            // Distinguish between two possible types of child controls.
            if (tagName.ToLower().EndsWith("myoption1"))
            {
                return typeof(MyOption1);
            }
            else if (tagName.ToLower().EndsWith("myoption2"))
            {
                return typeof(MyOption2);
            }
            return null;
        }
    }

    [ControlBuilderAttribute(typeof(MyHtmlSelectBuilder))]
    public class CustomHtmlSelect : HtmlSelect
    {
        
        // Override AddParsedSubObject to treat the two types
        // of child controls differently.
        protected override void AddParsedSubObject(object obj)
        {
            string _outputtext;
            if (obj is MyOption1)
            {
                _outputtext = "option group 1: " + ((MyOption1)obj).text;
                ListItem li = new ListItem(_outputtext, ((MyOption1)obj).value);
                base.Items.Add(li);
            }
            if (obj is MyOption2)
            {
                _outputtext = "option group 2: " + ((MyOption2)obj).text;
                ListItem li = new ListItem(_outputtext, ((MyOption2)obj).value);
                base.Items.Add(li);
            }
        }
    }
}

Imports System.Security.Permissions
Imports System.Collections
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Web.UI.HtmlControls

Namespace Samples.AspNet.VB.Controls
    ' Define a type of child control for the custom HtmlSelect control.
    Public Class MyOption1
        Private _id As String
        Private _value As String
        Private _text As String


        Public Property optionid() As String
            Get
                Return _id
            End Get
            Set(ByVal value As String)
                _id = value
            End Set
        End Property

        Public Property value() As String
            Get
                Return _value
            End Get
            Set(ByVal value As String)
                _value = value
            End Set
        End Property

        Public Property [text]() As String
            Get
                Return _text
            End Get
            Set(ByVal value As String)
                _text = value
            End Set
        End Property
    End Class 

    ' Define a type of child control for the custom HtmlSelect control.
    Public Class MyOption2
        Private _id As String
        Private _value As String
        Private _text As String


        Public Property optionid() As String
            Get
                Return _id
            End Get
            Set(ByVal value As String)
                _id = value
            End Set
        End Property

        Public Property value() As String
            Get
                Return _value
            End Get
            Set(ByVal value As String)
                _value = value
            End Set
        End Property

        Public Property [text]() As String
            Get
                Return _text
            End Get
            Set(ByVal value As String)
                _text = value
            End Set
        End Property
    End Class 

    ' Define a custom HtmlSelectBuilder control.
    Public Class MyHtmlSelectBuilder
        Inherits HtmlSelectBuilder

        <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
        Public Overrides Function GetChildControlType(ByVal tagName As String, ByVal attribs As IDictionary) As Type

            ' Distinguish between two possible types of child controls.
            If tagName.ToLower().EndsWith("myoption1") Then
                Return GetType(MyOption1)
            ElseIf tagName.ToLower().EndsWith("myoption2") Then
                Return GetType(MyOption2)
            End If
            Return Nothing

        End Function 
    End Class 

    <ControlBuilderAttribute(GetType(MyHtmlSelectBuilder))> _
    Public Class CustomHtmlSelect
        Inherits HtmlSelect

        ' Override AddParsedSubObject to treat the two types
        ' of child controls differently.
        Protected Overrides Sub AddParsedSubObject(ByVal obj As Object)
            Dim _outputtext As String
            If TypeOf obj Is MyOption1 Then
                _outputtext = "option group 1: " + CType(obj, MyOption1).text
                Dim li As New ListItem(_outputtext, CType(obj, MyOption1).value)
                MyBase.Items.Add(li)
            End If
            If TypeOf obj Is MyOption2 Then
                _outputtext = "option group 2: " + CType(obj, MyOption2).text
                Dim li As New ListItem(_outputtext, CType(obj, MyOption2).value)
                MyBase.Items.Add(li)
            End If

        End Sub 
    End Class 
End Namespace

Uwagi

Kontrolka HtmlSelectBuilder współdziała z analizatorem strony w celu utworzenia kontrolki HtmlSelect . Użyj kontrolki, HtmlSelectBuilder aby dostosować analizowanie kontrolki HtmlSelect .

Właściwość jest ustawiona AllowWhitespaceLiterals tak false , aby odstęp był zawsze ignorowany. GetChildControlType Użyj metody , aby określić typ kontrolek podrzędnych HtmlSelect kontrolki.

Notatki dla spadkobierców

Aby utworzyć niestandardowego konstruktora kontrolek dla kontrolki HtmlSelect , musisz dziedziczyć z tej klasy.

Konstruktorów

Nazwa	Opis
HtmlSelectBuilder()	Inicjuje nowe wystąpienie klasy HtmlSelectBuilder.

Właściwości

Nazwa	Opis
BindingContainerBuilder	Pobiera konstruktora kontrolek, który odpowiada kontenerowi powiązania dla kontrolki tworzonej przez tego konstruktora. (Dziedziczone od ControlBuilder)
BindingContainerType	Pobiera typ kontenera powiązania dla kontrolki tworzonej przez tego konstruktora. (Dziedziczone od ControlBuilder)
ComplexPropertyEntries	Pobiera kolekcję złożonych wpisów właściwości. (Dziedziczone od ControlBuilder)
ControlType	Pobiera kontrolkę Type do utworzenia. (Dziedziczone od ControlBuilder)
CurrentFilterResolutionService	IFilterResolutionService Pobiera obiekt używany do zarządzania usługami powiązanymi z filtrowaniem urządzeń podczas analizowania i utrwalania kontrolek w projektancie. (Dziedziczone od ControlBuilder)
DeclareType	Pobiera typ, który będzie używany przez generowanie kodu w celu zadeklarowania kontrolki. (Dziedziczone od ControlBuilder)
FChildrenAsProperties	Pobiera wartość określającą, czy kontrolka ma wartość z ustawioną wartością ParseChildrenAttribute ChildrenAsProperties`true`. (Dziedziczone od ControlBuilder)
FIsNonParserAccessor	Pobiera wartość określającą, czy kontrolka implementuje IParserAccessor interfejs. (Dziedziczone od ControlBuilder)
HasAspCode	Pobiera wartość wskazującą, czy kontrolka zawiera jakiekolwiek bloki kodu. (Dziedziczone od ControlBuilder)
ID	Pobiera lub ustawia właściwość identyfikatora kontrolki do skompilowania. (Dziedziczone od ControlBuilder)
InDesigner	Zwraca, ControlBuilder czy element jest uruchomiony w projektancie. (Dziedziczone od ControlBuilder)
InPageTheme	Pobiera wartość logiczną wskazującą, czy ten ControlBuilder obiekt jest używany do generowania motywów stron. (Dziedziczone od ControlBuilder)
ItemType	Pobiera typ ustawiony w kontenerze powiązania. (Dziedziczone od ControlBuilder)
Localize	Pobiera wartość logiczną wskazującą, czy kontrolka utworzona przez ten ControlBuilder obiekt jest zlokalizowana. (Dziedziczone od ControlBuilder)
NamingContainerType	Pobiera typ kontenera nazewnictwa dla kontrolki tworzonej przez tego konstruktora. (Dziedziczone od ControlBuilder)
PageVirtualPath	Pobiera ścieżkę wirtualną strony do skompilowania przez to ControlBuilder wystąpienie. (Dziedziczone od ControlBuilder)
Parser	TemplateParser Pobiera element odpowiedzialny za analizowanie kontrolki. (Dziedziczone od ControlBuilder)
ServiceProvider	Pobiera obiekt usługi dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
SubBuilders	Pobiera listę obiektów podrzędnych ControlBuilder dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
TagName	Pobiera nazwę tagu kontrolki do skompilowania. (Dziedziczone od ControlBuilder)
TemplatePropertyEntries	Pobiera kolekcję wpisów właściwości szablonu. (Dziedziczone od ControlBuilder)
ThemeResolutionService	IThemeResolutionService Pobiera obiekt, który jest używany w czasie projektowania do zarządzania motywami i skórami sterowania. (Dziedziczone od ControlBuilder)

Metody

Nazwa	Opis
AllowWhitespaceLiterals()	Określa, czy literały białych znaków w kontrolce HtmlSelect mają być przetwarzane, czy ignorowane.
AppendLiteralString(String)	Dodaje określoną zawartość literału do kontrolki. Ta metoda jest wywoływana przez platformę stron ASP.NET. (Dziedziczone od ControlBuilder)
AppendSubBuilder(ControlBuilder)	Dodaje konstruktorów do ControlBuilder obiektu dla wszystkich kontrolek podrzędnych należących do kontrolki kontenera. (Dziedziczone od ControlBuilder)
BuildObject()	Tworzy wystąpienie kontrolki w czasie projektowania, do którego odwołuje się ten ControlBuilder obiekt. (Dziedziczone od ControlBuilder)
CloseControl()	Wywołana przez analizator, aby poinformować konstruktora, że analizowanie tagów otwierania i zamykania kontrolki jest zakończone. (Dziedziczone od ControlBuilder)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Dziedziczone od Object)
GetChildControlType(String, IDictionary)	Type Uzyskuje kontrolkę HtmlSelect dla kontrolek podrzędnych kontrolki.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Dziedziczone od Object)
GetObjectPersistData()	ObjectPersistData Tworzy obiekt dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
GetResourceKey()	Pobiera klucz zasobu dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
GetType()	Type Pobiera bieżące wystąpienie. (Dziedziczone od Object)
HasBody()	Określa, czy kontrolka ma zarówno tag otwierający, jak i zamykający. Ta metoda jest wywoływana przez platformę stron ASP.NET. (Dziedziczone od ControlBuilder)
HtmlDecodeLiterals()	Określa, czy ciąg literału kontrolki HTML musi być zdekodowany w formacie HTML. Ta metoda jest wywoływana przez platformę stron ASP.NET. (Dziedziczone od ControlBuilder)
Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)	Inicjuje element do użycia po utworzeniu ControlBuilder wystąpienia. Ta metoda jest wywoływana przez platformę stron ASP.NET. (Dziedziczone od ControlBuilder)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Dziedziczone od Object)
NeedsTagInnerText()	Określa, czy konstruktor kontrolki musi uzyskać jego tekst wewnętrzny. Jeśli tak, należy wywołać metodę SetTagInnerText(String) . Ta metoda jest wywoływana przez platformę stron ASP.NET. (Dziedziczone od ControlBuilder)
OnAppendToParentBuilder(ControlBuilder)	ControlBuilder Powiadamia o tym, że jest on dodawany do nadrzędnego konstruktora kontrolek. (Dziedziczone od ControlBuilder)
ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)	Umożliwia niestandardowym konstruktorom kontrolek uzyskiwanie dostępu do wygenerowanego modelu obiektów dokumentów kodu (CodeDom) oraz wstawianie i modyfikowanie kodu podczas procesu analizowania i kompilowania kontrolek. (Dziedziczone od ControlBuilder)
SetResourceKey(String)	Ustawia klucz zasobu dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
SetServiceProvider(IServiceProvider)	Ustawia obiekt usługi dla tego ControlBuilder obiektu. (Dziedziczone od ControlBuilder)
SetTagInnerText(String)	ControlBuilder Zawiera tekst wewnętrzny tagu kontrolki. (Dziedziczone od ControlBuilder)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Dziedziczone od Object)

Dotyczy

Zobacz także

Sprzężenie zwrotne

Czy ta strona była pomocna?