Freigeben über


ScriptManager.RegisterExpandoAttribute Methode

Definition

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

control ist null.

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.

Gilt für

Siehe auch