ClientScriptManager.RegisterExpandoAttribute メソッド

  • リファレンス

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。

オーバーロード

RegisterExpandoAttribute(String, String, String)

コントロール ID、属性名、および属性値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。
RegisterExpandoAttribute(String, String, String, Boolean)

コントロール ID、属性名、属性値、および属性値をエンコードするかどうかを示すブール値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。

RegisterExpandoAttribute(String, String, String)

コントロール ID、属性名、および属性値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。

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

カスタム属性を含む、ページ上の Control。

attributeName
String

登録するカスタム属性の名前。

attributeValue
String

カスタム属性の値。

注釈

メソッドは RegisterExpandoAttribute 、名前と値のペアを、指定した にカスタム (expando) 属性として登録します Control。 expando 属性は、レンダリングされたコントロールのマークアップに対する XHTML 互換性を維持するために、JavaScript から動的に設定されます。 カスタム (expando) 属性の値の引用符と円記号はエスケープされます。 引用符と円記号をエスケープしない場合は、オーバーロード メソッドを RegisterExpandoAttribute 呼び出し、 パラメーターを encode に false設定します。

expando 属性が見つからない場合、または expando 属性を追加するコントロールが見つからない場合でも、クライアント スクリプトは出力されますが、コントロールには影響しません。

こちらもご覧ください

適用対象

RegisterExpandoAttribute(String, String, String, Boolean)

コントロール ID、属性名、属性値、および属性値をエンコードするかどうかを示すブール値を指定して、指定されたコントロールのカスタム (expando) 属性として名前/値ペアを登録します。

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

カスタム属性を含む、ページ上の Control。

attributeName
String

登録するカスタム属性の名前。

attributeValue
String

カスタム属性の値。

encode
Boolean

登録するカスタム属性をエンコードするかどうかを示すブール値。

例

次のコード例では、 クラスの メソッドを使用する RegisterExpandoAttribute 方法を ClientScriptManager 示します。 レンダリングされたページのクライアント スクリプトは、 要素の title 属性を <span> 設定します。

<%@ 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 、名前と値のペアを、指定した にカスタム (expando) 属性として登録します Control。 expando 属性は、レンダリングされたコントロールのマークアップに対する XHTML 互換性を維持するために、JavaScript から動的に設定されます。 expando 属性の encode 値で引用符と円記号をエスケープする必要がある場合は、 パラメーター true を に設定します。

expando 属性が見つからない場合、または expando 属性を追加するコントロールが見つからない場合でも、クライアント スクリプトは出力されますが、コントロールには影響しません。

こちらもご覧ください

適用対象