HtmlTextWriter.AddAttribute 메서드

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)

매개 변수

예제

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

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

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

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

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

• RenderBeginTag 메서드를 사용합니다.

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

• RenderEndTag 메서드를 사용합니다.

추가 정보

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

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)

매개 변수

예제

다음 코드 예제에서는 메서드의 AddAttribute 오버로드를 사용하여 AddAttribute(HtmlTextWriterAttribute, String) 태그 요소에 특성을 추가 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) 사용하여 표준 태그 특성을 렌더링합니다.

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

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

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

• RenderBeginTag 메서드를 사용합니다.

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

• RenderEndTag 메서드를 사용합니다.

추가 정보

• TextWriter
• RenderBeginTag
• RenderEndTag()

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)

매개 변수

예제

다음 코드 예제에서는 메서드의 AddAttribute 오버로드를 사용하여 AddAttribute(String, String, Boolean) 명명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()

설명

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

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

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

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

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

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

• RenderBeginTag 메서드를 사용합니다.

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

• RenderEndTag 메서드를 사용합니다.

추가 정보

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)

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)

매개 변수

설명

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

추가 정보

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

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)

매개 변수

예제

다음 코드 예제에서는 메서드를 사용 하 여 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) 사용하여 선택적 인코딩을 사용하여 표준 태그 특성을 렌더링합니다.

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

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

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

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

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

• RenderBeginTag 메서드를 사용합니다.

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

• RenderEndTag 메서드를 사용합니다.

추가 정보

• TextWriter
• HttpRequest
• RenderBeginTag
• HtmlTextWriterAttribute
• HtmlAttributeEncode(String, TextWriter)