ScriptManager.RegisterExpandoAttribute(Control, String, String, String, Boolean) メソッド

定義

指定されたコントロールのカスタム (expando) 属性として名前/値ペアを ScriptManager コントロールに登録します。Registers a name/value pair with the ScriptManager control as a custom (expando) attribute of a specified control.

public:
 static void RegisterExpandoAttribute(System::Web::UI::Control ^ control, System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue, bool encode);
public static void RegisterExpandoAttribute (System.Web.UI.Control control, string controlId, string attributeName, string attributeValue, bool encode);
static member RegisterExpandoAttribute : System.Web.UI.Control * string * string * string * bool -> unit
Public Shared Sub RegisterExpandoAttribute (control As System.Web.UI.Control, controlId As String, attributeName As String, attributeValue As String, encode As Boolean)

パラメーター

control
Control

expando 属性を登録するコントロール。The control that is registering the expando attribute.

controlId
String

カスタム属性を含むページ上のコントロール。The control that contains the custom attribute on the page.

attributeName
String

登録するカスタム属性の名前。The name of the custom attribute to register.

attributeValue
String

カスタム属性の値。The value of the custom attribute.

encode
Boolean

登録されるカスタム属性をエンコードする場合は true。それ以外の場合は falsetrue to encode the custom attribute that is being registered; otherwise, false.

実装

System.Web.UI.IScriptManager.RegisterExpandoAttribute(System.Web.UI.Control,System.String,System.String,System.String,System.Boolean)

例外

controlnull です。control is null.

control がページのコントロール ツリーにありません。control is not in the page's control tree.

または-or- controlIdnull です。controlId is null.

または-or- controlId が空です。controlId is empty.

または-or- attributeNamenull です。attributeName is null.

または-or- attributeName が空です。attributeName is empty.

または-or- attributeName は既に登録されています。attributeName is already registered.

注釈

RegisterExpandoAttribute メソッドを使用して、部分ページレンダリングと互換性のあるコントロールのカスタム (expando) プロパティを登録します。これには、Microsoft Ajax ライブラリの依存関係はありません。You use the RegisterExpandoAttribute method to register a custom (expando) property for a control that is compatible with partial-page rendering and that has no Microsoft Ajax Library dependencies.

RegisterExpandoAttribute メソッドは、指定されたコントロールのカスタム属性として名前/値ペアを登録します。The RegisterExpandoAttribute method registers a name/value pair as a custom attribute for the specified control. プロパティは、表示されるコントロールのマークアップの XHTML の互換性を維持するために、ECMAScript (JavaScript) から動的に設定されます。The property is set dynamically from ECMAScript (JavaScript) to preserve XHTML compatibility for the rendered control's markup. 動的プロパティの値の文字をエスケープする必要がある場合は、encodetrue に設定します。Set encode to true if you have to escape any characters in the dynamic property's value.

動的プロパティが追加されるコントロールが見つからない場合は、スクリプトエラーが発生します。If the control to which the dynamic property will be added is not found, a script error occurs.

適用対象

こちらもご覧ください