HtmlTextWriter.AddAttribute Yöntem

Tanım

Ad Alanı:

System.Web.UI

Bütünleştirilmiş Kod:

System.Web.dll

Belirtilen işaretleme özniteliğini ve değerini, nesnesinin yöntemine sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.

Aşırı Yüklemeler

AddAttribute(String, String)	Belirtilen işaretleme özniteliğini ve değerini, nesnesinin yöntemine sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.
AddAttribute(HtmlTextWriterAttribute, String)	markup özniteliğini ve öznitelik değerini, nesnesinin yöntemine yapılan sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.
AddAttribute(String, String, Boolean)	Belirtilen işaretleme özniteliğini ve değerini, isteğe bağlı kodlama ile nesnesinin HtmlTextWriter yöntemine sonraki bir çağrıyla oluşturduğu öğenin açılış etiketine RenderBeginTag ekler.
AddAttribute(String, String, HtmlTextWriterAttribute)	Belirtilen işaretleme özniteliğini ve değerini, bir HtmlTextWriterAttribute numaralandırma değeriyle birlikte, nesnesinin yöntemine sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.
AddAttribute(HtmlTextWriterAttribute, String, Boolean)	İşaretlemeyi özniteliğini ve öznitelik değerini, isteğe bağlı kodlama ile nesnesinin HtmlTextWriter yöntemine sonraki bir çağrıyla oluşturduğu öğenin açılış etiketine RenderBeginTag ekler.

AddAttribute(String, String)

Belirtilen işaretleme özniteliğini ve değerini, nesnesinin yöntemine sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.

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)

Parametreler

name

String

Eklenecek özniteliğin adını içeren bir dize.

value

String

Özniteliğine atanacak değeri içeren bir dize.

Örnekler

Aşağıdaki kod örneği, yöntemini çağırmadan önce yönteminin AddAttribute nasıl çağrılduğunu RenderBeginTag gösterir. Kod, bir öğeyi çıkış akışına AddAttribute işlemek <span> için yöntemini çağırmadan önce iki farklı ve iki farklı aşırı yüklemesini AddStyleAttribute çağırırRenderBeginTag. AddAttribute(String, String) yöntemi, adlı CustomAttribute özel özniteliği ve bu kodun işlenen öğesi için adlandırılmış CustomAttributeValue özel değeri tanımlamak için <span> kullanılır.

// 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

Açıklamalar

AddAttribute Öznitelik değerlerden biri HtmlTextWriterAttribute değilse veya öznitelik çalışma zamanına kadar bilinmiyorsa yönteminin aşırı yüklemesini AddAttribute(String, String) kullanın.

Belirli bir işaretleme öğesinin örneği için sınıfı, HtmlTextWriter bu öğenin özniteliklerinin listesini tutar. RenderBeginTag yöntemi çağrıldığında, yöntemi tarafından AddAttribute eklenen tüm öznitelikler öğesinin açılış etiketine işlenir. Öznitelik listesi daha sonra nesneden HtmlTextWriter temizlenir.

biçimlendirme öğelerini işlemeye yönelik kodlama deseni aşağıdaki gibidir:

• AddAttribute öğesine öznitelik eklemek için yöntemini kullanın.

• RenderBeginTag yöntemini kullanın.

• Öğenin açma ve kapatma etiketleri arasında bulunan içeriği işlemek için gereken diğer yöntemleri kullanın.

• RenderEndTag yöntemini kullanın.

Ayrıca bkz.

• TextWriter
• RenderBeginTag
• RenderEndTag()
• AddStyleAttribute

AddAttribute(HtmlTextWriterAttribute, String)

markup özniteliğini ve öznitelik değerini, nesnesinin yöntemine yapılan sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.

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)

Parametreler

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute Çıkış akışına eklenecek işaretleme özniteliğini temsil eden bir.

value

String

Özniteliğine atanacak değeri içeren bir dize.

Örnekler

Aşağıdaki kod örneği, bir işaretleme öğesine öznitelik eklemek Onclick ve değerini aşağıdaki ECMAScript koduna ayarlamak için yönteminin aşırı yüklemesinin AddAttribute(HtmlTextWriterAttribute, String) nasıl kullanılacağını AddAttribute gösterir:

alert('Hello');  

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

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

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

Açıklamalar

AddAttribute Standart işaretleme özniteliğini işlemek için yönteminin AddAttribute(HtmlTextWriterAttribute, String) aşırı yüklemesini kullanın.

Belirli bir işaretleme öğesinin örneği için sınıfı, HtmlTextWriter bu öğenin özniteliklerinin listesini tutar. RenderBeginTag yöntemi çağrıldığında, yöntemi tarafından AddAttribute eklenen tüm öznitelikler öğesinin açılış etiketine işlenir. Öznitelik listesi daha sonra'dan HtmlTextWritertemizlenir.

biçimlendirme öğelerini işlemeye yönelik kodlama deseni aşağıdaki gibidir:

• AddAttribute öğesine öznitelik eklemek için yöntemini kullanın.

• RenderBeginTag yöntemini kullanın.

• Öğenin açma ve kapatma etiketleri arasında bulunan içeriği işlemek için gereken diğer yöntemleri kullanın.

• RenderEndTag yöntemini kullanın.

Ayrıca bkz.

• TextWriter
• RenderBeginTag
• RenderEndTag()

AddAttribute(String, String, Boolean)

Belirtilen işaretleme özniteliğini ve değerini, isteğe bağlı kodlama ile nesnesinin HtmlTextWriter yöntemine sonraki bir çağrıyla oluşturduğu öğenin açılış etiketine RenderBeginTag ekler.

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)

Parametreler

name

String

Eklenecek özniteliğin adını içeren bir dize.

value

String

Özniteliğine atanacak değeri içeren bir dize.

fEndode

Boolean

true özniteliğini ve değerini kodlamak için; aksi takdirde , false.

Örnekler

Aşağıdaki kod örneği, adlı myattributeözel bir özniteliğin AddAttribute ve değerinin AddAttribute(String, String, Boolean) bir öğe için kodlanmadığından emin olmak için <img> yönteminin aşırı yüklemesinin nasıl kullanılacağını gösterir.

// 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()

Açıklamalar

AddAttribute Öznitelik değerlerden biri HtmlTextWriterAttribute değilse veya öznitelik çalışma zamanı ve kodlama gerekli olana kadar bilinmiyorsa yönteminin aşırı yüklemesini AddAttribute(String, String, Boolean) kullanın.

Belirli bir işaretleme öğesinin örneği için sınıfı, HtmlTextWriter bu öğenin özniteliklerinin listesini tutar. RenderBeginTag yöntemi çağrıldığında, yöntemi tarafından AddAttribute eklenen tüm öznitelikler öğesinin açılış etiketine işlenir. Öznitelik listesi daha sonra nesneden HtmlTextWriter temizlenir.

Özniteliğin AddAttribute(String, String, Boolean) tırnak işareti ("), küçüktür işareti ()< veya ve işareti (&) içerme olasılığı varsa, olarak ayarlanmış trueyöntemini fEncode kullanın. Yöntem çağrısı, istekte bulunan cihazın gereksinimlerini karşılamak için özniteliğini kodlar. Bu karakterlerden hiçbirinin oluşturulmayacak olduğunu biliyorsanız veya özniteliğin zaten kodlanmış olduğunu biliyorsanız olarak ayarlayabilirsiniz fEncodefalse.

Öznitelik türü ise Style, değeri olsa fEndodetruebile kodlanamaz. Stil değerinin CSS uyumlu olduğundan ve kötü amaçlı kod içermediğinden emin olun.

biçimlendirme öğelerini işlemeye yönelik kodlama deseni aşağıdaki gibidir:

• AddAttribute öğesine öznitelik eklemek için yöntemini kullanın.

• RenderBeginTag yöntemini kullanın.

• Öğenin açma ve kapatma etiketleri arasında bulunan içeriği işlemek için gereken diğer yöntemleri kullanın.

• RenderEndTag yöntemini kullanın.

Ayrıca bkz.

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

AddAttribute(String, String, HtmlTextWriterAttribute)

Belirtilen işaretleme özniteliğini ve değerini, bir HtmlTextWriterAttribute numaralandırma değeriyle birlikte, nesnesinin yöntemine sonraki bir çağrıyla oluşturduğu öğenin HtmlTextWriter açılış etiketine RenderBeginTag ekler.

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)

Parametreler

name

String

Eklenecek özniteliğin adını içeren bir dize.

value

String

Özniteliğine atanacak değeri içeren bir dize.

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute özniteliğini temsil eden bir.

Açıklamalar

AddAttribute yönteminin aşırı yüklemesini AddAttribute(String, String, HtmlTextWriterAttribute) yalnızca sınıfından HtmlTextWriter devralırken kullanın. Öznitelikler için yeni name ve key çiftler oluşturmanıza olanak tanır.

Ayrıca bkz.

• TextWriter
• RenderBeginTag
• HtmlTextWriterAttribute

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

İşaretlemeyi özniteliğini ve öznitelik değerini, isteğe bağlı kodlama ile nesnesinin HtmlTextWriter yöntemine sonraki bir çağrıyla oluşturduğu öğenin açılış etiketine RenderBeginTag ekler.

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)

Parametreler

key

HtmlTextWriterAttribute

HtmlTextWriterAttribute Çıkış akışına eklenecek işaretleme özniteliğini temsil eden bir.

value

String

Özniteliğine atanacak değeri içeren bir dize.

fEncode

Boolean

true özniteliğini ve değerini kodlamak için; aksi takdirde , false.

Örnekler

Aşağıdaki kod örneği, bir öğenin özniteliğine atanan dize değerinin istekte bulunan cihaz için kodlandığından Alt emin olmak için <img> yönteminin nasıl kullanılacağını AddAttribute(HtmlTextWriterAttribute, String, Boolean) gösterir.

// 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()

Açıklamalar

İsteğe AddAttribute bağlı kodlama ile standart bir işaretleme özniteliğini işlemek için yönteminin AddAttribute(HtmlTextWriterAttribute, String, Boolean) aşırı yüklemesini kullanın.

Belirli bir işaretleme öğesinin örneği için sınıfı, HtmlTextWriter bu öğenin özniteliklerinin listesini tutar. RenderBeginTag yöntemi çağrıldığında, tarafından AddAttribute eklenen tüm öznitelikler öğesinin açılış etiketine işlenir. Öznitelik listesi daha sonra nesneden HtmlTextWriter temizlenir.

Özniteliğin AddAttribute(HtmlTextWriterAttribute, String, Boolean) tırnak işareti ("), küçüktür işareti ()< veya ve işareti (&) içerme olasılığı varsa, olarak ayarlanmış trueyöntemini fEncode kullanın. Yöntem çağrısı, istekte bulunan cihazın gereksinimlerini karşılamak için özniteliğini kodlar. Bu karakterlerden hiçbirinin oluşturulmayacak olduğunu biliyorsanız veya özniteliğin zaten kodlanmış olduğunu biliyorsanız olarak ayarlayabilirsiniz fEncodefalse.

Öznitelik türü ise Style, değeri olsa fEncodetruebile kodlanamaz. Stil değerinin CSS uyumlu olduğundan ve kötü amaçlı kod içermediğinden emin olun.

biçimlendirme öğelerini işlemeye yönelik kodlama deseni aşağıdaki gibidir:

• AddAttribute öğesine öznitelik eklemek için yöntemini kullanın.

• RenderBeginTag yöntemini kullanın.

• Öğenin açma ve kapatma etiketleri arasında bulunan içeriği işlemek için gereken diğer yöntemleri kullanın.

• RenderEndTag yöntemini kullanın.

Ayrıca bkz.

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