HtmlTextWriter.AddAttribute Yöntem
Tanım
Ö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
| 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 -> unitPublic 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.
Ş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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)Parametreler
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.
Şunlara uygulanır
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 -> unitPublic 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)
Ş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 -> unitProtected 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.
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.
Şunlara uygulanır
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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)Parametreler
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)
Şunlara uygulanır
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin