ClientScriptManager.RegisterExpandoAttribute メソッド

定義

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

オーバーロード

RegisterExpandoAttribute(String, String, String)

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

RegisterExpandoAttribute(String, String, String, Boolean)

コントロール ID、属性名、属性値、および属性値をエンコードするかどうかを示すブール値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。Registers a name/value pair as a custom (expando) attribute of the specified control given a control ID, an attribute name, an attribute value, and a Boolean value indicating whether to encode the attribute value.

RegisterExpandoAttribute(String, String, String)

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

public:
 void RegisterExpandoAttribute(System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue);
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue);
member this.RegisterExpandoAttribute : string * string * string -> unit
Public Sub RegisterExpandoAttribute (controlId As String, attributeName As String, attributeValue As String)

パラメーター

controlId
String

カスタム属性を含む、ページ上の ControlThe Control on the page that contains the custom attribute.

attributeName
String

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

attributeValue
String

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

注釈

メソッドRegisterExpandoAttributeは、指定さControlれたに対して、カスタム (expando) 属性として名前/値ペアを登録します。The RegisterExpandoAttribute method registers a name/value pair as a custom (expando) attribute on the specified Control. Expando 属性は、レンダリングされたコントロールのマークアップの XHTML の互換性を維持するために、JavaScript から動的に設定されます。The expando attribute is set dynamically from JavaScript to preserve XHTML compatibility for the rendered control's markup. カスタム (expando) 属性の値の引用符とバックスラッシュはエスケープされます。Quotes and backslashes in the custom (expando) attribute's values are escaped. 引用符とバックスラッシュをエスケープしない場合は、 RegisterExpandoAttributeオーバーロードメソッドを呼び出し、 encodeパラメーターをにfalse設定します。If you do not want to escape quotes and backslashes, call the RegisterExpandoAttribute overload method and set the encode parameter to false.

Expando 属性が見つからない場合、または expando 属性を追加するコントロールが見つからない場合でも、クライアントスクリプトは出力されますが、コントロールには影響しません。If the expando attribute is not found or the control to add the expando attribute to is not found, the client script is still emitted, but it will not affect the control.

こちらもご覧ください

RegisterExpandoAttribute(String, String, String, Boolean)

コントロール ID、属性名、属性値、および属性値をエンコードするかどうかを示すブール値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。Registers a name/value pair as a custom (expando) attribute of the specified control given a control ID, an attribute name, an attribute value, and a Boolean value indicating whether to encode the attribute value.

public:
 void RegisterExpandoAttribute(System::String ^ controlId, System::String ^ attributeName, System::String ^ attributeValue, bool encode);
public void RegisterExpandoAttribute (string controlId, string attributeName, string attributeValue, bool encode);
member this.RegisterExpandoAttribute : string * string * string * bool -> unit
Public Sub RegisterExpandoAttribute (controlId As String, attributeName As String, attributeValue As String, encode As Boolean)

パラメーター

controlId
String

カスタム属性を含む、ページ上の ControlThe Control on the page that contains the custom attribute.

attributeName
String

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

attributeValue
String

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

encode
Boolean

登録するカスタム属性をエンコードするかどうかを示すブール値。A Boolean value indicating whether to encode the custom attribute to register.

クラスのメソッドRegisterExpandoAttributeを使用する方法を次のコード例に示します。 ClientScriptManagerThe following code example demonstrates how to use the RegisterExpandoAttribute method of the ClientScriptManager class. レンダリングされたページのクライアントスクリプトはtitle<span>要素の属性を設定します。The client script in the rendered page sets the title attribute of a <span> element.

<%@ Page Language="C#"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
 
  public void Page_Load(Object sender, EventArgs e)
  {        
    // Get a ClientScriptManager reference from the Page class.
    ClientScriptManager cs = Page.ClientScript;
    
    // Register an expando attribute.
    cs.RegisterExpandoAttribute("Message", "title", "New title from client script.", true);
    
  }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <span  id="Message" 
            title="Title to be replaced.">
            Place your mouse over this text to see the title.
     </span>           
     </form>
  </body>
</html>
<%@ Page Language="VB" %>

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

  Protected Sub Page_Load(ByVal sender As Object, ByVal e As System.EventArgs)
        
    ' Get a ClientScriptManager reference from the Page class.
    Dim cs As ClientScriptManager = Page.ClientScript
    
    ' Register an expando attribute.
    cs.RegisterExpandoAttribute("Message", "title", "New title from client script.", True)    
    
  End Sub
  
</script>

<html xmlns="http://www.w3.org/1999/xhtml" >
  <head>
    <title>ClientScriptManager Example</title>
  </head>
  <body>
     <form    id="Form1"
            runat="server">
     <span  id="Message" 
            title="Title to be replaced.">
            Place your mouse over this text to see the title.
     </span>
     </form>
  </body>
</html>

注釈

メソッドRegisterExpandoAttributeは、指定さControlれたに対して、カスタム (expando) 属性として名前/値ペアを登録します。The RegisterExpandoAttribute method registers a name/value pair as a custom (expando) attribute on the specified Control. Expando 属性は、レンダリングされたコントロールのマークアップの XHTML の互換性を維持するために、JavaScript から動的に設定されます。The expando attribute is set dynamically from JavaScript to preserve XHTML compatibility for the rendered control's markup. Expando 属性encodeの値trueで引用符とバックスラッシュをエスケープする必要がある場合は、パラメーターをに設定します。Set the encode parameter to true if you need to escape quotes and backslashes in your expando attribute's value.

Expando 属性が見つからない場合、または expando 属性を追加するコントロールが見つからない場合でも、クライアントスクリプトは出力されますが、コントロールには影響しません。If the expando attribute is not found or the control to add the expando attribute to is not found, the client script is still emitted, but it will not affect the control.

こちらもご覧ください

適用対象