Udostępnij za pośrednictwem


HtmlTextWriter.AddAttribute Metoda

Definicja

Dodaje określony atrybut znaczników i wartość do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody.

Przeciążenia

AddAttribute(String, String)

Dodaje określony atrybut znaczników i wartość do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody.

AddAttribute(HtmlTextWriterAttribute, String)

Dodaje atrybut znaczników i wartość atrybutu do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody.

AddAttribute(String, String, Boolean)

Dodaje określony atrybut znaczników i wartość do tagu otwierającego elementu, który HtmlTextWriter obiekt tworzy przy użyciu kolejnego wywołania RenderBeginTag metody z opcjonalnym kodowaniem.

AddAttribute(String, String, HtmlTextWriterAttribute)

Dodaje określony atrybut znaczników i wartość wraz z wartością HtmlTextWriterAttribute wyliczenia do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody .

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Dodaje atrybut znaczników i wartość atrybutu do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody z opcjonalnym kodowaniem.

AddAttribute(String, String)

Dodaje określony atrybut znaczników i wartość do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody.

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)

Parametry

name
String

Ciąg zawierający nazwę atrybutu do dodania.

value
String

Ciąg zawierający wartość, która ma zostać przypisana do atrybutu.

Przykłady

W poniższym przykładzie kodu pokazano, jak wywołać metodę AddAttribute przed wywołaniem RenderBeginTag metody . Kod wywołuje dwa różne przeciążenia AddAttribute i dwa różne przeciążenia AddStyleAttribute , zanim wywoła metodę RenderBeginTag<span> w celu renderowania elementu do strumienia wyjściowego. Metoda AddAttribute(String, String) służy do definiowania atrybutu niestandardowego o nazwie CustomAttribute i wartości niestandardowej <span> o nazwie CustomAttributeValue dla elementu renderowany przez ten kod.

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

Uwagi

AddAttribute Użyj przeciążenia AddAttribute(String, String) metody, jeśli atrybut nie jest jedną z HtmlTextWriterAttribute wartości lub jeśli atrybut nie jest znany do czasu wykonywania.

W przypadku wystąpienia dowolnego elementu znaczników HtmlTextWriter klasa utrzymuje listę atrybutów dla tego elementu. Po wywołaniu RenderBeginTag metody wszystkie atrybuty dodane przez metodę AddAttribute są renderowane do tagu otwierającego elementu. Lista atrybutów jest następnie czyszczone z HtmlTextWriter obiektu.

Wzorzec kodowania elementów znaczników renderowania jest następujący:

  • AddAttribute Użyj metody , aby dodać wszystkie atrybuty do elementu .

  • Użyj metody RenderBeginTag.

  • Użyj innych metod w razie potrzeby, aby renderować zawartość znalezioną między tagami otwierania i zamykania elementu.

  • Użyj metody RenderEndTag.

Zobacz też

Dotyczy

AddAttribute(HtmlTextWriterAttribute, String)

Dodaje atrybut znaczników i wartość atrybutu do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody.

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)

Parametry

key
HtmlTextWriterAttribute

Element HtmlTextWriterAttribute reprezentujący atrybut znaczników, który ma zostać dodany do strumienia wyjściowego.

value
String

Ciąg zawierający wartość, która ma zostać przypisana do atrybutu.

Przykłady

Poniższy przykład kodu pokazuje, jak za pomocą AddAttribute przeciążenia AddAttribute(HtmlTextWriterAttribute, String) metody dodać Onclick atrybut do elementu znaczników, a następnie ustawić jego wartość na następujący kod ECMAScript:

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

Uwagi

AddAttribute Użyj przeciążenia AddAttribute(HtmlTextWriterAttribute, String) metody , aby renderować standardowy atrybut znaczników.

W przypadku wystąpienia dowolnego elementu znaczników HtmlTextWriter klasa utrzymuje listę atrybutów dla tego elementu. Po wywołaniu RenderBeginTag metody wszystkie atrybuty dodawane przez AddAttribute metodę są renderowane do tagu otwierającego elementu. Lista atrybutów zostanie następnie wyczyszczone z elementu HtmlTextWriter.

Wzorzec kodowania elementów znaczników renderowania jest następujący:

  • AddAttribute Użyj metody , aby dodać wszystkie atrybuty do elementu .

  • Użyj metody RenderBeginTag.

  • Użyj innych metod w razie potrzeby, aby renderować zawartość znalezioną między tagami otwierania i zamykania elementu.

  • Użyj metody RenderEndTag.

Zobacz też

Dotyczy

AddAttribute(String, String, Boolean)

Dodaje określony atrybut znaczników i wartość do tagu otwierającego elementu, który HtmlTextWriter obiekt tworzy przy użyciu kolejnego wywołania RenderBeginTag metody z opcjonalnym kodowaniem.

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)

Parametry

name
String

Ciąg zawierający nazwę atrybutu do dodania.

value
String

Ciąg zawierający wartość, która ma zostać przypisana do atrybutu.

fEndode
Boolean

true kodowanie atrybutu i jego wartości; w przeciwnym razie , false.

Przykłady

Poniższy przykład kodu pokazuje, jak użyć AddAttribute przeciążenia AddAttribute(String, String, Boolean) metody, aby upewnić się, że atrybut niestandardowy o nazwie myattributei jego wartości nie jest zakodowany dla <img> elementu.

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

Uwagi

AddAttribute Użyj przeciążenia AddAttribute(String, String, Boolean) metody, jeśli atrybut nie jest jedną z HtmlTextWriterAttribute wartości lub jeśli atrybut nie jest znany, dopóki czas wykonywania i kodowanie nie jest potrzebne.

W przypadku wystąpienia dowolnego elementu znaczników HtmlTextWriter klasa utrzymuje listę atrybutów dla tego elementu. Po wywołaniu RenderBeginTag metody wszystkie atrybuty dodane przez metodę AddAttribute są renderowane do tagu otwierającego elementu. Lista atrybutów jest następnie czyszczone z HtmlTextWriter obiektu.

AddAttribute(String, String, Boolean) Użyj metody z ustawioną wartością fEncodetrue, jeśli atrybut może zawierać cudzysłów ("), znak mniejszy niż (<) lub znak "ampersand" (&). Wywołanie metody spowoduje kodowanie atrybutu w celu spełnienia wymagań urządzenia żądającego. Można ustawić wartość fEncodefalse, jeśli wiesz, że żaden z tych znaków nie zostanie wygenerowany lub jeśli wiesz, że atrybut jest już zakodowany.

Jeśli typ atrybutu to Style, wartość nie zostanie zakodowana, nawet jeśli fEndode jest .true Upewnij się, że wartość stylu jest zgodna ze standardem CSS i nie zawiera złośliwego kodu.

Wzorzec kodowania elementów znaczników renderowania jest następujący:

  • AddAttribute Użyj metody , aby dodać wszystkie atrybuty do elementu .

  • Użyj metody RenderBeginTag.

  • Użyj innych metod w razie potrzeby, aby renderować zawartość znalezioną między tagami otwierania i zamykania elementu.

  • Użyj metody RenderEndTag.

Zobacz też

Dotyczy

AddAttribute(String, String, HtmlTextWriterAttribute)

Dodaje określony atrybut znaczników i wartość wraz z wartością HtmlTextWriterAttribute wyliczenia do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody .

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)

Parametry

name
String

Ciąg zawierający nazwę atrybutu do dodania.

value
String

Ciąg zawierający wartość, która ma zostać przypisana do atrybutu.

key
HtmlTextWriterAttribute

Element HtmlTextWriterAttribute reprezentujący atrybut .

Uwagi

Przeciążenie AddAttributeAddAttribute(String, String, HtmlTextWriterAttribute) metody należy używać tylko w przypadku dziedziczenia HtmlTextWriter z klasy . Umożliwia tworzenie nowych name i key par dla atrybutów.

Zobacz też

Dotyczy

AddAttribute(HtmlTextWriterAttribute, String, Boolean)

Dodaje atrybut znaczników i wartość atrybutu do tagu otwarcia elementu, który HtmlTextWriter obiekt tworzy z kolejnym wywołaniem RenderBeginTag metody z opcjonalnym kodowaniem.

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)

Parametry

key
HtmlTextWriterAttribute

Element HtmlTextWriterAttribute reprezentujący atrybut znaczników, który ma zostać dodany do strumienia wyjściowego.

value
String

Ciąg zawierający wartość, która ma zostać przypisana do atrybutu.

fEncode
Boolean

true kodowanie atrybutu i jego wartości; w przeciwnym razie , false.

Przykłady

W poniższym przykładzie kodu pokazano, jak używać AddAttribute(HtmlTextWriterAttribute, String, Boolean) metody w celu zapewnienia, że wartość ciągu przypisana do Alt atrybutu elementu <img> jest kodowana dla urządzenia żądającego.

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

Uwagi

AddAttribute Przeciążenie AddAttribute(HtmlTextWriterAttribute, String, Boolean) metody umożliwia renderowanie standardowego atrybutu znaczników z opcjonalnym kodowaniem.

W przypadku wystąpienia dowolnego elementu znaczników HtmlTextWriter klasa utrzymuje listę atrybutów dla tego elementu. Po wywołaniu RenderBeginTag metody wszystkie atrybuty dodane przez AddAttribute element są renderowane do tagu otwierającego elementu. Lista atrybutów jest następnie czyszczone z HtmlTextWriter obiektu.

AddAttribute(HtmlTextWriterAttribute, String, Boolean) Użyj metody z ustawioną wartością fEncodetrue, jeśli atrybut może zawierać cudzysłów ("), znak mniejszy niż (<) lub znak "ampersand" (&). Wywołanie metody spowoduje kodowanie atrybutu w celu spełnienia wymagań urządzenia żądającego. Można ustawić wartość fEncodefalse, jeśli wiesz, że żaden z tych znaków nie zostanie wygenerowany lub jeśli wiesz, że atrybut jest już zakodowany.

Jeśli typ atrybutu to Style, wartość nie zostanie zakodowana, nawet jeśli fEncode jest .true Upewnij się, że wartość stylu jest zgodna ze standardem CSS i nie zawiera złośliwego kodu.

Wzorzec kodowania elementów znaczników renderowania jest następujący:

  • AddAttribute Użyj metody , aby dodać wszystkie atrybuty do elementu .

  • Użyj metody RenderBeginTag.

  • Użyj innych metod w razie potrzeby, aby renderować zawartość znalezioną między tagami otwierania i zamykania elementu.

  • Użyj metody RenderEndTag.

Zobacz też

Dotyczy