SkinBuilder Class

Definition

提供 ControlBuilder 物件,用於設定階段將控制面板套用至控制項。Provides a ControlBuilder object used at design time to apply control skins to controls.

public ref class SkinBuilder sealed : System::Web::UI::ControlBuilder
public sealed class SkinBuilder : System.Web.UI.ControlBuilder
type SkinBuilder = class
    inherit ControlBuilder
Public NotInheritable Class SkinBuilder
Inherits ControlBuilder
Inheritance
SkinBuilder

Remarks

網頁開發人員和控制項作者不會直接使用 SkinBuilder 類別。Page developers and control authors do not use the SkinBuilder class directly.

ASP.NET 設計工具產生器會使用 SkinBuilder 類別搭配 ThemeProvider 類別和 IThemeResolutionService 介面,在設計階段將主題和其各自的控制面板套用至控制項。ASP.NET designer builders use the SkinBuilder class in conjunction with the ThemeProvider class and the IThemeResolutionService interface to apply themes and their respective control skins to controls at design time. 若要在設計階段套用主題,每當建立控制項的子控制項樹狀結構時,基底 ControlBuilder 類別都會呼叫 ApplyTheme 方法。To apply themes at design time, the base ControlBuilder class calls the ApplyTheme method whenever a control's child control tree is built.

Constructors

SkinBuilder(ThemeProvider, Control, ControlBuilder, String)

初始化 SkinBuilder 類別的新執行個體,並設定與產生器關聯的控制項、由控制項的 ControlBuilder 物件提供的一般 ThemeProvider 物件,和主題檔案的路徑。Initializes a new instance of the SkinBuilder class, setting the control with which the builder is associated, the general ControlBuilder object provided by the ThemeProvider object for the control, and a path to the theme file.

Properties

BindingContainerBuilder

取得控制項產生器,對應於這個產生器所建立之控制項的繫結容器。Gets the control builder that corresponds to the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
BindingContainerType

取得這個產生器所建立之控制項的繫結容器型別。Gets the type of the binding container for the control that this builder creates.

(Inherited from ControlBuilder)
ComplexPropertyEntries

取得複雜屬性項目的集合。Gets a collection of complex property entries.

(Inherited from ControlBuilder)
ControlType

取得所要建立的控制項的 TypeGets the Type for the control to be created.

(Inherited from ControlBuilder)
CurrentFilterResolutionService

取得 IFilterResolutionService 物件,用於設計工具中剖析和保存控制項時,管理裝置篩選條件相關的服務。Gets an IFilterResolutionService object that is used to manage device-filter related services when parsing and persisting controls in the designer.

(Inherited from ControlBuilder)
DeclareType

取得產生程式碼時用來宣告控制項的型別。Gets the type that will be used by code generation to declare the control.

(Inherited from ControlBuilder)
FChildrenAsProperties

取得值,判斷控制項是否有 ParseChildrenAttribute 設為 trueChildrenAsPropertiesGets a value that determines whether the control has a ParseChildrenAttribute with ChildrenAsProperties set to true.

(Inherited from ControlBuilder)
FIsNonParserAccessor

取得值,判斷控制項是否實作 IParserAccessor 介面。Gets a value that determines whether the control implements the IParserAccessor interface.

(Inherited from ControlBuilder)
HasAspCode

取得值,指出控制項是否包含任何程式碼區塊。Gets a value indicating whether the control contains any code blocks.

(Inherited from ControlBuilder)
ID

取得或設定要建置的控制項的識別項屬性。Gets or sets the identifier property for the control to be built.

(Inherited from ControlBuilder)
InDesigner

傳回值,指出 ControlBuilder 是否在設計工具中執行。Returns whether the ControlBuilder is running in the designer.

(Inherited from ControlBuilder)
InPageTheme

取得布林值,指出這個 ControlBuilder 物件是否用來產生頁面主題。Gets a Boolean value indicating whether this ControlBuilder object is used to generate page themes.

(Inherited from ControlBuilder)
ItemType

取得在繫結容器上設定的類型。Gets the type set on the binding container.

(Inherited from ControlBuilder)
Localize

取得布林值,指出這個 ControlBuilder 物件所建立的控制項是否當地語系化。Gets a Boolean value indicating whether the control that is created by this ControlBuilder object is localized.

(Inherited from ControlBuilder)
NamingContainerType

取得這個產生器所建立之控制項的命名容器型別。Gets the type of the naming container for the control that this builder creates.

(Inherited from ControlBuilder)
PageVirtualPath

取得欲以此 ControlBuilder 執行個體組建之頁面的虛擬路徑。Gets the virtual path of a page to be built by this ControlBuilder instance.

(Inherited from ControlBuilder)
Parser

取得負責剖析控制項的 TemplateParserGets the TemplateParser responsible for parsing the control.

(Inherited from ControlBuilder)
ServiceProvider

取得這個 ControlBuilder 物件的服務物件。Gets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SubBuilders

取得這個 ControlBuilder 物件之子 ControlBuilder 物件的清單。Gets a list of child ControlBuilder objects for this ControlBuilder object.

(Inherited from ControlBuilder)
TagName

取得要建置的控制項的標記名稱。Gets the tag name for the control to be built.

(Inherited from ControlBuilder)
TemplatePropertyEntries

取得樣板屬性項目的集合。Gets a collection of template property entries.

(Inherited from ControlBuilder)
ThemeResolutionService

取得 IThemeResolutionService 物件,這個物件在設計階段用來管理控制項主題和面板。Gets an IThemeResolutionService object that is used in design time to manage control themes and skins.

(Inherited from ControlBuilder)

Methods

AllowWhitespaceLiterals()

判斷控制項的開頭和結尾標記之間的內容是否允許空白字元常值。Determines whether white space literals are permitted in the content between a control's opening and closing tags. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
AppendLiteralString(String)

將指定的常值內容加入控制項。Adds the specified literal content to a control. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
AppendSubBuilder(ControlBuilder)

針對屬於容器控制項的任何子控制項,將產生器加入 ControlBuilder 物件中。Adds builders to the ControlBuilder object for any child controls that belong to the container control.

(Inherited from ControlBuilder)
ApplyTheme()

如果 SkinBuilder 物件與控制項產生關聯,則於設計階段將主題和控制面板套用至目前的控制項。Applies a theme and a control skin to the current control at design time, if a SkinBuilder object is associated with the control.

BuildObject()

建置這個 ControlBuilder 物件所參考之控制項的設計階段執行個體。Builds a design-time instance of the control that is referred to by this ControlBuilder object.

(Inherited from ControlBuilder)
CloseControl()

由剖析器呼叫,通知產生器,控制項開頭和結尾標記的剖析已經完成。Called by the parser to inform the builder that the parsing of the control's opening and closing tags is complete.

(Inherited from ControlBuilder)
Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetChildControlType(String, IDictionary)

取得對應到子標記之控制項類型的 TypeObtains the Type of the control type corresponding to a child tag. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetObjectPersistData()

建立這個 ObjectPersistData 物件的 ControlBuilder 物件。Creates the ObjectPersistData object for this ControlBuilder object.

(Inherited from ControlBuilder)
GetResourceKey()

擷取這個 ControlBuilder 物件的資源索引鍵。Retrieves the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
HasBody()

判斷控制項是否有開頭和結尾標記。Determines if a control has both an opening and closing tag. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
HtmlDecodeLiterals()

判斷 HTML 控制項的常值字串是否必須為解碼的 HTML。Determines whether the literal string of an HTML control must be HTML decoded. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
Init(TemplateParser, ControlBuilder, Type, String, String, IDictionary)

初始化 ControlBuilder,以便當它執行個體化之後,可供使用。Initializes the ControlBuilder for use after it is instantiated. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
MemberwiseClone()

建立目前 Object 的淺層複製。Creates a shallow copy of the current Object.

(Inherited from Object)
NeedsTagInnerText()

判斷控制項產生器是否需要取得它的內部文字。Determines if the control builder needs to get its inner text. 如果是,必須呼叫 SetTagInnerText(String) 方法。If so, the SetTagInnerText(String) method must be called. 此方法由 ASP.NET 網頁架構呼叫。This method is called by the ASP.NET page framework.

(Inherited from ControlBuilder)
OnAppendToParentBuilder(ControlBuilder)

告知 ControlBuilder 已經加入到父控制項產生器中。Notifies the ControlBuilder that it is being added to a parent control builder.

(Inherited from ControlBuilder)
ProcessGeneratedCode(CodeCompileUnit, CodeTypeDeclaration, CodeTypeDeclaration, CodeMemberMethod, CodeMemberMethod)

讓自訂控制項產生器存取產生的程式碼文件物件模型 (CodeDom),並在剖析及建置控制項的過程中插入及修改程式碼。Enables custom control builders to access the generated Code Document Object Model (CodeDom) and insert and modify code during the process of parsing and building controls.

(Inherited from ControlBuilder)
SetResourceKey(String)

設定這個 ControlBuilder 物件的資源索引鍵。Sets the resource key for this ControlBuilder object.

(Inherited from ControlBuilder)
SetServiceProvider(IServiceProvider)

設定這個 ControlBuilder 物件的服務物件。Sets the service object for this ControlBuilder object.

(Inherited from ControlBuilder)
SetTagInnerText(String)

提供控制項標記內部文字給 ControlBuilderProvides the ControlBuilder with the inner text of the control tag.

(Inherited from ControlBuilder)
ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)

Applies to

See also