ScriptManager.RegisterExpandoAttribute Methode

Definition

Namespace:

System.Web.UI

Assembly:

System.Web.Extensions.dll

Registriert ein Name-Wert-Paar beim ScriptManager-Steuerelement als benutzerdefiniertes Attribut (Expando-Attribut) eines angegebenen Steuerelements.

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 Control, controlId As String, attributeName As String, attributeValue As String, encode As Boolean)

Parameter

control

Control

Das Steuerelement, das das Expando-Attribut registriert.

controlId

String

Das Steuerelement, das das benutzerdefinierte Attribut auf der Seite enthält.

attributeName

String

Der Name des zu registrierenden benutzerdefinierten Attributs.

attributeValue

String

Der Wert des benutzerdefinierten Attributs.

encode

Boolean

true, um das zu registrierende benutzerdefinierte Attribut zu codieren, andernfalls false.

Ausnahmen

ArgumentNullException

control ist null.

ArgumentException

control befindet sich nicht in der Steuerelementstruktur der Seite.

- oder - controlId ist null.

- oder - controlId ist leer.

- oder - attributeName ist null.

- oder - attributeName ist leer.

- oder - "attributeName" ist bereits registriert.

Hinweise

Sie verwenden die RegisterExpandoAttribute Methode, um eine benutzerdefinierte (expando)-Eigenschaft für ein Steuerelement zu registrieren, das mit teilseitigem Rendern kompatibel ist und keine Abhängigkeiten von Microsoft Ajax Library aufweist.

Die RegisterExpandoAttribute Methode registriert ein Name/Wert-Paar als benutzerdefiniertes Attribut für das angegebene Steuerelement. Die Eigenschaft wird dynamisch von ECMAScript (JavaScript) festgelegt, um die XHTML-Kompatibilität für das Markup des gerenderten Steuerelements beizubehalten. Legen Sie fest encode true , ob Sie zeichen im Wert der dynamischen Eigenschaft escapen müssen.

Wenn das Steuerelement, dem die dynamische Eigenschaft hinzugefügt wird, nicht gefunden wird, tritt ein Skriptfehler auf.

Siehe auch

• ClientScriptManager