HtmlTextWriter.AddAttribute Yöntem

Tanım

Ad Alanı:: System.Web.UI

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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

Name	Description
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ı kodlamayla, nesnenin 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)	biçimlendirme özniteliğini ve öznitelik değerini, isteğe bağlı kodlamayla, nesnenin 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 nasıl çağrılduğunu AddAttribute RenderBeginTag gösterir. Kod, bir öğeyi çıkış akışına AddAttribute işlemek AddStyleAttribute için yöntemini çağırmadan önce iki farklı aşırı yüklemesini ve iki farklı aşırı yüklemesini RenderBeginTag çağırır<span>. 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 AddAttribute(String, String) değilse veya öznitelik çalışma zamanına kadar bilinmiyorsa yönteminin aşırı yüklemesini HtmlTextWriterAttribute 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. Daha sonra öznitelik listesi 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.

Şunlara uygulanır

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 AddAttribute 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ı Onclick 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 ' HtmlTextWriterden 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.

Şunlara uygulanır

AddAttribute(String, String, Boolean)

Belirtilen işaretleme özniteliğini ve değerini, isteğe bağlı kodlamayla, nesnenin 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ğinde, adlı AddAttributeözel bir özniteliğin AddAttribute(String, String, Boolean) ve değerinin myattribute bir öğe için kodlanmadığından emin olmak için <img> yönteminin aşırı yüklemesinin nasıl kullanılacağı gösterilmektedir.

// 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 AddAttribute(String, String, Boolean) değilse veya çalışma zamanı ve kodlama gerekli olana kadar özniteliği bilinmiyorsa yönteminin aşırı yüklemesini HtmlTextWriterAttribute kullanın.

AddAttribute(String, String, Boolean) özniteliği tırnak işareti ("), küçüktür işareti (fEncode) veya ve işareti (&) içerebiliyorsa, yöntemi true olarak ayarlayın<. Yöntem çağrısı, istekte bulunan cihazın gereksinimlerini karşılamak için özniteliğini kodlar. Bu karakterlerden hiçbirinin oluşturulmayacağını biliyorsanız veya özniteliğin zaten kodlanmış olduğunu biliyorsanız olarak ayarlayabilirsiniz fEncodefalse.

Öznitelik türü iseStyle, değeri olsa fEndode bile kodlanmayacak.true 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.

Şunlara uygulanır

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

yönteminin AddAttribute 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.

Şunlara uygulanır

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

biçimlendirme özniteliğini ve öznitelik değerini, isteğe bağlı kodlamayla, nesnenin 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 AddAttribute(HtmlTextWriterAttribute, String, Boolean) dize değerinin istekte bulunan cihaz için kodlandığından emin olmak için Alt yönteminin nasıl kullanılacağını <img> 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. Daha sonra öznitelik listesi nesneden HtmlTextWriter temizlenir.

AddAttribute(HtmlTextWriterAttribute, String, Boolean) özniteliği tırnak işareti ("), küçüktür işareti (fEncode) veya ve işareti (&) içerebiliyorsa, yöntemi true olarak ayarlayın<. Yöntem çağrısı, istekte bulunan cihazın gereksinimlerini karşılamak için özniteliğini kodlar. Bu karakterlerden hiçbirinin oluşturulmayacağını biliyorsanız veya özniteliğin zaten kodlanmış olduğunu biliyorsanız olarak ayarlayabilirsiniz fEncodefalse.

Öznitelik türü iseStyle, değeri olsa fEncode bile kodlanmayacak.true 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.

Şunlara uygulanır

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?