HtmlTextWriter.AddAttribute Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 -> unitPublic 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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String)Parametry
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 -> unitPublic 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ż
- TextWriter
- HttpRequest
- RenderBeginTag
- HtmlTextWriterAttribute
- HtmlAttributeEncode(String, TextWriter)
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 -> unitProtected 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.
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 -> unitPublic Overridable Sub AddAttribute (key As HtmlTextWriterAttribute, value As String, fEncode As Boolean)Parametry
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ż
- TextWriter
- HttpRequest
- RenderBeginTag
- HtmlTextWriterAttribute
- HtmlAttributeEncode(String, TextWriter)
Dotyczy
Opinia
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź: https://aka.ms/ContentUserFeedback.
Prześlij i wyświetl opinię dla