다음을 통해 공유


HtmlTextWriter.AddAttribute 메서드

정의

지정된 태그 특성과 값을 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

오버로드

AddAttribute(String, String)

지정된 태그 특성과 값을 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

AddAttribute(HtmlTextWriterAttribute, String)

태그 특성과 특성 값을 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

AddAttribute(String, String, Boolean)

지정된 태그 특성과 값을 선택적으로 인코딩하여 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

AddAttribute(String, String, HtmlTextWriterAttribute)

지정된 태그 특성과 값을 HtmlTextWriterAttribute 열거형 값과 함께 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

태그 특성과 특성 값을 선택적으로 인코딩하여 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

AddAttribute(String, String)

지정된 태그 특성과 값을 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value);
public virtual void AddAttribute (string name, string value);
abstract member AddAttribute : string * string -> unit
override this.AddAttribute : string * string -> unit
Public Overridable Sub AddAttribute (name As String, value As String)

매개 변수

name
String

추가할 특성의 이름이 포함된 문자열입니다.

value
String

특성에 할당할 값이 포함된 문자열입니다.

예제

다음 코드 예제를 호출 하는 방법에 설명 합니다 메서드를 AddAttribute 호출 RenderBeginTag 하기 전에 메서드. 코드는 메서드를 AddAttribute 호출하여 요소를 출력 스트림에 렌더링하기 전에 의 두 개의 다른 오버로드와 의 AddStyleAttribute 두 개의 서로 다른 오버로드를 <span> 호출 RenderBeginTag 합니다. 메서드는 AddAttribute(String, String) 라는 CustomAttribute 사용자 지정 특성과 이 코드가 렌더링하는 요소에 <span> 대해 명명된 CustomAttributeValue 사용자 지정 값을 정의하는 데 사용됩니다.

// Set attributes and values along with attributes and styles  
// attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute("CustomAttribute", "CustomAttributeValue");
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red");
writer.AddStyleAttribute("Customstyle", "CustomStyleValue");
writer.RenderBeginTag(HtmlTextWriterTag.Span);
// Create a space and indent the markup inside the 
// <span> element.
writer.WriteLine();
writer.Indent++;
' Set attributes and values along with attributes and styles
' attribute defined for a <span> element.
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")
writer.AddAttribute("CustomAttribute", "CustomAttributeValue")
writer.AddStyleAttribute(HtmlTextWriterStyle.Color, "Red")
writer.AddStyleAttribute("CustomStyle", "CustomStyleValue")
writer.RenderBeginTag(HtmlTextWriterTag.Span)

'  Create a space and indent the markup inside the 
' <span> element.
writer.WriteLine()
writer.Indent += 1

설명

특성이 AddAttribute 값 중 하나가 아니거나 런타임까지 특성을 알 수 없는 경우 메서드의 HtmlTextWriterAttribute 오버로드 AddAttribute(String, String) 를 사용합니다.

지정된 태그 요소의 instance 경우 클래스는 HtmlTextWriter 해당 요소에 대한 특성 목록을 유지 관리합니다. 메서드가 RenderBeginTag 호출되면 메서드에 의해 AddAttribute 추가된 모든 특성이 요소의 여는 태그에 렌더링됩니다. 그런 다음, 특성 목록이 개체에서 지워집니다 HtmlTextWriter .

태그 요소를 렌더링하기 위한 코딩 패턴은 다음과 같습니다.

  • 메서드를 AddAttribute 사용하여 요소에 특성을 추가합니다.

  • RenderBeginTag 메서드를 사용하세요.

  • 필요에 따라 다른 메서드를 사용하여 요소의 여는 태그와 닫는 태그 사이에 있는 콘텐츠를 렌더링합니다.

  • RenderEndTag 메서드를 사용하세요.

추가 정보

적용 대상

AddAttribute(HtmlTextWriterAttribute, String)

태그 특성과 특성 값을 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value);
public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value);
abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string -> unit
Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)

매개 변수

key
HtmlTextWriterAttribute

출력 스트림에 추가할 태그 특성을 나타내는 HtmlTextWriterAttribute입니다.

value
String

특성에 할당할 값이 포함된 문자열입니다.

예제

다음 코드 예제에서는 메서드의 AddAttribute(HtmlTextWriterAttribute, String) 오버로드를 사용하여 AddAttribute 태그 요소에 특성을 추가한 Onclick 다음 해당 값을 다음 ECMAScript 코드로 설정하는 방법을 보여 줍니다.

alert('Hello');  
writer->AddAttribute( HtmlTextWriterAttribute::Onclick, "alert('Hello');" );
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');");
writer.AddAttribute(HtmlTextWriterAttribute.Onclick, "alert('Hello');")

설명

메서드의 AddAttribute 오버로드를 AddAttribute(HtmlTextWriterAttribute, String) 사용하여 표준 태그 특성을 렌더링합니다.

지정된 태그 요소의 instance 경우 클래스는 HtmlTextWriter 해당 요소에 대한 특성 목록을 유지 관리합니다. 메서드가 RenderBeginTag 호출되면 메서드에 의해 AddAttribute 추가된 모든 특성이 요소의 여는 태그에 렌더링됩니다. 그런 다음, 특성 목록이 에서 지워집니다 HtmlTextWriter.

태그 요소를 렌더링하기 위한 코딩 패턴은 다음과 같습니다.

  • 메서드를 AddAttribute 사용하여 요소에 특성을 추가합니다.

  • RenderBeginTag 메서드를 사용하세요.

  • 필요에 따라 다른 메서드를 사용하여 요소의 여는 태그와 닫는 태그 사이에 있는 콘텐츠를 렌더링합니다.

  • RenderEndTag 메서드를 사용하세요.

추가 정보

적용 대상

AddAttribute(String, String, Boolean)

지정된 태그 특성과 값을 선택적으로 인코딩하여 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

public:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, bool fEndode);
public virtual void AddAttribute (string name, string value, bool fEndode);
abstract member AddAttribute : string * string * bool -> unit
override this.AddAttribute : string * string * bool -> unit
Public Overridable Sub AddAttribute (name As String, value As String, fEndode As Boolean)

매개 변수

name
String

추가할 특성의 이름이 포함된 문자열입니다.

value
String

특성에 할당할 값이 포함된 문자열입니다.

fEndode
Boolean

특성과 그 값을 인코딩하면 true이고, 그렇지 않으면 false입니다.

예제

다음 코드 예제에서는 메서드의 AddAttribute(String, String, Boolean) 오버로드를 사용하여 AddAttribute 라는 myattribute사용자 지정 특성과 해당 값이 요소에 대해 <img> 인코딩되지 않도록 하는 방법을 보여줍니다.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();
// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();
' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

설명

특성이 AddAttributeAddAttribute(String, String, Boolean) 값 중 HtmlTextWriterAttribute 하나가 아니거나 런타임 및 인코딩이 필요할 때까지 특성을 알 수 없는 경우 메서드의 오버로드를 사용합니다.

지정된 태그 요소의 instance 경우 클래스는 HtmlTextWriter 해당 요소에 대한 특성 목록을 유지 관리합니다. 메서드가 RenderBeginTag 호출되면 메서드에 의해 AddAttribute 추가된 모든 특성이 요소의 여는 태그에 렌더링됩니다. 그런 다음, 특성 목록이 개체에서 지워집니다 HtmlTextWriter .

특성에 AddAttribute(String, String, Boolean) 따옴표("), 보다 작음 기호() 또는 앰퍼샌드(<&)가 포함될 수 있는 경우 로 설정된 true메서드 fEncode 를 사용합니다. 메서드 호출에는 특성을 요청 디바이스 요구 사항에 맞게 인코딩합니다. 이러한 문자가 생성되지 않거나 특성이 이미 인코딩된 것을 알고 있는 경우 로 설정할 fEncodefalse수 있습니다.

특성 형식이 Style이면 가 인 경우에도 fEndodetrue값이 인코딩되지 않습니다. 스타일 값이 CSS 규격이고 악성 코드를 포함하지 않는지 확인합니다.

태그 요소를 렌더링하기 위한 코딩 패턴은 다음과 같습니다.

  • 메서드를 AddAttribute 사용하여 요소에 특성을 추가합니다.

  • RenderBeginTag 메서드를 사용하세요.

  • 필요에 따라 다른 메서드를 사용하여 요소의 여는 태그와 닫는 태그 사이에 있는 콘텐츠를 렌더링합니다.

  • RenderEndTag 메서드를 사용하세요.

추가 정보

적용 대상

AddAttribute(String, String, HtmlTextWriterAttribute)

지정된 태그 특성과 값을 HtmlTextWriterAttribute 열거형 값과 함께 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

protected:
 virtual void AddAttribute(System::String ^ name, System::String ^ value, System::Web::UI::HtmlTextWriterAttribute key);
protected virtual void AddAttribute (string name, string value, System.Web.UI.HtmlTextWriterAttribute key);
abstract member AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
override this.AddAttribute : string * string * System.Web.UI.HtmlTextWriterAttribute -> unit
Protected Overridable Sub AddAttribute (name As String, value As String, key As HtmlTextWriterAttribute)

매개 변수

name
String

추가할 특성의 이름이 포함된 문자열입니다.

value
String

특성에 할당할 값이 포함된 문자열입니다.

key
HtmlTextWriterAttribute

특성을 나타내는 HtmlTextWriterAttribute입니다.

설명

클래스에서 상속할 AddAttributeAddAttribute(String, String, HtmlTextWriterAttribute) 때만 메서드의 오버로드를 HtmlTextWriter 사용합니다. 이를 통해 특성에 대한 새 namekey 쌍을 만들 수 있습니다.

추가 정보

적용 대상

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

태그 특성과 특성 값을 선택적으로 인코딩하여 HtmlTextWriter 개체가 RenderBeginTag 메서드를 이후에 호출하여 만드는 요소의 여는 태그에 추가합니다.

public:
 virtual void AddAttribute(System::Web::UI::HtmlTextWriterAttribute key, System::String ^ value, bool fEncode);
public virtual void AddAttribute (System.Web.UI.HtmlTextWriterAttribute key, string value, bool fEncode);
abstract member AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
override this.AddAttribute : System.Web.UI.HtmlTextWriterAttribute * string * bool -> unit
Public Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)

매개 변수

key
HtmlTextWriterAttribute

출력 스트림에 추가할 태그 특성을 나타내는 HtmlTextWriterAttribute입니다.

value
String

특성에 할당할 값이 포함된 문자열입니다.

fEncode
Boolean

특성과 그 값을 인코딩하면 true이고, 그렇지 않으면 false입니다.

예제

다음 코드 예제에 사용 하는 방법을 보여 줍니다.는 AddAttribute(HtmlTextWriterAttribute, String, Boolean) 에 할당 되는 문자열 값을 확인 하는 방법을 Alt 특성에 대 한는 <img> 요청 하는 디바이스에 대 한 요소는 인코딩됩니다.

// Control the encoding of attributes.
// Simple known values do not need encoding.
writer->AddAttribute( HtmlTextWriterAttribute::Alt, "Encoding, \"Required\"", true );
writer->AddAttribute( "myattribute", "No "encoding " required", false );
writer->RenderBeginTag( HtmlTextWriterTag::Img );
writer->RenderEndTag();
writer->WriteLine();
// Control the encoding of attributes. 
// Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, \"Required\"", true);
writer.AddAttribute("myattribute", "No "encoding " required", false);
writer.RenderBeginTag(HtmlTextWriterTag.Img);
writer.RenderEndTag();
writer.WriteLine();
' Control the encoding of attributes.
' Simple known values do not need encoding.
writer.AddAttribute(HtmlTextWriterAttribute.Alt, "Encoding, ""Required""", True)
writer.AddAttribute("myattribute", "No "encoding " required", False)
writer.RenderBeginTag(HtmlTextWriterTag.Img)
writer.RenderEndTag()
writer.WriteLine()

설명

메서드의 AddAttribute 오버로드를 AddAttribute(HtmlTextWriterAttribute, String, Boolean) 사용하여 선택적 인코딩을 사용하여 표준 태그 특성을 렌더링합니다.

지정된 태그 요소의 instance 경우 클래스는 HtmlTextWriter 해당 요소에 대한 특성 목록을 유지 관리합니다. 메서드가 RenderBeginTag 호출되면 에 의해 AddAttribute 추가된 모든 특성이 요소의 여는 태그에 렌더링됩니다. 그런 다음, 특성 목록이 개체에서 지워집니다 HtmlTextWriter .

특성에 AddAttribute(HtmlTextWriterAttribute, String, Boolean) 따옴표("), 보다 작음 기호() 또는 앰퍼샌드(<&)가 포함될 수 있는 경우 로 설정된 true메서드 fEncode 를 사용합니다. 메서드 호출에는 특성을 요청 디바이스 요구 사항에 맞게 인코딩합니다. 이러한 문자가 생성되지 않거나 특성이 이미 인코딩된 것을 알고 있는 경우 로 설정할 fEncodefalse수 있습니다.

특성 형식이 Style이면 가 인 경우에도 fEncodetrue값이 인코딩되지 않습니다. 스타일 값이 CSS 규격이고 악성 코드를 포함하지 않는지 확인합니다.

태그 요소를 렌더링하기 위한 코딩 패턴은 다음과 같습니다.

  • 메서드를 AddAttribute 사용하여 요소에 특성을 추가합니다.

  • RenderBeginTag 메서드를 사용하세요.

  • 필요에 따라 다른 메서드를 사용하여 요소의 여는 태그와 닫는 태그 사이에 있는 콘텐츠를 렌더링합니다.

  • RenderEndTag 메서드를 사용하세요.

추가 정보

적용 대상